# AppsFlyer Master API
::: Tip
플랫폼 데이터 통합을 통해 생성된 데이터는 클러스터의 데이터 소비량에 포함된다는 점을 유의하십시오.
:::
# 개요
API 이름 | 통합 유형 | 데이터 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
Master API | API | 집계 | ✅ | ✅ | ✅ | ✅ |
Master API (opens new window)는 커스텀 분석 차원 및 집계 지표를 지원하며, Pull API의 집계 지표 인터페이스에 비해 유연성이 높습니다.
# 통합 프로세스
- AppsFlyer의 백엔드에 로그인하고, V2.0 API 토큰과 App ID를 획득하세요.
- TE 백엔드에 로그인하여, 서드파티 통합으로 들어가 AppsFlyer Master API 플랜을 추가하고, 관련 설정을 완료하세요.
- TE 시스템이 데이터를 정상적으로 수신하고, 리포트 구축이 완료되었는지 확인하세요.
# API Token과 App ID 획득
# 1.1 API 토큰 획득
관리자 계정에 로그인하고, [API Access]를 AppsFlyer의 사이드바 메뉴에서 찾아, Pull API를 위한 V2.0 API 토큰을 획득하세요.
# 1.2 App ID 획득
AppsFlyer의 백엔드 [My Apps]에서, 앱의 App ID를 찾을 수 있습니다. Android는 com.으로 시작하며, 예를 들어 com.demoapp.ta입니다. iOS는 id로 시작하며, 예를 들어 id12345678입니다.
# 플랜 구성
AppsFlyer의 API 토큰과 App ID를 획득한 후, TE 시스템에 로그인하여, [서드파티] 모듈에서 새 플랜의 설정을 완료할 수 있습니다. 아래는 AppsFlyer 마스터 API의 설정 화면입니다. 이 장의 내용을 따라 플랜을 생성하세요：
# 2.1 인증 정보 설정
[설정] 버튼을 클릭하고, 팝업 내에 App ID와 API Token를 입력하세요.
# 동기화
[동기화] 모듈에서, TE 시스템이 AppsFlyer Master API 데이터를 정기적으로 수집하는 규칙을 설정할 수 있습니다. 특정 시간대에 매일 일정 기간의 데이터를 수집할 수 있습니다. 수집된 데이터도 데이터 양에 포함되므로, 긴 시간의 데이터를 정기적으로 수집하지 않는 것이 좋습니다.
# 2.3 수집 시간대
기본적으로, UTC+0이 설정되어 있더라도, 수집하는 데이터의 타임존을 설정할 수 있습니다.
# 2.4 저장 설정
데이터가 이벤트 형식으로 쓰여지는지를 제어할 수 있습니다. 닫으면, 데이터는 이벤트 테이블에 쓰여지지 않으므로, 이 설정을 닫지 마세요.
# 2.5 통합 구성
마지막으로, 데이터 수집의 자세한 설정을 통합 구성 모듈에서 제어할 수 있습니다. 데이터 유형, 수집할 차원, 및 저장 후의 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON 형식이며, 아래의 내용을 따라 커스텀 설정을 할 수 있습니다.
API | 이름 | 의미 |
|---|---|---|
| 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에는 다양한 타입의 지표가 포함되어 있으며, AppsFlyer 공식 웹사이트 (opens new window)의 문서를 참조하세요.
WARNING
일부 지표는 다른 차원의 필드를 지원합니다. 조정이 필요한 경우는, TE 매니저에게 연락하여 조작을 진행하세요.
조정이 필요한 경우는, source.metrics를 변경하세요.
# 2.6 데이터 저장 규칙
기본적으로, 수집된 데이터는 이벤트 형식으로 TE 프로젝트에 쓰여집니다.
- 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 | APP 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 | 수익 |