AppsFlyer Pull API

::: Tip

플랫폼 데이터 통합을 통해 생성된 데이터는 클러스터의 데이터 소비량에 포함된다는 점을 유의하십시오.

:::

개요

API 이름	통합 유형	데이터 세분화	어트리뷰션	비용	수익	노출	클릭	전환
Pull API	API	집계		✅	✅	✅	✅	✅

AppsFlyer Pull API (opens new window)는 다양한 유형의 집계 지표 데이터를 제공하며, 현재 TE에서는 Partners와 Geo의 데이터를 얻을 수 있습니다.

통합 프로세스

1. AppsFlyer의 백엔드에 로그인하고, V2.0 API Token과 App ID를 획득하세요.
2. TE 백엔드에 로그인하고, 서드파티 통합에 들어가 AppsFlyer Pull API 플랜을 추가하고 관련 설정을 완료하세요.
3. TE 시스템이 데이터를 정상적으로 수신하고 리포트 구축이 완료되었는지 확인하세요.

API Token과 App ID 획득

1.1 API 토큰 획득

관리자 계정에 로그인하고, AppsFlyer의 사이드바 메뉴에서 [API Access]를 찾아 Pull API용 V2.0 API Token을 획득하세요.

1.2 App ID 획득

AppsFlyer의 백엔드 'My Apps'에서, 앱의 App ID를 찾을 수 있습니다. Android는 com.으로 시작하며, 예를 들어 com.demoapp.ta입니다. iOS는 id로 시작하며, 예를 들어 id12345678입니다.

플랜 구성

AppsFlyer의 API Token과 App ID를 획득한 후, TE 시스템에 로그인하여 '서드파티' 모듈에서 새 플랜의 설정을 완료할 수 있습니다. 아래는 AppsFlyer Pull API의 설정 화면입니다. 이 장의 내용에 따라 플랜을 생성하세요:

2.1 인증 정보 설정

[설정] 버튼을 클릭하고, 팝업 내에 App ID와 API Token를 입력하세요.

동기화

[동기화] 모듈에서, TE 시스템이 AppsFlyer Pull API 데이터를 정기적으로 수집하는 규칙을 설정할 수 있습니다. 특정 시간대에 매일 일정 기간 데이터를 수집할 수 있습니다. 수집된 데이터도 데이터 양에 포함되므로, 긴 시간의 데이터를 정기적으로 수집하지 않는 것이 좋습니다.

저장 설정

데이터가 이벤트 형식으로 작성되는지를 제어할 수 있습니다. 닫히면, 데이터는 이벤트 테이블에 작성되지 않으므로, 이 설정을 닫지 마세요.

2.4 통합 구성

마지막으로, 데이터의 수집에 대한 자세한 설정을 통합 구성 모듈에서 제어할 수 있습니다. 데이터 타입, 수집할 차원, 그리고 저장 후 이벤트명 등이 포함됩니다.

통합 설정의 내용은 JSON 형식이며, 아래 내용에 따라 커스텀 설정을 할 수 있습니다.

API	이름	의미
sink_event	event_mapping	저장 후 이벤트는 커스텀이 가능
source	report_types	수집할 데이터 유형은 커스터마이징 가능하며, 기본값은 installs, ad_revenue
extra_params	double_columns	숫자 타입 필드 정의는 여기에 작성된 필드는 숫자 타입으로 데이터베이스에 저장됩니다. 저장 후 필드명을 입력하세요.
	media_source	기본값으로 설정할 필요는 없지만, Facebook의 데이터를 개별적으로 수집하는 경우에는 설정이 필요합니다. 그 경우에는 'facebook'을 입력하세요.

2.4.1 Partner 데이터

Partner (opens new window) 타입 데이터에 대해 설명합니다. 이 리포트는 LTV 데이터에 기반하고 있으며, 지정된 기간 내에 설치된 신규 유저의 후속 데이터를 수집하고 있습니다.

필드 정의	필드 이름	비고
데이터타임	#event_time
대리	agency_pmd_af_prt
미디어 소스	media_source_pid
캠페인명	campaign_c
ARPU	arpu	지표 필드, 숫자 타입으로 작성하세요. extra_params.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
Set ID	adset_id
설치 명	adset_name

2.4.2 Geo 데이터

이 섹션에서는 Geo (opens new window)타입 데이터에 대해 설명합니다. 이 리포트는 LTV 데이터에 기반하고 있으며, 지정된 기간 내에 설치된 신규 유저의 후속 데이터를 수집하고 있습니다. Facebook의 데이터 형식이 다른 미디어 채널과 다르므로, TE 시스템은 Facebook 데이터와 모든 플랫폼 데이터를 별도로 수집합니다. 아래는 Geo가 수집할 수 있는 필드입니다:

필드	속성 이름	백업
국가 지역	country
데이터타임	#event_time
대리	agency_pmd_af_prt
미디어 소스	media_source_pid
캠페인명	campaign_c
ARPU	arpu	지표 필드, 숫자 타입으로 작성하세요. extra_params.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
Set ID	adset_id
Set 명	adset_name

2.5 데이터 저장 규칙

기본적으로, 수집된 데이터는 이벤트 형식으로 TE 프로젝트에 작성됩니다.

• Pull API의 집계 지표 인터페이스는, 집계 데이터를 반환하기 때문에, 유저 식별자로 고정값을 사용합니다. 모든 데이터가 가상 유저에게 마운트된다고 생각하세요.
• 데이터 중 Date 필드, 즉 유저의 등록 시간을 이벤트의 #event_time으로 사용합니다.
• 데이터 이벤트명:
  • Partner
    • appsflyer_partner_data
  • Geo
    • appsflyer_geo_data
  • 다른 필드는 모두 데이터베이스에 저장됩니다.

2.6 표준화 필드

메타 필드	표준화 필드	설명
media_source	te_ads_object.media_source	미디어 채널
monetization_network(모네타이즈)	te_ads_object.media_source	모네타이즈 채널
campaign	te_ads_object.campaign_name	광고 캠페인 이름
af_c_id	te_ads_object.campaign_id	광고 캠페인 ID
af_adset	te_ads_object.ad_group_name	광고 그룹명
ad_unit(모네타이즈)	te_ads_object.ad_group_name	모네타이즈 광고의 Unit명
af_adset_id	te_ads_object.ad_group_id	광고 그룹 ID
af_ad	te_ads_object.ad_name	광고 명
af_ad_id	te_ads_object.ad_id	광고 ID
placement(모네타이즈)	te_ads_object.placement	광고 위치
af_cost_value	te_ads_object.cost	비용
af_cost_currency	te_ads_object.currency	비용 통화
event_revenue	te_ads_object.revenue	수익
event_revenue_currency(모네타이즈)	te_ads_object.currency	수익 통화
country_code	te_ads_object.country	국가 지역 코드
platform	te_ads_object.platform	플랫폼 Android, iOS 등
app_id	te_ads_object.app_id	APP ID
app_name	te_ads_object.app_name	APP 이름