앱에 연동된 앱스플라이어 SDK는 앱과 앱스플라이어 플랫폼 간의 링크입니다. 앱 인스톨, 앱 열기, 인앱이벤트 등을 리포트합니다.

앱스플라이어 SDK 연동 방법:

1. 앱스플라이어 SDK를 앱에 연동합니다.
   안드로이드 및 iOS SDK 연동에 대해서는 안내서를 참조하십시오.
2. 앱스플라이어 스키마를 사용하여 기록하려는 인앱이벤트를 매핑합니다.
   SDK 또는 S2S를 통해 수행할 수 있습니다.
3. 경쟁하는 어트리뷰션 공급업체의 SDK를 제거하십시오.
   이 작업을 즉시 수행하여 앱스플라이어로 전환하거나, 몇 주 동안 SDK를 동시에 실행할 수 있습니다. 아래 테이블에서 이러한 옵션의 분석을 참조하십시오.
   

   옵션	업데이트된 앱 버전 출시 이후 상황	영향
   타 업체 SDK 제거 (권장)	오직 앱스플라이어만 신규 앱 설치 및 앱 업데이트를 완료한 사용자를 기록합니다. 사용자가 앱을 업데이트 할 때까지 기존 버전의 이벤트를 타 업체가 여전히 표시합니다.	빠른 전환. 이중 어트리뷰션 없음.
   변환 기간 동안 타 업체 SDK 유지	앱스플라이어와 타 업체가 모두 신규 앱 설치를 어트리뷰션하고, 이벤트를 리포트합니다. 나중에 타 업체의 SDK를 제거합니다.	데이터 유효성 검증이 가능합니다. 즉, 앱스플라이어와 다른 공급업체의 데이터를 비교할 수 있습니다. 애드 네트워크에 이중 비용을 발생시킬 수 있는 이중 어트리뷰션. 다음의 예시 참고. 업무량 증가.

4. 작업 범위에 있는 다른 모든 태스크가 완료된 후 앱스플라이어 SDK를 사용하여 앱 버전을 시장에 업데이트합니다. 앱스플라이어에 의해 새 사용자가 어트리뷰트됩니다. 일러두기:
   • iOS, Google Play, 그리고 모든 관련 안드로이드 아웃스토어 마켓에 사용할 앱을 업데이트해야 합니다.
   • 안드로이드 앱이 비공식 APK 사이트에 존재할 수도 있습니다. 웹에서 앱의 패키지 이름을 검색하여 확인하십시오. APK 사이트는 최신 버전으로 업데이트 할 때까지 다소 시간이 걸리므로, 앱스플라이어 SDK 없는 구 버전을 인스톨하는 오가닉 사용자를 가져올 수 있습니다.
   • 앱스토어에서 앱 업데이트가 완전히 반영되기까지 며칠이 걸릴 수도 있습니다. 이 기간 동안에 앱을 설치한 사용자는 구 버전을 가질 수 있습니다.

디바이스 마이그레이션은 기존 사용자 디바이스 ID(IDFA, IDFV, GAID, CUID)의 목록을 앱스플라이어로 업로드하는 프로세스입니다. 이 프로세스는 앱스플라이어 SDK를 포함하는 새 앱 버전을 출시하기 전에 수행해야 합니다. 디바이스 마이그레이션에는 두 가지 옵션, 어트리뷰트 마이그레이션 또는 어트리뷰트되지 않은 마이그레이션이 있습니다.

디바이스 마이그레이션은 앱을 다운로드하고 이전 벤더에 의해 어트리뷰트된 기존 앱 사용자와 관련된 데이터 문제를 해결합니다. 예를 들어, 사용자가 원래 이전 벤더에서 SRN에 어트리뷰트되고 아직 기여 기간 내에 있는 경우 발생하는 SRN 이중 요금은 앱스플라이어에서 SRN에 의해 다시 청구되는 것입니다.

디바이스를 마이그레이션하면 데이터는 앱스플라이어에서 다음과 같이 반영됩니다.

• 인스톨 데이터: 재인스톨과 유사하게, 마이그레이션된 디바이스는 인스톨 데이터를 갖지 않습니다. 마이그레이션된 디바이스 인스톨은 앱스플라이어에 표시되지 않습니다.
• 인앱 이벤트 및 세션 데이터: 어트리뷰션되지 않은 마이그레이션 방법의 경우, 오가닉으로 기록되고 표시됩니다. 어트리뷰션된 마이그레이션 방법을 사용하면, 해당 미디어소스와 캠페인에 어트리뷰션 됩니다. 
• 리타겟팅: 리어트리뷰션과 리인게이지먼트는 정상적으로 표시됩니다.
• 활동 데이터: 정상적으로 표시됩니다.
• 리텐션 및 코호트 데이터: 마이그레이션된 디바이스에는 인스톨 기록이 없습니다. 이와 같이, 이들은 어떠한 코호트와도 관련되어 있지 않으며, 리텐션 및 코호트 리포트에는 표시될 수 없습니다. 

디바이스를 마이그레이션하는 방법: 

1. 마이그레이션할 사용자 그룹을 결정합니다. 모든 기존 사용자(앱스플라이어에서 정확한 리어트리뷰션 데이터를 가져올 수 없는 사용자) 또는 최근에 앱(다소 오랜 사용자의 경우 이중 요금으로 이어질 수 있는 앱)을 인스톨한 사용자를 마이그레이션할 수 있습니다.
   현재 리어트리뷰션 기간 동안 활성 상태인 사용자를 마이그레이션하는 것이 좋습니다. 예를 들어 앱에 90일 리어트리뷰션 기간이 있는 경우 이전 90일 동안 세션이 하나 이상 있는 사용자를 마이그레이션합니다.
2. [선택사항] 마케터/UA 관리자에게 디바이스 마이그레이션이 끝날 때까지 기존 마케팅 캠페인(SRN, 비-SRN 광고 네트워크, 온드 미디어 등)을 일시정지하도록 알리십시오.
   캠페인을 일시정지하지 않기로 결정한 경우, 앱스플라이어 SDK를 사용하여 업데이트된 앱 버전이 앱 스토어에 릴리스되는 즉시 다른 벤더의 나머지 디바이스 ID를 마이그레이션합니다. 
3. 어트리뷰트된 또는 어트리뷰트되지 않은 마이그레이션 구조를 사용하여 선택한 사용자 채우기를 기반으로 CSV 파일을 준비하십시오. 샘플 CSV 참조
4. 앱스플라이어 CSM을 CSV로 전송하십시오.
   사용자의 CSM은 디바이스 ID를 앱스플라이어로 마이그레이션합니다. 

이 방법을 사용하여 앱스플라이어로 마이그레이션된 디바이스에는 인앱 이벤트가 있으며, 이전 어트리뷰션 벤더에서 보고된 미디어소스에 따라, 그리고 광고 네트워크의 데이터 리텐션 정책에 따라 매체 소스에 따라 세션이 기록되고 표시됩니다.

CSV 파일 규칙:

• CSV 파일에는 여러 앱의 사용자 디바이스가 포함될 수 있습니다.
• 다중 행에서 디바이스 ID 및 앱 ID의 동일한 조합을 복제하지 마십시오. 중복이 발생하면 파일의 마지막 발생이 사용됩니다.
• 모든 컬럼 헤더 app_id, platform, device_id, id_type, install_time, media_source, integrated_partner, campaign, campaign_id가 포함되어야 합니다. 참고 : 필드의 순서는 중요하며 유지해야 합니다.
• 동일한 디바이스에 IDFV및 IDFA를 둘 다 추가할 수 있지만 별도의 행에 있어야 합니다. 별도의 행에 있는 모든 필드는 device_id를 제외하고 동일해야 합니다.
• 각 행은 쉼표로 구분된 정확히 9개의 필드를 포함해야 합니다.
• 필수가 아닌 필드는 비워두십시오(공백).
• 파일은 최대 2천만 개의 행을 포함할 수 있습니다.
• 파일이 여러 개 있는 경우 각 파일에 고유한 이름을 할당하십시오.
• UTF-8을 사용하여 데이터를 인코딩합니다.
• [선택사항] ZIP 또는 GZIP을 사용하여 파일을 압축하십시오.
  

샘플 CSV 참조

이 방법을 통해 앱스플라이어에 마이그레이션된 디바이스는 오가닉 사용자로 기록됩니다(그러나 표시되지는 않습니다). 이들의 인앱 이벤트와 세션도 또한 오가닉으로 기록되고 표시됩니다.

어트리뷰션되지 않은 디바이스 마이그레이션 CSV 파일 구조

열	사용하는 상황	예
앱 ID + IDFA/GAID/IDFV	모든 안드로이드 사용자가 GAID 식별자를 가진 경우. iOS 사용자만 있는 경우.
앱 ID + 디바이스 ID + 디바이스 ID 유형	안드로이드 사용자의 일부가 IMEI 또는 안드로이드 ID는 가지고 있으나, GAID는 갖지 않은 경우. (구글 플레이 외 앱 마켓(out-of store)이나 안드로이드 버전 4.4.2 이하) 안드로이드 ID는 16진법 형식이 필요합니다. 일러두기: ID 유형 열 advertiserId(amazon_aid도 지원함), idfa, idfv, android_id, imei에 대해 정확한 문자열을 사용하십시오. android_id 또는 imei를 사용하고 나중에 앱스플라이어가 더 나은 식별자를 수신하는 경우 새 어트리뷰션이 기록될 수 있습니다.

CSV 파일 규칙:

• CSV 파일에는 여러 앱의 사용자 디바이스가 포함될 수 있습니다.
• 각 행에는 앱당 단일 디바이스 ID가 포함됩니다.
• 파일에는 다음과 같은 모든 열 헤더가 포함되어야 합니다.
  • 옵션 1: 파일은 다음과 같은 모든 열 헤더를 포함해야 합니다. app_id, device_id 
  • 옵션 2: app_id, device_id, id_type 
• 소문자로 된 앱 ID
• 소문자로 된 안드로이드 ID
• 대문자로 된 IDFA/IDFV
• 최대 2,500만 행 허용

샘플 CSV 참조

SRN은 MMP(Mobile Measurement Partner)가 특정 디바이스의 인게이지먼트에 대해 쿼리하는 경우 응답합니다. 만약 두 개의 MMP(예를 들어 앱스플라이어와 다른 어트리뷰션 업체)가 동일한 디바이스의 인스톨에 대해 같은 SRN에 쿼리한 경우, 이중 비용을 발생시킬 수도 있습니다.

SRN 캠페인을 마이그레이션하는 방법:

• 앱스플라이어에서 관련 SRN을 활성화하고 설정하십시오.

광고 네트워크 어트리뷰션 링크는 사용자 광고 참여를 기록하며, 이후에 실제 앱 설치가 되는 광고 참여를 어트리뷰션하는 데 사용됩니다.

비-SRN 광고 네트워크 캠페인을 마이그레이션하는 방법:

1. 앱스플라이어에서 관련 광고 네트워크를 활성화하십시오.
2. 각 광고 네트워크에 대해 앱스플라이어 어트리뷰션 링크를 생성합니다.
3. 각 캠페인의 기존 링크를 앱스플라이어 어트리뷰션 링크로 전환합니다. 

온드 미디어는 사용자가 다음에서 사용하는 어트리뷰션 링크를 참조합니다.

• 콘텐츠 공유하기
• 웹 투 앱
• 이메일
• SMS
• 소셜 미디어 포스트
• 블로그
• 인터넷 커뮤니티(Quora 등)
• 그 외 다수 ...

이러한 캠페인의 경우 앱스플라이어는 원링크 커스텀 링크를 사용합니다. 원링크 커스텀 링크는 디바이스에 기반한 사용자를 올바른 앱스토어, 앱 또는 웹 URL/랜딩 페이지로 리디렉트합니다.

다른 벤더에 대한 링크를 앱스플라이어 원링크로 변경하는 방법:

• 모든 링크의 대량 마이그레이션을 지원하는 CSM에 문의하십시오. 

SKAdNetwork(SKAN) 어트리뷰션의 경우, 변환 값은 SDK 하나만 업데이트할 수 있습니다. 그렇지 않으면, SKAN 데이터는 무의미하게 됩니다. 따라서 마이그레이션 후에 앱스플라이어 SDK만이 SKAN 변환 값을 업데이트합니다.

앱스플라이어에서 SKAN 전환 값 설정에 대해 자세히 알아봅니다.

시스템은 마이그레이션하기 전에 사용자가 설정한 리포트 구조, 필드 및 파라미터에 따라 현재 벤더의 어트리뷰션 데이터를 저장합니다. 앱스플라이어가 데이터를 올바르게 리포트하려면 현재 리포트 구조를 앱스플라이어 리포트 구조, 필드 및 파라미터에 적용하고 매핑해야 합니다.

리포트 구조를 적용하고 매핑하는 방법:

• 앱스플라이어 CSM에 문의하여 Adjust, Branch/Tune, 또는 Kochava에서 앱스플라이어로 리포트 데이터 구조를 빠르게 적용/마이그레이션하는 데 도움을 받으십시오.

여러 가지 방법을 사용하여 앱스플라이어에서 원시 및 집약형 리포트 데이터를 가져올 수 있습니다. 방법을 숙지하고 관련된 사용자와 관련된 방법을 설정하십시오.

리포트 방법에는 다음이 포함됩니다.

• CSV 다운로드
• 푸시 API
• 풀 API
• Data Locker