We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

마케터

Adjust 마이그레이션 가이드

타 모바일 측정 파트너에서 Adjust로 마이그레이션 하는 과정은 매우 간단합니다. Adjust는 모든 단계에서 지원과 다양한 참고 리소스를 제공합니다.

본 가이드의 설명을 참조하여, 다음의 마이그레이션 단계를 완료하시기 바랍니다.

참고:

전담 지원이 포함된 요금제의 경우, SDK 연동, UA 설정, 데이터 내보내기/BI, Datascape/데이터 분석, iOS 캠페인 설정 등과 관련된 워크숍 세션이 별도로 제공됩니다.

기기 가져오기(device import)는 어떻게 이루어지나요?

Adjust SDK는 Adjust SDK 도입 이전의 사용자를 신규 사용자로 간주합니다. 이는 사용자가 앱을 최초로 실행하는 순간에 발생합니다. 즉, 기존 사용자는 신규 설치로 보고됩니다. 따라서 다른 애널리틱스나 리포트 툴을 사용하거나, App Store 또는 Google Play 수치를 비교하는 경우, 리포트된 총 설치 수가 일치하지 않는 것을 확인할 수 있습니다.

이러한 불일치를 방지하기 위해 Adjust가 해당 사용자를 신규 설치로 보고하지 않도록 사용자를 Adjust로 가져올 수 있습니다. Adjust는 이러한 설치를 신규 세션으로 보고하며, 전체 설치에 집계되지 않습니다. 사용자의 활동과 성과(예: 리텐션 및 완료된 이벤트)를 계속 확인할 수 있으며, 리인게이지인터 캠페인에서는 사용자를 새로운 트래픽 소스에 다시 어트리뷰션할 수 있습니다.

1. Adjust에서의 앱 설정

과거 데이터를 가져오기 전에 AppView에서 앱을 설정해야 합니다. 모든 과거 데이터는 Adjust 앱 토큰 에 대해 마이그레이션됩니다.

앱 설정 가이드를 참조하여 앱을 설정합니다.
앱 설정이 완료되면 앱 토큰 을 복사합니다.

2. Adjust SDK 연동 및 테스트하기

경고:

마이그레이션 작업이 완료되기 전에는 앱을 앱 스토어에 제출하지 마시기 바랍니다. 이는 기존 사용자가 Adjust에서 신규 사용자로 집계되는 것을 방지하기 위함입니다.

SDK 문서는 헬프 센터의 개발자 섹션을 참조하시기 바랍니다. Adjust SDK와의 연동을 위해 앱을 구성할 때, SDK는 sandbox 모드, 로깅 수준은 verbose로 설정하여 최대한 많은 정보를 얻으시기 바랍니다. SDK 연동과 관련하여 문의 사항이 있으시다면 Adjust 담당자 또는 support@adjust.com으로 연락주시기 바랍니다.

Adjust는 또한 테스트를 쉽게 진행할 수 있도록 테스팅 콘솔과 Device API를 제공합니다. 두 툴을 사용하여 SDK가 Adjust 서버로 전송하는 데이터를 분석하시기 바랍니다.

3. 과거 데이터 내보내기

AppView에서 앱 설정이 완료되면, 과거 데이터를 포함한 마이그레이션 파일을 생성해야 합니다. 이전의 모바일 측정 파트너(MMP) 및 자체 비즈니스 인텔리전스(BI) 시스템으로부터 데이터를 마이그레이션하고, 다음과 같은 파일 형식을 사용하시기 바랍니다.

파일 형식

파일은 반드시 CSV(콤마로 구분된 값) 형식으로 다음을 충족해야 합니다.

UTF-8 암호화
쉼표로 구분
큰 따옴표 (")를 사용하시기 바랍니다.

파일명

CSV 파일명은 반드시 다음의 정보를 소문자 로 포함해야 합니다.

1단계에서 저장한 앱 토큰.
대상 운영 체제 이름 (예: ios 또는 android).
파일에 포함된 기기 ID의 유형.

반드시 각각의 기기 ID 유형에 따른 파일을 제공해야 합니다.

<app_token>_<os_name>_<device_id_type>.csv

기기 ID 유형

다음은 사용 가능한 기기 ID 유형입니다.

iOS :

idfa
idfv

Google Play Store 를 대상으로 하는 Android 기기:

gps_adid
android_id

Amazon Appstore 를 대상으로 하는 Android 기기:

fire_adid
android_id

예시

아래의 예시는 다음의 속성을 가진 데이터에 사용되어야 하는 파일명을 보여줍니다.

Adjust 앱 토큰 이 abc123인 앱의 경우.
Android 기기.
gps_adid 기기 ID 유형으로 식별.

abc123_android_gps_adid.csv

필드

중요:

CSV에서 큰따옴표( ")는 반드시 이스케이프 처리해야 합니다. 이를 위해 ""High spenders""과 같이 큰 따옴표의 또 다른 세트로 큰 따옴표로 묶인 필드를 묶습니다.

CSV 파일은 다음의 영역을 다음의 순서대로 포함해야 합니다.

필드	필수/선택	예시 값	참고 사항
`device_id`	필수	`B1CDA5FE-BEBA-48ED-AD0F-27AE62BF82D8`	대시(-)는 선택 사항입니다. 허용되는 `device_id` 유형: `android_id` (case-insensitive) `external_device_id` (case-sensitive) `gps_adid` (Google Advertising ID, 대소문자 구분) `fire_adid` (case-insensitive) `idfa` (case-insensitive) `idfv` (case-insensitive)
`created_at`	선택	`1586391845`	정수(integer)의 초 단위로 명시된 Unix 설치 타임스탬프. 마이그레이션된 파일에 이 필드가 채워져 있지 않으면, 마이그레이션 타임스탬프에 따라 자동 입력됩니다.
`network`	필수	`Imported Devices`	마이그레이션된 데이터는 Adjust의 라이브 데이터와의 혼동을 피하기 위해 별도의 네트워크에 보관되어야 합니다. 이러한 정보를 구성하는 방법에 관한 자세한 내용은 네트워크 매핑 표 를 참조하시기 바랍니다.
`campaign`	선택	`ironsource`
`adgroup`	선택	`ironsource_ios_us`
`creative`	선택	Ad Group 1

1개 또는 1개 이상의 선택 영역에 대한 정보가 없다면 공란을 입력하시기 바랍니다. 각 행은 반드시 헤더 행과 동일한 수의 영역을 포함해야 합니다.

네트워크 매핑

아래 표와 같이 "Imported Devices"라는 플레이스홀더 네트워크에서 과거 데이터를 가져와야 합니다. 모든 복귀 사용자는 이 플레이스홀더에 포함되며, 데이터는 추가적인 영향 없이 유지됩니다. 이 하드코드된 플레이스홀더는 Adjust가 기존 사용자(Adjust SDK 도입 이전의 사용자로부터 유입된 트래픽)와 활성 캠페인에 어트리뷰션되어야 하는 신규 사용자를 구분할 수 있음을 의미합니다.

동일한 기본 설정 네트워크 파트너로 사용자를 가져오는 경우, 특정 성과 지표를 분석할 때 문제가 발생하여 캠페인 및 앱 성과 분석이 제대로 이루어지지 않을 수 있습니다.

기존 캠페인 데이터를 3개의 하위 수준으로 드릴다운하려면 아래의 전체 구조를 사용하시기 바랍니다.

이전 시스템값	Adjust 마이그레이션 CSV값	참고 사항
—	`network`	이 값을 `Imported Devices`에 하드코딩합니다.
네트워크 이름	`campaign`
캠페인 이름	`adgroup`
광고 그룹(Adgroup) 이름	`creative`

가져온 기기의 세분화(네트워크, 캠페인, 광고 그룹)는 필수 사항이 아니며, 해당 데이터를 유지하고자 하는 경우를 대비하여 설정해야 합니다.

예시

헤더 행과 값 형식의 예시는 다음과 같습니다.

device_id,created_at,network,campaign,adgroup,creative
<device_id>,<created_at>,Imported Devices,<network>,<campaign>,<adgroup>

이전 시스템에서의 값으로 <device_id>, <created_at>, <network>, <campaign>, <adgroup> 를 입력합니다. 예시:

device_id,created_at,network,campaign,adgroup,creative
B1CDA5FE-BEBA-48ED-AD0F-27AE62BF82D8,1586391845,Imported Devices,ironsource,ironsource_ios_us,Ad Group 1

4. Adjust로 데이터 불러오기

데이터 내보내기가 완료되고 파일이 위 기준에 부합하는 것이 확인되면, 파일을 안전한 곳에 업로드한 뒤 Adjust 담당자에게 전송합니다. Adjust의 테크니컬팀은 CSV 파일을 불러오기 하여 데이터가 올바른지 확인합니다. 불러오기가 완료되면 Adjust 담당자는 이를 안내합니다.

참고:

마이그레이션된 사용자는 Datascape의 리포트에 자동으로 나타나지 않으며, Adjust SDK를 포함한 업데이트 버전을 출시한 이후 해당 사용자가 앱에서 세션을 시작하는 경우에만 리포트에 표시됩니다.

5. 앱 출시

개발자가 SDK 연동 완료를 확인하고 Adjust 담당자가 데이터 불러오기 완료를 확인하면, 앱의 새 버전을 앱 스토어에 출시할 수 있습니다. 앱 통계 데이터를 확인하여 기존 사용자와 신규 설치가 적절하게 기록되는지 확인하시기 바랍니다.

6. 캠페인 설정

캠페인 설정 가이드를 참조하여 네트워크 파트너와 셀프 어트리뷰션 네트워크(SAN)와의 캠페인을 설정하시기 바랍니다. 캠페인 설정 관련 지원이 필요하신 경우, Adjust 담당자에게 파트너 목록을 전달하면

전담 지원이 포함된 요금제의 경우, Adjust 담당자가 다음에 관한 별도의 워크숍 세션을 제공할 것입니다.

기록할 수 있는 캠페인 유형
수신할 수 있는 정보의 수준
캠페인 링크 생성 방법
Adjust의 어트리뷰션 방법
iOS 14+ 캠페인 설정 방법

해당 세션이 완료되면 네트워크 파트너에게 연락하여 캠페인 구성을 시작할 수 있습니다.

7. 캠페인 링크 업데이트

참고:

네트워크는 Adjust SDK가 연동된 앱 버전이 앱 스토어에 출시되기 전까지는 절대 테스트를 시작하면 안 됩니다.

캠페인 구성이 완료되면 Adjust 캠페인 링크를 네트워크 파트너에 전송하여, 파트너가 새 링크를 테스트하고 네트워크 설정을 업데이트하도록 하시기 바랍니다.

8. 새로운 Adjust suite의 기능

이제 모든 단계가 완료되어, Adjust suite를 활용하실 수 있습니다. Adjust 헬프 센터에서 다음에 대한 가이드를 참조하시기 바랍니다.

추가적인 자문이나 지원이 필요하신 경우, 담당 어카운트 매니저나 support@adjust.com으로 연락주시기 바랍니다.