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

App_migration_summary.png

소개

다른 어트리뷰션 제공 업체에서 앱스플라이어로 마이그레이션 하십니까?

환영합니다! 옮은 일을 하시는데 결코 늦지 않았습니다! 

마이그레이션 기간 동안 이중 비용, 데이터 중복 및 데이터 손실을 방지하기 위해 마이그레이션은 세심하게 계획되어야 합니다.

앱스플라이어는 원래의 어트리뷰션 데이터를 포함하여 전체 사용자 디바이스 기반을 마이그레이션 할 수 있습니다.

이 문서에서는 앱스플라이어로 마이그레이션 할 때 계정 소유자가 고려해야할 점과 마이그레이션을 완벽하게 수행하는 방법을 설명합니다. 여기에서 다음 주제가 다루어집니다.

  • 타 업체의 SDK를 제거하는 시점
  • 기존 사용자 마이그레이션
  • 다른 플랫폼과의 데이터 연속성 유지

시작하기 전에

사용자 및 설정을 앱스플라이어로 마이그레이션 하기 전에, 다음 작업이 필요합니다.

  1. 아직 회사에 계정이 없다면, 앱스플라이어 계정을 생성합니다.
  2. 앱스플라이어 계정에 앱을 추가합니다.
  3. [선택적] 각각의 앱에 리어트리뷰션 윈도우를 설정합니다. (기본 값은 90일 입니다.)

App_migration_detailed_flow.png

작업 1: 앱 준비하기

새 사용자를 어트리뷰션 시작하기 위해 앱의 다음 버전 출시에 맞춰 앱스플라이어 SDK를 연동합니다.

참고 - 이 작업은 앱을 제출(작업 4)하기 전에 완료해야만 하므로, 작업 2 및 작업 3과 병렬적으로 진행할 수 있습니다.

새 버전에서 다른 어트리뷰션 업체의 SDK를 어떻게 해야 할까요?

다음과 같은 선택 옵션이 있습니다.

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

 참고

  • 안드로이드 앱을 구글 플레이 외 다른 곳(out-of-store)에서 홍보하십니까? 구글 플레이와 마찬가지로 이런 마켓에서도 앱 버전을 업데이트 하십시오.
  • 안드로이드 앱이 비공식 APK 사이트에 존재할 수도 있습니다. 웹에서 앱의 패키지 이름을 검색하여 확인하십시오. APK 사이트는 최신 버전으로 업데이트 할 때까지 다소 시간이 걸리므로, 앱스플라이어 SDK 없는 구 버전을 인스톨하는 오가닉 사용자를 가져올 수 있습니다.
  • 앱스토어에서 앱 업데이트가 완전히 반영되기까지 며칠 걸릴 수도 있습니다. 이 기간 동안에 앱을 설치한 사용자는 구 버전을 가질 수 있습니다.

작업 2: 기존 사용자 마이그레이션 하기

앱스플라이어 SDK를 포함한 앱 버전을 제출한 이후, 신규 사용자는 어트리뷰션 되고 앱스플라이어에 잘 기록됩니다.

앱의 기존 사용자의 경우, 다음을 고려하십시오.

  1. 새로운 오가닉 인스톨: 앱스플라이어 SDK를 가진 앱이 처음으로 실행되면, 기존 사용자의 경우, 원래의 소스에 상관없이 앱스플라이어 상 신규 오가닉 사용자로 어트리뷰션 됩니다.
  2. 이중 부과: 새 사용자가 앱을 처음 실행하면, 앱스플라이어는 앱에 설정된 애드 네트워크로 쿼리합니다. 페이스북이나 구글 애즈 같은 SRN(Self Reporting Network)의 경우, 만약 이런 사용자가 그들의 룩백 윈도우 이내에 있다면, 이 사용자들을 다시 어트리뷰션 주장할 수도 있습니다.

     

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

이러한 문제들을 해결하기 위해, 앱스플라이어는 디바이스 마이그레이션 절차를 제공합니다.

디바이스 마이그레이션은 무엇입니까?

디바이스 마이그레이션은 기존 사용자의 디바이스 ID를 앱스플라이어로 업로드 하는 절차입니다. 이는 앱스플라이어 SDK를 가진 새 앱 버전을 배포하기 이전에 이루어져야합니다.

마이그레이션된 기기가 앱스플라이어 SDK를 포함한 앱을 처음 실행하더라도, 이것은 앱스플라이어에 신규 오가닉 인스톨로 표시되지 않습니다. 게다가 앱스플라이어는 해당 기기에 대해 SRN에 쿼리하지 않기 때문에, SRN에 의해 신규 논오가닉 인스톨로 청구되지 않습니다. 이는 위에서 설명된 두 가지 마이그레이션 문제를 해결합니다.

마이그레이션된 기기는 어떻게 됩니까?

마이그레이션된 기기는 앱스플라이어에서 다음과 같이 반영됩니다.

  • 인스톨 데이터: 재설치(re-installs)와 유사하게, 마이그레이션된 기기는 인스톨 데이터를 갖지 않습니다. 이렇게 마이그레이션된 기기 인스톨은 앱스플라이어에 표시되지 않습니다.
  • 인앱 이벤트 및 세션 데이터: 어트리뷰션 되지 않은 마이그레이션 방법의 경우, 오가닉으로 기록되고 표시됩니다. 어트리뷰션된 마이그레이션 방법을 사용하면, 해당 미디어 소스와 캠페인에 어트리뷰션 됩니다. 
  • 리타겟팅: 리어트리뷰션과 리인게이지먼트는 정상적으로 표시됩니다.
  • 액티비티 데이터: 오가닉 데이터의 일부로 표시됩니다.
  • 리텐션 및 코호트 데이터: 마이그레이션된 기기는 인스톨 날짜를 갖고 있지 않으며, 이 날짜가 어떤 코호트에도 포함되지 않기 때문에, 리텐션과 코호트 리포트에서 표시될 수 없습니다. 

어떤 기기를 마이그레이션 해야합니까?

모든 사용자를 마이그레이션 해야할까요? 또는 최근에 앱을 설치한 사용자만 마이그레이션 해야할까요?

다음 사항을 고려하십시오.

앱을 오래 전에 설치한 사용자 중 대다수가 비활성 사용자인 경우가 있습니다. 만약 이들이 앱 광고에 참여하고 인스톨하여 다시 활성화된다면, 이것은 중요한 어트리뷰션 데이터입니다. 모든 사용자를 마이그레이션한다면, 이런 데이터를 얻을 수 없습니다.

반면에, 여전히 활성 상태인 베테랑 사용자가 앱에 있을 수 있습니다. 최근에 설치한 사용자만 마이그레이션 한다면, 마이그레이션 직전에 이런 사용자가 광고에 참여했을 때, 이런 기존 사용자를 "확보"했다고 비용이 부과될 수 있습니다.

마지막 리어트리뷰션 윈도우 기간 동안에 활성 상태인 사용자들을 마이그레이션 하는 것을 앱스플라이어는 권장합니다. 예를 들어, 앱이 90일 리어트리뷰션 윈도우를 갖고 있다면, 최근 90일 기간동안 최소 한번의 세션을 가진 사용자를 마이그레이션 하십시오.

디바이스 마이그레이션은 어떻게 이루어집니까?

디바이스 마이그레이션을 수행하기 위해서는, 앱스플라이어 고객 성공 매니저에게 사용자 디바이스 ID와 추가 정보를 포함한 CSV 파일을 보냅니다. 이 CSV 파일의 각 행은 앱 당 단일 디바이스 ID를 표시하며, 파일은 다양한 앱에 대한 사용자 기기를 포함할 수 있습니다. 

마이그레이션에는 아래 설명된 두 가지 방법이 있습니다 - 어트리뷰션된 마이그레이션과 어트리뷰션 되지 않은 마이그레이션.

어트리뷰션된 디바이스 마이그레이션 

이 방법으로 앱스플라이어에 마이그레이션된 기기는 지정된 어트리뷰션에 따라 기록됩니다. 이들의 인앱 이벤트와 세션 데이터도 또한 그에 따라 기록되고 표시됩니다.

CSV 파일 열 목록

열 이름 파일의
열 이름
설명 필수적 예시/설명
앱 ID app_id

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

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

플랫폼

platform

기기 플랫폼: iOS 또는 안드로이드.

 네 "ios" 또는 "android" (모두 소문자).

디바이스 ID

device_id

안드로이드의 경우 GAID, iOS의 경우 IDFA.

GAID는 반드시 소문자입니다.

IDFA는 반드시 대문자입니다.

 네
  • GAID:
    9c9a82fb-d5de-4cd1-90c3-527441c11828
  • IDFA:
    9876F1SS-2983-3855-27RR-2R626772VFNB
ID 유형. id_type

안드로이드 사용자는 advertiserId 를 사용하고, iOS 사용자는 idfa 를 사용하십시오.

현재, 구글 플레이와 앱스토어 외 다른 곳(out-of-store)에서 사용되는 식별자(OAID, IMEI 및 Android ID)는 어트리뷰션된 마이그레이션에서 지원되지 않습니다.
구글 플레이 외 다른 곳에서의 안드로이드 사용자의 경우, 어트리뷰션 되지 않은 마이그레이션을 사용하십시오.

 네
  • "advertiserId" 또는 "idfa".
  • 값은 대소문자를 구분합니다.
Install Time install_time
ISO 8601 UTC 형식의 원래 앱 인스톨 시간:
yyyy-mm-ddTHH:MM:SS.SSS
제공되지 않은 경우, 마이그레이션 시간이 대신 사용됩니다.
아니오.
  • 올바른 과거 날짜이어야 합니다.
  • 예시:
    2018-01-22T08:45:33.412
  • 기기의 인스톨 시간이 파일 생성 날짜에서 리어트리뷰션 윈도우를 뺀 시점보다 이전인 경우, 어트리뷰션된 마이그레이션이 되지 않으며 앱 첫 실행 시 신규 인스톨로 처리됩니다.
    예: 마이그레이션 파일이 5월 1일에 생성되었으며, 설정된 리어트리뷰션 윈도우가 30일 입니다. 인스톨 시간이 4월 1일보다 이전인 모든 기기는 어트리뷰션 되지 않습니다. 앱이 처음 실행되면, 이런 기기들은 신규 인스톨(대부분은 오가닉)로 처리됩니다.
미디어 소스 media_source
앱스플라이어 대시보드에 표시되는 앱스플라이어 파트너 ID.
 네
  • 앱스플라이어로부터 정확한 파트너 ID 목록을 확인하십시오.
    예: "Facebook Ads", "googleadwords_int".
  • 오가닉 인스톨의 경우 “organic” 을 사용합니다.
  • 값은 대소문자를 구분합니다.
연동된 파트너. integrated_partner
미디어 소스가 연동된 파트너인지 아닌지 표시합니다. (즉, organic 또는 custom media source).
 네  
  • "yes" 또는 "no"
  • 값은 대소문자를 구분합니다.
Campaign name campaign
더 세부적인 어트리뷰션 상세 내역을 위해, 원래의 캠페인 이름을 제공하십시오.  아니오. 스트링 
캠페인 ID campaign_id
  아니오. 스트링 (공백은 안됨)

CSV 파일 규칙:

  • 파일은 모든 열의 머릿글을 반드시 다음과 같이 포함해야합니다: app_id,platform,device_id,id_type,install_time,media_source,integrated_partner,
    campaign,campaign_id
  • 각 행은 반드시 정확하게 9개의 필드와 콤마(,)를 포함해야합니다. 필수가 아닌 필드는 비어있을 수 있습니다.
  • 파일은 최대 2천만 개의 행을 포함할 수 있습니다.
  • 여러 파일을 작성한다면, 각 파일에 대해 고유한 파일 이름을 사용하십시오.
  • ZIP 또는 GZIP을 사용하여 파일을 압축할 수 있습니다.
  • CSV 파일은 반드시 UTF-8로 인코딩되어야 합니다.

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

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

CSV 파일 열 목록

사용하는 상황
앱 ID + IDFA/GAID
  • 모든 안드로이드 사용자가 GAID 식별자를 가진 경우.
  • iOS 사용자만 있는 경우. 
device_migration_file_option_1.png
앱 ID + 디바이스 ID + 디바이스 ID 유형
  • 안드로이드 사용자의 일부가 IMEI 또는 안드로이드 ID는 가지고 있으나, GAID는 갖지 않은 경우. (구글 플레이 외 앱 마켓(out-of store) 이나 안드로이드 버전 4.4.2 이하)
  • 안드로이드 ID는 16진법 형식이 필요합니다.

ID type 열에 정확한 스트링을 사용하십시오: advertiserId, idfa, android_id, imei.

device_migration_file_option_2.png

CSV 파일 규칙:

  • 파일은 모든 열의 머릿글을 반드시 다음과 같이 포함해야합니다: 첫번째 옵션의 경우, app_id,device_id  
  • 두번째 옵션의 경우, app_id,device_id,id_type
  • 앱 ID는 소문자이어야 합니다.
  • 모든 안드로이드 식별자는 소문자이어야 합니다.
  • IDFA는 대문자입니다.
  • 파일은 최대 2천 5백만 개의 행을 포함할 수 있습니다.

작업 3: 데이터 연속성 유지하기

앱스플라이어 SDK를 포함한 앱 버전을 제출 할 때, 다양한 미디어 소스를 통해 운영 중인 활성 캠페인을 가지고 있을 수 있습니다. 이 때 중복 비용이 발생되거나 또는 어트리뷰션 데이터의 손실이 생길 수도 있습니다.

이 장에서는 마이그레이션 이슈를 피하면서 다양한 미디어 소스를 사용하는 모범 사례를 설명합니다.

어트리뷰션 링크 사용

어트리뷰션 링크는 사용자 광고 참여를 기록하며, 이후에 실제 앱 설치가 되는 광고 참여를 어트리뷰션 하는데 사용됩니다. 그러므로, 다른 어트리뷰션 업체의 링크를 통해 광고 참여가 기록된 사용자와 앱스플라이어로 전환한 이후 첫번째 앱 실행을 수행한 사용자는 오가닉 사용자로 어트리뷰션 됩니다.

모범 사례: 98%의 사용자는 광고 참여 후 첫 7일 이내에 앱을 설치합니다. 앱스플라이어는 디바이스 마이그레이션 파일을 만들기 최소 7일 이전에 어트리뷰션 링크를 사용하는 모든 캠페인을 중지하는 것을 추천합니다.

SRN(Self Reporting Network) 사용

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

모범 사례:

  1. 디바이스 마이그레이션 파일을 만들기 최소 1일 전에 SRN과의 캠페인을 중지합니다.
  2. 앱스플라이어에서 SRN을 설정합니다.
  3. 앱을 제출한 이후, SRN과의 캠페인을 재개합니다.

다른 플랫폼 사용

내부 BI 시스템 혹은 타사 애널리틱스 플랫폼과 같은 다른 플랫폼들은, 변경에도 불구하고 데이터 연속성을 유지하는 것을 목표로 합니다.

모범 사례:

  1. 앱을 제출하기 전에, 관련된 파트너 혹은 플랫폼으로 앱스플라이어가 데이터를 전송하도록 설정합니다. 예, 푸시 API 사용. 이를 통해 앱스플라이어 SDK를 포함한 앱 버전으로 업그레이드 하는 신규 사용자와 기존 사용자를 다룰 수 있습니다.
  2. 앱스플라이어 SDK를 포함한 버전으로 업그레이드 할 때까지 자사 BI 시스템에 기존 사용자를 계속해서 기록할 수 있도록, 구 어트리뷰션 업체의 관련 설정을 30일간 유지합니다.

작업 4: 앱스플라이어 SDK를 포함한 앱 버전 제출하기

앱스플라이어 사용하는 것을 즐기십시오! 

작업 5 (선택적): 리포트 데이터 가져오기

API, CSV 다운로드 및 데이터 락커와 같은 여러가지 방법들을 사용하여, 앱스플라이어로부터 자사 내부 시스템에 리포트 데이터를 가져올 수 있습니다.

자사 시스템이 기존 업체로부터 어트리뷰션 정보를 저장하고 있었다면, 앱스플라이어 리포트 구조와 필드에 맞춰 조정할 필요가 있습니다.

고객의 시간과 노력을 절약하기 위해, 앱스플라이어에서는 이미 이를 완료해두었습니다.

리포트 데이터를 Adjust, Branch/Tune 또는 Kochava에서 앱스플라이어로 조정하는 방법에 대한 정보는 앱스플라이어에 문의하십시오.

케이스 스터디

인도의 대표적인 디지털 엔터테인먼트 회사인 Hungama가 6,500만명 이상의 월간 사용자를 앱스플라이어로 원활하게 마이그레이션한 방법에 대해 여기에서 읽어보십시오

도움이 되었습니까?