타 업체에서 앱스플라이어로 마이그레이션 하기

요약: 다른 어트리뷰션 공급업체의 앱스플라이어로 마이그레이션을 계획합니다. 마이그레이션 기간 동안 이중 청구, 데이터 중복 및 데이터 유실을 방지하는 방법을 이해합니다.

마이그레이션 흐름

개요

다른 공급업체의 앱스플라이어로 마이그레이션하는 데는 다음과 같은 기본 태스크가 포함됩니다.

이런 태스트를 동시에 작업할 수 있습니다. 그렇지만 이때 권장되는 사항은 다음과 같습니다.

  • 앱스플라이어 SDK를 사용하여 업데이트된 앱을 릴리스하기 전에 모든 태스크를 완료합니다. 
  • 디바이스 ID 마이그레이션을 수행하기 전에 기존의 마케팅 캠페인을 일시정지합니다.

작업

다음 표는 각 과제에 필요한 작업의 범위를 설명합니다. 진행 상태를 기록할 뿐만 아니라 주문에서 일반 과제를 정확하게 구분하려면 이 스프레드시트를 다운로드하십시오.

작업 범위
작업 조치 필요 직무별 작업 예상 시간 설명
선행 조건
  1. 앱스플라이어 계정을 만듭니다.
  2. 앱스플라이어에 앱을 추가합니다.
  3. [선택사항] 활동적인 사용자 정의와 맞추기 위해 기본 90일 리어트리뷰션 기간을 변경하십시오.
마케터/앱스플라이어 대시보드 사용자

2시간

 
SDK 연동
  • 앱에 앱스플라이어 SDK를 연동합니다.
  • S2S 또는 SDK 인앱이벤트를 매핑합니다.
  • 앱 스토어에서 앱 버전을 갱신합니다.
앱 개발자

1~2주

  • 권장사항: 테스트를 위해 사전 프로덕션 앱에 앱스플라이어 SDK를 통합하십시오.
  • 다른 모든 과제가 완료된 후에 앱 스토어에서 프로덕션 앱을 업데이트해야 합니다.
디바이스 마이그레이션 [선택사항] 기존 사용자의 이중 어트리뷰션을 피하기 위해 디바이스 ID를 마이그레이션합니다. 데이터 엔지니어 1~2주
  • 마이그레이션 전에 기존 캠페인을 일시정지하고 앱 버전이 업데이트된 후에 재개하는 것을 고려하십시오. 
  • 완전한 적용 범위를 보장하기 위해 최종 마이그레이션 날짜에 디바이스 마이그레이션을 반복하십시오. 
캠페인 데이터 마이그레이션
  • 광고 네트워크를 앱스플라이어에 연동하기
  • 다음에 존재하는 기존 캠페인을 마이그레이션합니다. 
    • SRN (Self Reporting Network)
    • 비-SRN 광고 네트워크
    • 온드 미디어
마케터/UA 관리자 1~3주
데이터 리포트 설정
  • 현재 리포트 구조를 앱스플라이어 구조로 적용/매핑합니다.
  • 앱스플라이어 리포트를 받을 준비를 합니다.
데이터 엔지니어 2~4주  

SDK 연동

SDK 연동

앱에 연동된 앱스플라이어 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에 의해 다시 청구되는 것입니다.

 

  • 6월 15일에 신규 사용자가 페이스북에서 광고를 클릭하고 사용자의 앱을 설치했습니다.
  • 6월 24일에 사용자는 앱을 앱스플라이어 SDK 연동 버전으로 업데이트하고 실행했습니다. 앱스플라이어 측면에서 이 사용자는 실시간 어트리뷰션해야 하는 신규 사용자입니다.
  • 앱스플라이어는 사용자의 디바이스 ID로 페이스북에 쿼리합니다. 사용자가 여전히 페이스북의 28일 기여 기간 이내에 있기 때문에, 페이스북은 해당 사용자를 셀프 어트리뷰션합니다. 이로 인해, 동일한 사용자에 대해 앱 소유주는 이중 부과됩니다.

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

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

디바이스 마이그레이션 방법

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

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

어트리뷰트된 마이그레이션

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


이름
설명 필수 예시
app_id

앱스플라이어 대시보드에 표시되는 앱 ID

  • 안드로이드: com.great.app1 
  • iOS: id123456789

platform

디바이스 플랫폼: ios 또는 안드로이드

  • ios
  • android

device_id

  • 안드로이드: gaid 
  • iOS: IDFV(사용 가능한 경우 권장됨) 또는 IDFA
  • 다중 행에서 디바이스 ID 및 앱 ID의 동일한 조합을 복제하지 마십시오. 중복이 발생하면 파일의 마지막 발생이 사용됩니다.

 

  • gaid (소문자): 9c9a82fb-d5de-4cd1-90c3-527441c11828
  • IDFV (대문자): A7328D98-A973-402A-8B87-D22A8611F2AF
  • IDFA (대문자): 9876F1SS-2983-3855-27RR-2R626772VFNB
id_type
  • 안드로이드: advertiserId (또한 amazon_aid도 지원) 
  • iOS:idfa 또는 idfv
  • 현재, 다른 식별자들, OAID, IMEI, 그리고 안드로이드 ID는 지원되지 않습니다. 
    Google Play 외 다른 곳에서의 안드로이드 사용자의 경우, 어트리뷰션되지 않은 마이그레이션을 사용하십시오.
  • 광고주 ID
  • IDFA
  • IDFV
install_time

ISO 8601 UTC 형식의 원래 앱 인스톨 시간:
yyyy-mm-ddTHH:MM: SS.SSS

  • 모범 사례: 이 필드를 비워 두십시오. 이 경우, 마이그레이션 시간이 대신 사용됩니다.
  • 날짜를 채우는 경우, 리어트리뷰션 기간보다 이전이 아닌 유효한 이전 날짜가 되어야 합니다.
    • 어떤 경우에는 첫 번째 실행 시 마이그레이션된 디바이스가 새 인스톨로 처리됩니다.
      예 1: 인스톨 시간 이전 파일 생성 날짜에서 앱 리어트리뷰션 기간을 뺀 인스톨 시간을 가진 디바이스는 어트리뷰션을 사용하여 마이그레이션되지 않습니다. 첫 번째 실행 시 디바이스는 새 설치(가장 가능한 오가닉)로 처리됩니다.
      예제 2: 디바이스가 인스톨 시간에 마이그레이션되지만 첫 번째 실행은 마이그레이션 후 및 리어트리뷰션 기간 외에서만 실행됩니다. 이 경우 새 인스톨이 기록됩니다.
아니오

2018-01-22T08:45:33.412

media_source
  • 다음 중 하나입니다.
    • 앱스플라이어 대시보드에 표시되는 앱스플라이어 파트너 ID
    • 사용자정의 미디어소스(파트너 ID일 수 없음).
  • 앱스플라이어에서 요구하는 파트너 ID 목록을 얻는 방법:
  • 형식: 값은 대소문자를 구분합니다


논오가닉: facebook_int, googleadwords_int

오가닉: 오가닉

integrated_partner
  • 미디어소스가 연동 파트너인지 아닌지 표시합니다. 오가닉인지 또는 사용자정의 미디어소스인지를 의미합니다.
  • 형식: 값은 대소문자를 구분합니다
 
  • 아니요(media_source가 커스텀인 경우)
campaign

더 세부적인 어트리뷰션 상세 내역을 위해, 원래의 캠페인 이름을 제공하십시오.

형식: 문자열(string)

아니오  
campaign_id

 더 세부적인 어트리뷰션 상세 내역을 위해, 원래의 캠페인 ID를 제공하십시오.

형식: 공백 없는 문자열

아니오  
어트리뷰트된 디바이스 마이그레이션 CSV 구조

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 참조

어트리뷰션 되지 않은 마이그레이션

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

사용하는 상황
앱 ID + IDFA/GAID/IDFV
  • 모든 안드로이드 사용자가 GAID 식별자를 가진 경우.
  • iOS 사용자만 있는 경우. 
device_migration_file_option_1.png
앱 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를 사용하고 나중에 앱스플라이어가 더 나은 식별자를 수신하는 경우 새 어트리뷰션이 기록될 수 있습니다.
device_migration_file_option_2.png
어트리뷰션되지 않은 디바이스 마이그레이션 CSV 파일 구조

CSV 파일 규칙:

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

샘플 CSV 참조

캠페인 데이터 마이그레이션

기존 마케팅 캠페인을 앱스플라이어로 전환하여 앱스플라이어 어트리뷰션을 활성화하고 중복 비용 및 어트리뷰션 데이터 손실을 방지합니다.

일러두기: 한 번에 몇 개의 마케팅 캠페인만 마이그레이션하도록 선택할 수 있습니다. 이 경우, 미디어소스(예: 광고 네트워크 또는 에이전시), 지역 또는 캠페인에 의해 마이그레이션하려는 항목을 세그먼트화할 수 있습니다. 

SRN (Self Reporting Network)

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

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

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

 참고

  • SRN은 다중 MMP(페이스북 및 트위터 제외)를 실행할 수 있습니다.
  • Facebook은 인앱 이벤트 중복을 제거할 수 없습니다.

비-SRN 광고 네트워크

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

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

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

온드 미디어

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

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

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

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

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

SKAN

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

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

데이터 리포트 설정

리포트 구조 적용 및 매핑

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

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

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

리포트 준비 방법

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

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

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