AppsFlyer Pull API
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Pull API | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ | ✅ |
AppsFlyer Pull API 집계 지표 인터페이스는 다양한 유형의 집계 지표 데이터를 제공하며, 현재 AE 시스템은 Partners와 Geo 데이터의 수집을 지원합니다.
통합 절차
- AppsFlyer 백엔드에 로그인하여 V2.0 API Token과 App ID를 가져옵니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 AppsFlyer Pull API 통합 계획을 추가하고 관련 설정을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. API Token 및 App ID 가져오기
1.1 API Token 가져오기
Pull 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 Pull API의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고, 팝업 창에 API Token과 App ID를 입력합니다
2.2 동기화
동기화 모듈에서 AE 시스템이 AppsFlyer Pull API 데이터를 정기적으로 수집하는 정책을 설정할 수 있으며, 매일 특정 시각에 최근 며칠간의 데이터를 수집하도록 선택할 수 있습니다. 최대 과거 1000일까지 수집할 수 있으며, 1회에 최대 31일까지 수집할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 여기에는 데이터 유형, 수집할 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_mapping | 저장 후 이벤트 이름, 커스텀 가능 |
| source | report_types | 수집할 데이터 타입, 커스텀 가능하나 하나만 선택할 수 있습니다. partner 또는 geo를 선택할 수 있으며, 각각 미디어 채널별, 지역별 데이터를 수집합니다 |
transfer | double_columns | 수치 타입 필드 정의. 여기에 입력한 필드는 수치 타입으로 저장되며, 저장 후 필드명을 입력해야 함 |
| fields_whitelist | 필드 필터, 리스트 타입. 리스트가 비어 있지 않으면 AE 시스템은 리스트에 있는 필드만 저장하고, 리스트에 없는 필드는 버림 | |
| extra_params | media_source | 기본적으로 설정할 필요가 없으며, Facebook 데이터만 따로 수집해야 할 때만 설정합니다. 이 경우 facebook을 입력하십시오 |
2.4.1 Partner 데이터
이 절에서는 Partner 타입의 데이터를 소개합니다. 이 리포트는 LTV 데이터를 기반으로 하며, 지정한 기간 동안 설치한 신규 유저의 이후 데이터를 수집합니다.
| 필드 의미 | 필드 이름 | 비고 |
|---|---|---|
| 데이터 시간 | #event_time | |
| 대행사 | agency_pmd_af_prt | |
| 미디어 채널 | media_source_pid | |
| 캠페인 이름 | campaign_c | |
| ARPU | arpu | 지표 필드, 숫자 타입이므로 transfer.double_columns에 입력하십시오 |
| 평균 eCPI | average_ecpi | |
| 클릭 수 | clicks | |
| 전환율 | conversion_rate | |
| CTR | ctr | |
| Impressions | impressions | |
| Installs | installs | |
| Loyal Users | loyal_users | |
| Loyal Users/Installs | loyal_users_installs | |
| ROI | roi | |
| Sessions | sessions | |
| Total Cost | total_cost | |
| Total revenue | total_revenue |
Facebook의 데이터 형식은 다른 미디어 채널과 다르므로, Facebook 데이터만 수집하려면 extra_params에 "media_source":"facebook" 설정을 추가할 수 있습니다. 이 경우 다음 필드가 추가됩니다:
| 필드 의미 | 필드 이름 |
|---|---|
| 캠페인 이름 | campaign_name |
| 캠페인 ID | campaign_id |
| 광고 ID | adgroup_id |
| 광고 이름 | adgroup_name |
| 광고 그룹 ID | adset_id |
| 광고 그룹 이름 | adset_name |
2.4.2 Geo 데이터
이 절에서는 Geo 타입의 데이터를 소개합니다. 이 리포트는 LTV 데이터를 기반으로 하며, 지정한 기간 동안 설치한 신규 유저의 이후 데이터를 수집합니다.
Facebook의 데이터 형식은 다른 미디어 채널과 다르므로, AE 시스템은 Facebook 전용 데이터와 전체 플랫폼 데이터를 각각 수집합니다. 다음은 Geo에서 가져올 수 있는 필드입니다:
| 필드 | 저장명 | 비고 |
|---|---|---|
| 국가/지역 | country | |
| 데이터 시간 | #event_time | |
| 대행사 | agency_pmd_af_prt | |
| 미디어 채널 | media_source_pid | |
| 캠페인 이름 | campaign_c | |
| ARPU | arpu | 지표 필드, 숫자 타입이므로 transfer.double_columns에 입력하십시오 |
| 클릭 수 | clicks | |
| 전환율 | conversion_rate | |
| 설치 수 | installs | |
| 충성 유저 수 | loyal_users | |
| Sessions 수 | sessions | |
| 총수익 | total_revenue |
Facebook의 데이터 형식은 다른 미디어 채널과 다르므로, Facebook 데이터만 수집하려면 extra_params에 "media_source":"facebook" 설정을 추가할 수 있습니다. 이 경우 다음 필드가 추가됩니다:
| 필드 의미 | 필드 이름 |
|---|---|
| 캠페인 이름 | campaign_name |
| 캠페인 ID | campaign_id |
| 광고 ID | adgroup_id |
| 광고 이름 | adgroup_name |
| 광고 그룹 ID | adset_id |
| 광고 그룹 이름 | adset_name |
2.5 데이터 저장 규칙
기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:
-
Pull API 집계 지표 인터페이스는 집계 데이터를 반환하므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결된다고 보면 됩니다
-
데이터의 Date 필드, 즉 유저의 설치 날짜를 이벤트의 #event_time으로 사용합니다
-
데이터의 이벤트 이름은 다음과 같습니다:
- Partner
- appsflyer_partner_data
- Geo
- appsflyer_geo_data
- Partner
-
나머지 필드는 모두 저장됩니다
2.6 표준화 필드
다음 이벤트 속성은 표준화 처리됩니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| media_source_pid | te_ads_object.media_source | 미디어 채널 |
| campaign_c(전체 플랫폼) | te_ads_object.campaign_name | 캠페인 이름 |
| campaign_id（Facebook） | te_ads_object.campaign_id | (Facebook) 캠페인 ID |
| campaign_name（Facebook） | te_ads_object.campaign_name | (Facebook) 캠페인 이름 |
| adset_id（Facebook） | te_ads_object.ad_group_id | (Facebook) 광고 그룹 ID |
| adset_name（Facebook） | te_ads_object.ad_group_name | (Facebook) 광고 그룹 이름 |
| adgroup_id（Facebook） | te_ads_object.ad_id | (Facebook) 광고 ID |
| adgroup_name（Facebook） | te_ads_object.ad_name | (Facebook) 광고 이름 |
| country | te_ads_object.country | 국가/지역 코드 |
| platform | te_ads_object.platform | 플랫폼(Android, iOS 등) |
| app_id | te_ads_object.app_id | 앱 ID |
| app_name | te_ads_object.app_name | 앱 이름 |
| currency | te_ads_object.currency | 통화 |
| impressions | te_ads_object.impressions | 노출 수 |
| clicks | te_ads_object.clicks | 클릭 수 |
| installs | te_ads_object.installs | 전환 수(설치) |
| total_cost | te_ads_object.cost | 집행 비용 |