menu
Is this helpful?

# AppsFlyer Master API

::: Tip

주의. 플랫폼 데이터 통합을 통해 생성된 데이터는 클러스터의 데이터 소비량으로 계산됨을 유의하십시오.

:::

# 개요

API 이름

통합 유형

데이터 세분화

어트리뷰션

비용

수익

노출

클릭

전환

Master API

API

집계

✅

✅

✅

✅

Master API (opens new window)는 커스텀 분석 차원 및 집계 지표를 지원하며, Pull API의 집계 지표 인터페이스에 비해 유연성이 높습니다.

# 통합 프로세스

  1. AppsFlyer의 백엔드에 로그인하고, V2.0 API 토큰과 App ID를 획득하세요.
  2. TE 백엔드에 로그인하여, 서드파티 통합으로 들어가 AppsFlyer Master API 플랜을 추가하고, 관련 설정을 완료하세요.
  3. 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 수익

← AppsFlyer Cohort API →