AppsFlyer Master API
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Master API | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ |
Master API는 분석 차원과 집계 지표를 커스텀할 수 있어 Pull API 집계 지표 인터페이스보다 유연합니다.
통합 절차
- AppsFlyer 백엔드에 로그인하여 V2.0 API Token과 App ID를 가져옵니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 AppsFlyer Master API 통합 계획을 추가하고 관련 설정을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. API Token 및 App ID 가져오기
1.1 API Token 가져오기
1.1 API Token 가져오기
Master API에 사용할 V2.0 API Token을 가져옵니다
1.2 App ID 가져오기
AppsFlyer 백엔드의 My Apps에서 앱의 App ID를 찾을 수 있습니다. Android는 com.으로 시작하며(예: com.demoapp.ta), iOS는 id로 시작합니다(예: id12345678)
2. 계획 설정
AppsFlyer의 API Token과 App ID를 가져온 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 아래 그림은 AppsFlyer Master API의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고, 팝업 창에 API Token과 App ID를 입력합니다
2.2 동기화
동기화 모듈에서 AE 시스템이 AppsFlyer Master API 데이터를 정기적으로 수집하는 정책을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 1회에 최대 31일까지 수집할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 데이터 수집 시간대
데이터는 프로젝트 시간대 기준으로 수집되며, 통합 방안 설정에는 별도의 데이터 수집 시간대 설정이 없습니다. 동기화의 설명에 사용하는 시간대가 표시됩니다. 예: 시스템은 UTC+8 기준으로 매……
2.4 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
2.5 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 여기에는 데이터 유형, 수집할 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능 |
source | metrics | 데이터의 지표, 리스트 타입, 커스텀 가능 |
| group_by | 데이터의 그룹 차원, 리스트 타입, 커스텀 가능 |
- 그룹 차원
다음은 그룹 차원입니다. 조정이 필요하면 source.group_by를 수정할 수 있으며, 조정할 때는 필드명을 사용하십시오.
| 필드 의미 | 필드 이름 | 저장명 | 기본값 |
|---|---|---|---|
| App ID | app_id | app_id | ✓ |
| Media Source | pid | media_source | ✓ |
| Agency | af_prt | partner | ✓ |
| Campaign | c | campaign | ✓ |
| Adset | af_adset | adset | ✓ |
| Ad | af_ad | ad | ✓ |
| Channel | af_channel | channel | ✓ |
| Publisher ID | af_siteid | publisher_id_af_siteid | ✓ |
| Keywords | af_keywords | keywords | |
| Is Primary Attribution | is_primary | is_primary_attribution | |
| Campaign ID | af_c_id | campaign_id | |
| Adset ID | af_adset_id | adset_id | |
| Ad ID | af_ad_id | ad_id | |
| Install Time | install_time | install_time | ✓ |
| Touch Type | attributed_touch_type | touch_type | ✓ |
| GEO | geo | geo | ✓ |
- 지표 필드
Master API에는 다양한 유형의 지표가 포함되어 있습니다. 다음은 Master API에서 자주 사용하는 일부 필드이며, 전체 필드는 AppsFlyer 공식 문서를 참고하십시오:
일부 지표는 지원하는 차원 필드가 다르므로, 조정이 필요하면 ThinkingAI 담당자에게 문의하여 진행하는 것을 권장합니다
조정이 필요하면 source.metrics를 수정할 수 있습니다
| 저장명 | 설명 | 기본값 |
|---|---|---|
| impressions | 노출 수 | ✓ |
| clicks | 클릭 수 | ✓ |
| installs | 설치 수 | ✓ |
| cr | 전환율 | ✓ |
| sessions | Session 수 | ✓ |
| loyal_users | 충성 유저 설치 수 | ✓ |
| loyal_users_rate | 충성 유저 비율 | ✓ |
| cost | 총비용 | ✓ |
| revenue | 총수익 | ✓ |
| roi | ROI | ✓ |
| arpu_ltv | 평균 LTV | ✓ |
| average_ecpi | 평균 eCPI | ✓ |
| uninstalls | 삭제 수 | ✓ |
| uninstalls_rate | 삭제율 | ✓ |
retention_day_[x] | N일 차 잔존 유저 수(N = 0,1,2,3,4,5,6,7,15,30) | |
| retention_rate_day_[x] | N일 차 잔존율(N = 0,1,2,3,4,5,6,7,15,30) | |
cohort_day_[x]_total_revenue_per_user | N일 차 누적 수익(N = 1,2,3,4,5,6,7,15,30,40,50,60,70,80,90) | |
cohort_day_[x]_revenue_per_user | N일 차 당일 수익(N = 1,2,3,4,5,6,7,15,30,40,50,60,70,80,90) | |
| cohort_[x]_days_total_revenue_per_user | N일 차 누적 수익과 동일(N = 1,2,3,4,5,6,7,15,30,40,50,60,70,80,90) |
2.6 데이터 저장 규칙
기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:
- Master API 집계 지표 인터페이스는 집계 데이터를 반환하므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결된다고 보면 됩니다
- 데이터의 install_time 필드, 즉 유저의 설치 시간을 이벤트의 #event_time으로 사용합니다
- 데이터 이벤트 이름은 appsflyer_master_data입니다
- 나머지 필드는 모두 저장됩니다
2.7 표준화 필드
다음 이벤트 속성은 표준화 처리됩니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| media_source | te_ads_object.media_source | 미디어 채널 |
| campaign | te_ads_object.campaign_name | 캠페인 이름 |
| campaign_id | te_ads_object.campaign_id | 캠페인 ID |
| adset | te_ads_object.ad_group_name | 광고 그룹 이름 |
| adset_id | te_ads_object.ad_group_id | 광고 그룹 ID |
| ad | te_ads_object.ad_name | 광고 이름 |
| ad_id | te_ads_object.ad_id | 광고 ID |
| app_id | te_ads_object.app_id | 앱 ID |
| geo | te_ads_object.country | 국가/지역 코드 |
| impressions | te_ads_object.impressions | 노출 수 |
| clicks | te_ads_object.clicks | 클릭 수 |
| installs | te_ads_object.installs | 전환 수(설치) |
| cost | te_ads_object.cost | 집행 비용 |
| revenue | te_ads_object.revenue | 수익화 수익 |