열 헤더

앱 이벤트 데이터는 아래 헤더 행과 같이 CSV 파일형식으로 내보내야 합니다. 예시와 같이 정확한 열 헤더를 사용하는 것이 중요합니다. 코호트 Day는 각 매트릭스 열 헤더에 " Dn " 접미사로 지정됩니다. 여기서 n은 코호트 Day 입니다. 아래 예시 에서는 D0 및 D1만 포함되지만 보내실 파일에서는 요금제에서 선택하신 모든 코호트 날짜들이 포함되어야 합니다.

Date,Country,Installs,Sessions D0,Sessions D1,Retained Users D1,Revenue Amount D0,Revenue Amount D1,Revenue Events D0,Revenue Events D1,Unique Payers D0,Unique Payers D1

여러 앱에 대한 데이터가 포함된 파일의 경우 각 행이 Store ID 열에서 앱의 Store ID를 지정하는 대신 다음과 같이 헤더 행을 사용해야 합니다.

Date,Store ID,Country,Installs,Sessions D0,Sessions D1,Retained Users D1,Revenue Amount D0,Revenue Amount D1,Revenue Events D0,Revenue Events D1,Unique Payers D0,Unique Payers D1

Metrics 열

아래 표와 같이 요금제에서 선택한 지표를 기반으로 사용해야 하는 열 헤더를 지정합니다. 코호트 지표를 나타내는 각 열 헤더에는 가격 책정 계획에서 선택한 각 코호트 날짜에 대해서 접미사 " Dn "이 포함되어야 합니다. 코호트로 분류 할 수 없는 지표를 나타내는 열 헤더에는 " Dn "이 없어야 합니다.

코호트 지표에 필요한 집계 유형을 지정합니다. 누적 집계는 지정된 코호트 날짜까지 모든 코호트 날짜의 합계를 나타냅니다. 증분 집계와 유사하지만 합계는 이전 코호트 날짜 이후 1일부터 시작해야 합니다. 예를 들어, Revenue Amount D1 및 Revenue Amount D7이라는 두 개의 Revenue Amount 열이 포함된 경우 Revenue Amount D1은 0일부터 1일까지 보고된 수익을 나타내고 Revenue Amount D7은 2일부터 7일까지 보고된 수익을 나타내야 합니다. 당일 집계는 주어진 코호트 날짜만을 나타냅니다. 예를 들어 Sessions D7은 7일에만 계산된 세션 수를 나타내야 합니다.

집계는 주어진 코호트 날짜 만을 나타냅니다. 예를 들어 Sessions D7은 7일에만 계산된 세션 수를 나타내야 합니다.

지표	열 헤더	코호트 여부	집계
Installs	Installs	절대 아니오	불가능
Sessions	Sessions	항상 예	당일
Retained Users	Retained Users	항상 예	당일
Revenue Amount	Revenue Amount	항상 예	증분
Ad Revenue Amount	Ad Revenue Amount	항상 예	증분
Purchases Revenue	IAP Revenue Events	항상 예	증분
Purchases	Revenue Events	항상 예	당일
Unique Payers	Unique Payers	항상 예	당일

데이터 파트너 통합을 사용하여 마케팅 데이터를 공유하고 사용자 지정 내보내기를 통해서만 앱 이벤트 데이터를 공유하는 경우, 사용해야 하는 열 헤더는 이 문서에 설명된 것과 다릅니다. 필요한 열 헤더를 받으려면 고객 성공 관리자에게 문의하십시오.

누적 Metrics

상기 표에 명시된 필수 집계 유형 대신 누적 집계가 있는 하나 이상의 지표를 가져오려면 파일 이름의 아무 곳에나 __cumul-{column}__ 텍스트를 한 번만 기입하면 지표를 나타낼 수 있습니다. 각 누적 지표에 대한 {column} 은 지표의 열 헤더입니다.

예를 들어 누적 집계를 사용하여 Revenue Amount와 Purchases 지표를 모두 가져오려는 경우 파일 이름을 다음과 같이 지정할 수 있습니다.
events_123456789__cumul-Revenue Amount____cumul-Revenue Events__.csv

라스트 터치 열

대시보드에서 증분 데이터를 나란히 쉽게 비교할 수 있도록 하려면 예시와 같이 라스트 터치 디멘션을 포함해야 합니다.

Date,Channel,Campaign,Country,Source App,Installs,Sessions D0,Sessions D1,Retained Users D1,Revenue Amount D0,Revenue Amount D1,Revenue Events D0,Revenue Events D1,Unique Payers D0,Unique Payers D1

파일에 여러 앱을 포함하고 싶을 경우 다음 예시와 같이 헤더 행을 사용해야 합니다. 여기서 각 행은 Store ID 열에 앱 스토어 ID를 지정합니다.

Date,Store ID,Channel,Campaign,Country,Source App,Installs,Sessions D0,Sessions D1,Retained Users D1,Revenue Amount D0,Revenue Amount D1,Revenue Events D0,Revenue Events D1,Unique Payers D0,Unique Payers D1

라스트 터치 디멘션 열(Channel, Campaign, and Source App)은 요금제에서 선택한 세분성을 기반으로 제한됩니다. Source App은 일반적으로 SDK의 게시자 앱 또는 하위 게시자 또는 대부분의 검색 플랫폼에서 동영상 광고 네트워크 및 키워드 ID를 참조하지만 원하는 모든 하위 캠페인 수준을 포함할 수 있습니다. 라스트 터치 지표를 포함하도록 선택하는 경우 다음 표에 따라 요금제에 포함되지 않은 CSV의 열을 생략하면 됩니다.

세분성	하위 열
Channel	Country*, Channel*
Campaign	Country*, Channel*, Campaign
Site	Country*, Channel*, Campaign, Source App

별표(*)는 값이 없는 경우에도 파일에 있어야 하는 필수 열을 나타냅니다.

라스트 터치 지표를 포함할 때 국가 수준 앱 이벤트 합계가 모델에서 사용되는 유일한 데이터 포인트인 이유로 정확해야 합니다. 다시 말해서 오가닉 리프트 수요로 인한 앱 이벤트는 내보내기에 포함되어야 합니다. 그렇지 않을 경우 국가별 합계에서 누락되므로 앱 이벤트는 (모두 대소문자 구분하여) Organic 이라고 하는 Channel 및 Campaign 하위에 표시되어야 합니다 .

업데이트 날짜: 01/03/2023