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 캠페인 설정 등과 관련된 워크숍 세션이 별도로 제공됩니다.

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

네트워크 매핑

Adjust는 앱이 최초로 실행된 순간에 바로 설치를 트래킹합니다. Adjust SDK 연동 이후에 기존 사용자가 앱을 실행하면, 이는 설치로 집계되고 설치일이 기록됩니다. 따라서 마이그레이션 파일에서 네트워크의 실제 이름을 사용하는 경우, 설치 이벤트가 기존 사용자로부터 발생한 경우일지라도 해당 네트워크의 신규 설치가 급증하게 될 것입니다.

이를 방지하려면 "Imported devices"라는 플레이스홀더 네트워크에서 과거 데이터를 가져와야 합니다. 이는 과거 데이터를 라이브 Adjust 데이터와 분리하여, 각 네트워크의 실제 성과를 정확하게 확인할 수 있도록 해줍니다. 상세도를 유지하려면 각 네트워크 영역을 다음과 같이 매핑해야 합니다.

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

이러한 구조를 사용하면 기존 캠페인 데이터를 3개의 하위 수준으로 드릴다운할 수 있습니다.

예시

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

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으로 연락주시기 바랍니다.