개요
앱스플라이어에서 전송하는 설정 도움말 페이지입니다.
설정 항목
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 |
검색되지 않는 필드
단, 리포트에 따라 일부 필드가 수집되지 않는 경우가 있습니다.
수집되지 않는 필드에 대해서는 아래 표를 참고하세요.
| 보고서 종별 별칭 | 조회되지 않는 필드 | 조회되지 않는 필드
| --- | --- --- |
| 설치 | 없음
| 인앱 이벤트 | 없음
| 제거하기 | 제거하기
| 재설치 | 없음 | 재설치
| 유기적 설치 | 유기농 설치
| 유기적 인앱 이벤트 | 유기적 인앱 이벤트
| 유기적 제거 | 유기농 제거
| 유기적 재설치