전송원 - AppsFlyer

개요

앱스플라이어에서 전송하는 설정 도움말 페이지입니다.

설정 항목

STEP1 기본 설정

품목명	필수	기본값	내용
앱스플라이어 연결 정보	예	----------------------------------------------------------------------------------------------.	미리 등록되어 있는 접속 정보 중 이번 전송 설정에 필요한 권한을 가진 접속 정보를 선택합니다. 연결 정보 설정 방법은 앱스플라이어의 연결 정보를 참고하시기 바랍니다.
앱 ID	예	----------------------------------------------------------------------------------------------.	앱 ID를 입력합니다.
보고서 종류	예	----------------------------------------------------------------------------------------------.	보고서 종류를 선택합니다.
데이터 수집 기간	예	----------------------------------------------------------------------------------------------.	전송하고자 하는 데이터의 시작 날짜와 종료 날짜를 입력합니다. YYYY-MM-DD 또는 YYYY-MM-DD HH:mm:ss 형식으로 입력하세요. 데이터 수집 기간에 대한 자세한 내용은 아래를 참고하시기 바랍니다.
시간대	예	Etc/UTC	데이터 수집 기간의 시간대를 설정합니다.

데이터 수집 기간에 대해

* 시작일시
* 시간(HH:mm:ss)을 지정하지 않으면 당일00:00:00:00 으로 지정됩니다.
* 시작 일시에 지정한 시간은 데이터 수집 기간에 포함됩니다.
* 종료일시
* 시간(HH:mm:ss)을 지정하지 않으면 다음 날00:00:00:00 으로 지정됩니다.
* 종료 일시를 지정한 시간은 데이터 수집 기간에 포함되지 않습니다.
예시. 종료일자를 2022-12-31로 지정하면 2023-01-01 00:00:00:00이 대신 지정됩니다.
이때 2022-12-31 23:59:59까지 데이터가 수집된다.

보고서 종류

다음과 같은 로우 데이터 리포트를 얻을 수 있습니다.
| TROCCO의 보고서 종 별칭 | AppsFlyer API의 보고서 이름 | TROCCO의 보고서 종 별칭
| --- | --- --- |
| 설치 | Installs | 설치
| 인앱 이벤트 | In-app events | In-app events
| Uninstall | Uninstalls | Uninstalls
| 재설치 | Reinstalls | 재설치
| Organic Installs | Organic Installs | Organic Installs | Organic Installs
| Organic in-app events | Organic in-app events | Organic in-app events | Organic in-app events
| Organic uninstall | Organic uninstalls | Organic uninstalls | Organic uninstalls
| Organic reinstalls | Organic reinstalls | Organic reinstalls

제약조건

앱스플라이어의 API를 이용하는 데에는 다음과 같은 제약이 있습니다.

획득 가능한 레코드 수

* 1회 전송당 최대 100만 라인의 레코드를 가져올 수 있습니다.
* 레코드 수가 100만 개가 넘는 보고서를 전송하려고 하면 전송 오류가 발생합니다.

보고서 취득 횟수 제한

앱스플라이어에서는 하루에 받을 수 있는 리포트 횟수에 제한이 있습니다.
횟수 제한은 고객의 계약 플랜에 따라 다릅니다.
자세한 내용은 보고서 횟수 제한을 참고하세요.

획득 가능한 데이터 기간

앱스플라이어에서 얻을 수 있는 보고서의 기간에는 제한이 있습니다.
* 인앱 이벤트 및 오가닉 인앱 이벤트 : 지난 90일 중 31일
* 상기 이외의 보고서 : 지난 90일 중 60일

자세한 내용은 Data availability windows를 참조하세요.

기록 건수가 100만 건을 초과하는 경우

두 가지 대응이 있습니다.

데이터 수집 기간 범위 좁히기

데이터 수집 기간의 시작일시 및 종료일시는 시간 단위로 범위를 지정할 수 있습니다.
단, 앞서 언급한 바와 같이 1일 보고서 조회 횟수(전송 횟수) 제한이 있다는 점에 유의해야 한다.
자세한 내용은 날짜 및 시간에 따른 기간 범위를 참조하세요.

클라우드 스토리지를 통해

앱스플라이어에는 Data Locker라는 기능이 있습니다.
Data Locker에서는 보고서 데이터를 다음 클라우드 스토리지로 전송할 수 있습니다.
* 구글 클라우드 스토리지
* AWS
* Snowflake

위에 보고서 데이터를 전송한 후, 이를 전송처로 하여 보고서 데이터를 전송할 수 있습니다.
Data Locker에 대한 자세한 내용은 Data Locker-광고주용을 참고하세요.

수집되는 필드

각 필드에 대한 자세한 내용은 로데이터 항목의 가이 드를 참조하세요.

전송 시 필드 이름	API 측 필드명
attributed_touch_type	어트리뷰티드 터치 타입
attributed_touch_time	터치 시간
install_time	설치 시간
event_time	이벤트 시간
event_name	행사명
e value	E value
event_revenue	이벤트 수익
event_revenue_currency	이벤트 수익 통화
event_revenue_usd	이벤트 수익 USD
event_source	이벤트 출처
is_receipt_ validated	영수증 val확인 가능
파트너	파트너
media_source	미디어 소스
채널	채널
키워드	키워드
캠페인	캠페인
campaign_id	캠페인 ID
adset	Adset
adset_id	Adset ID
광고	광고
ad_id	Ad ID
ad_type	광고 유형
site_id	사이트 ID
sub_site_id	서브 사이트 ID
sub_param_1	Sub param 1
sub_param_2	Sub param 2
sub_param_3	Sub param 3
sub_param_4	Sub param 4
sub_param_5	Sub param 5
cost_model	비용 모델
cost_ value	비용 value
cost_currency	비용 통화
contributor_1_partner	Contributor 1 파트너
contributor_1_media_source	Contributor 1 미디어 소스
contributor_1_campaign	Contributor 1 캠페인
contributor_1_touch_type	기여자 1 터치 타입
contributor_1_touch_time	기여자 1 터치 타임
contributor_2_partner	Contributor 2 파트너
contributor_2_media_source	Contributor 2 미디어 소스
contributor_2_campaign	Contributor 2 캠페인
contributor_2_touch_type	Contributor 2 터치 타입
contributor_2_touch_time	Contributor 2 터치 타임
contributor_3_partner	Contributor 3 파트너
contributor_3_media_source	Contributor 3 미디어 소스
contributor_3_campaign	Contributor 3 캠페인
contributor_3_touch_type	Contributor 3 터치 타입
contributor_3_touch_time	Contributor 3 터치 타임
지역	지역
country_code	국가 코드
state	상태
city	도시
postal_code	우편번호
dma	DMA
ip	IP
is_wifi	와이파이
운영자	운영자
캐리어	캐리어
언어	언어
appsflyer_id	AppsFlyer ID
advertising_id	광고 ID
idfa	IDFA
android_id	Android ID
customer_user_id	고객 사용자 ID
imei	IMEI
idfv	IDFV
플랫폼	플랫폼
device_type	장치 유형
os_version	OS 버전
app_version	앱 버전
sdk_version	SDK 버전
app_id	App ID
app_name	앱 이름
bundle_id	번들 ID
is_retargeting	리타겟팅
retargeting_conversion_type	리타겟팅 전환 유형
attribution_lookback_window	어트리뷰션 조회 창
reengagement_window	재참여 창구
is_primary_attribution	일차적 귀속
user_agent	사용자 에이전트
http_referrer	HTTP 리퍼러
original_url	원본 URL
blocked_reason_rule	차단된 이유 규칙
is_store_reinstall	스토어 재설치
impressions	Impressions
contributor_3_match_type	기여자 3 경기 유형
custom_dimension	맞춤형 치수
conversion_type	변환 유형
google_play_click_time	구글 플레이 클릭 시간
match_type	경기 유형
mediation_network	중개 네트워크
oaid	OAID
deeplink_url	딥링크 URL
blocked_reason	막힌 이유
blocked_sub_reason	차단된 하위 이유
google_play_broadcast_referrer	구글 플레이 방송 리퍼러
google_play_install_begin_time	구글 플레이 설치 시작 시간
campaign_type	캠페인 유형
custom_data	맞춤형 데이터
rejected_reason	거부 사유
device_download_time	기기 다운로드 시간
keyword_match_type	키워드 일치 유형
CONTRIBUTOR_1_MATCH_TYPE	기여자 1 경기 유형
contributor_2_match_type	기여자 2 경기 유형
device_model	장치 모델
monetization_network	수익화 네트워크
세그먼트	Segment
is_lat	Is LAT
google_play_referrer	구글 플레이 리퍼러
blocked_reason_ value	차단된 이유 value
store_product_page	스토어 상품 페이지
device_category	디바이스 카테고리
app_type	앱 유형
rejected_reason_ value	거부 사유 value
ad_unit	광고 단위
keyword_id	키워드 ID
배치	Placement
network_account_id	네트워크 계정 ID
install_app_store	앱스토어 설치
amazon_fire_id	Amazon Fire ID
att	ATT

검색되지 않는 필드

검색되지 않는 필드

단, 리포트에 따라 일부 필드가 수집되지 않는 경우가 있습니다.
수집되지 않는 필드에 대해서는 아래 표를 참고하세요.

| 보고서 종별 별칭 | 조회되지 않는 필드 | 조회되지 않는 필드
| --- | --- --- |
| 설치 | 없음
| 인앱 이벤트 | 없음
| 제거하기 | 제거하기

custom_dimension

conversion_type

campaign_type

store_product_page

app_type

att

| |
| 재설치 | 없음 | 재설치
| 유기적 설치 | 유기농 설치

store_product_page

| |
| 유기적 인앱 이벤트 | 유기적 인앱 이벤트

is_lat

store_product_page

| |
| 유기적 제거 | 유기농 제거

custom_dimension

conversion_type

campaign_type

store_product_page

app_type

att

| |
| 유기적 재설치

store_product_page

| |