푸시(Push) API V2.0 실시간 로데이터 사용

요약: 어트리뷰션 이벤트 데이터를 자사 서버 측 엔드포인트에 실시간으로 푸시하십시오. 그리고 이 데이터를 자사 IT 시스템에서 사용합니다.

4409_Push_API_V2-01.png 푸시(Push) API V2.0

푸시 API 공지

  • 푸시 API V2.0은 앱스플라이어 로데이터 V5.0 사양과 정렬됩니다.
    • 추가 필드(field): 푸시 API V1.0에 비해, 40개 이상의 필드가 추가되었습니다.
    • 필드 선택: 푸시 API 메시지의 크기를 줄일 수 있도록 전송할 필드를 선택할 수 있습니다.
    • 빈 필드는 전송되지 않음: 앞으로는 null/빈 필드 및 연관키(associated key) 전송을 중지할 것 입니다.
    • 인앱 이벤트 필터링: 데이터 처리 양을 줄일 수 있도록 전송되는 인앱 이벤트를 선택할 수 있습니다.
  • 푸시 API V1.0은 2020년 8월 31일에 사용 중지됩니다.
  • 푸시 API V1.0에서 푸시 API V2.0으로 마이그레이션 개발 가이드

푸시 API란 무엇입니까?

푸시 API는 어트리뷰션 이벤트 메시지를 자사 서버 측 엔드포인트에 실시간으로 푸시합니다. 그렇게 하면, 다양한 환경과 접점에서 유저 여정을 따라갈 수 있습니다.

다음을 제한하여, 엔드포인트로 전송되는 데이터 양을 줄일 수 있습니다.

  • 선택된 메시지 및 인앱 이벤트 유형
  • 선택된 필드

유용할 수도 있는 다른 앱스플라이어 데이터 전송 솔루션:

이벤트 메시지 유형

가능한 이벤트 메시지 유형
(✓ = 가능, - 해당되지 않음)

캠페인 유형

전환 유형

is_
retargeting
입력값

retargeting_

conversion_

유형

논오가닉 오가닉 리타겟팅
사용자 획득 인스톨(*) False    -
유저 획득  install in-app events False    -

리타겟팅

리인게이지먼트 true   - -
리타겟팅  Re-engagement in-app events true 리인게이지먼트 - -
리타겟팅  Re-attribution  true 리어트리뷰션 - -
리타겟팅  Re-attribution in-app events true 리어트리뷰션 -
* 어떤 인스톨은 restricted 미디어 소스 로 어트리뷰션 되며, 이런 이벤트는 푸시 API를 통해 리포트되지 않습니다. 

메시지 구조와 고유한 필드

푸시 API 메시지는 HTTP 메소드에 따라 다릅니다.

  • GET: 데이터 파라미터가 URL 스트링에 추가됩니다.
  • POST: 데이터 파라미터는 JSON 형식으로 메시지 본문에 포함됩니다. 
  • 다음 예시는 null 또는 빈 필드를 포함합니다. 앞으로는 비어있거나 null인 필드의 전송을 중지할 계획입니다. 

사용 가능한 필드

  • 푸시 API 메시지에는 여기에서 설명된 필드들이 포함됩니다.
  • 때때로 추가 필드가 앱스플라이어 플랫폼에 추가되는대로, 필드가 더해질 수 있습니다. 임포트/파싱 메커니즘에서 이를 고려해야 합니다. 

타임 스탬프 필드 형식:

  • UTC 시간대의 타임 스탬프 필드: 형식 yyyy-mm-dd hh:mm:ss.sss.예를 들어, 2019-09-17 00:09:25.123 처럼 표시됩니다. 이벤트가 14:00 서울 시간에 발생했습니다. UTC로 변환된 시간은 05:00 입니다. 기록된 시간은 UTC 시간대 입니다. 
  • 선택한 시간대의 타임 스탬프 필드: 형식 yyyy-mm-dd hh:mm:ss.sss±th:tm. 예, 2019-01-20 04:51:16.000+0000. 이벤트가 서울 시간 14:00에 이루어졌습니다. 표시된 이벤트 시간은 14:00+09:00 로 기록됩니다. 09:00 은 서울 시간대입니다. 
푸시 API 고유 필드
표시 이름 V2.0 이름 참고 
선택된 통화 selected_currency API 메시지가 전송될 때 적용되어 있는 앱 설정을 따릅니다.
선택된 통화로 표시된 수익 revenue_in_selected_
currency
 
선택된 통화로 표시된 비용 cost_in_selected_
currency
 
Device Download Time Selected Timezone device_download_time_selected_
timezone
 
선택된 시간대의 Attributed Touch Time attributed_touch_time_
selected_timezone
 
선택된 시간대의 Install Time install_time_selected_
timezone
 
선택된 시간대의 Event Time event_time_selected_
timezone
 
선택된 시간대 selected_timezone API 메시지가 전송될 때 적용되어 있는 앱 설정을 따릅니다.

사용 가능한 푸시 API 필드

푸시 API V2.0 이름 푸시 API 표시 이름 댓글
advertising_id Advertising ID  
af_ad 광고  
af_ad_id 광고 아이디  
af_ad_type 광고 타입  
af_adset 광고세트  
af_adset_id 광고세트 ID  
af_attribution_lookback Attribution Lookback Window  
af_c_id 캠페인 ID  
af_channel 채널  
af_cost_currency 비용 통화  
af_cost_model 비용 모델  
af_cost_value 비용 값  
af_keywords 키워드  
af_prt 파트너  
af_reengagement_window Reengagement Window  
af_siteid 사이트 ID  
af_sub_siteid 하위 사이트 ID  
af_sub1 Sub Param 1  
af_sub2 Sub Param 2  
af_sub3 Sub Param 3  
af_sub4 Sub Param 4  
af_sub5 Sub Param 5  
amazon_aid Amazon Fire ID  
android_id Android ID  
api_version API Version  
app_id 앱 ID  
app_name App Name  
app_version App Version  
appsflyer_id AppsFlyer ID  
attributed_touch_time Attributed Touch Time  
attributed_touch_time_selected_timezone 선택된 시간대의 Attributed Touch Time 푸시 API에서만
attributed_touch_type Attributed Touch Type  
bundle_id Bundle ID  
campaign 캠페인  
carrier carrier  
city City  
contributor_1_af_prt Contributor 1 Partner  
contributor_1_campaign Contributor 1 Campaign  
contributor_1_match_type Contributor 1 Match Type  
contributor_1_media_source Contributor 1 Media Source  
contributor_1_touch_time Contributor 1 Touch Time  
contributor_1_touch_type Contributor 1 Touch Type  
contributor_2_af_prt Contributor 2 Partner  
contributor_2_campaign Contributor 2 Campaign  
contributor_2_match_type Contributor 2 Match Type  
contributor_2_media_source Contributor 2 Media Source  
contributor_2_touch_time Contributor 2 Touch Time  
contributor_2_touch_type Contributor 2 Touch Type  
contributor_3_af_prt Contributor 3 Partner  
contributor_3_campaign Contributor 3 Campaign  
contributor_3_match_type Contributor 3 Match Type  
contributor_3_media_source Contributor 3 Media Source  
contributor_3_touch_time Contributor 3 Touch Time  
contributor_3_touch_type Contributor 3 Touch Type  
cost_in_selected_currency 선택된 통화로 표시된 비용 푸시 API에서만
country_code Country Code  
custom_data Custom Data  
CUSTOMER_USER_ID Customer User ID  
deeplink_url 딥링크 URL 2020년 1분기부터 가능
device_category Device Category  

device_download_time 

Device Download Time 2020년 2월 3일까지, 추가 필드인 download_time도 사용할 수 있습니다. 
device_type Device Type  
dma DMA  
device_download_time_selected_timezone Device Download Time Selected Timezone

푸시 API에서만.

2020년 2월 3일까지, 추가 필드인 download_time_selected_timezone 도 사용할 수 있습니다.

event_name Event Name  
event_revenue Event Revenue  
event_revenue_currency Event Revenue Currency  
event_revenue_usd Event Revenue USD  
event_source Event Source  
event_time Event Time  
event_time_selected_timezone 선택된 시간대의 Event Time 푸시 API에서만
event_value 이벤트 값  
gp_broadcast_ referrer GP Broadcast Referrer  
gp_click_time Google Play Click Time  
gp_install_begin Google Play Install Begin Time  
gp_referrer 구글 플레이 리퍼러  
http_referrer HTTP Referrer  
IDFA IDFA  
idfv IDFV  
IMEI IMEI  
install_app_store Install App Store  
install_time Install Time  
install_time_selected_timezone 선택된 시간대의 Install Time 푸시 API에서만
ip IP  
is_LAT Is LAT 2019년 4분기부터 가능
is_primary_attribution Is Primary Attribution  
is_receipt_validated Is Receipt Validated  
is_retargeting Is Retargeting  
keyword_id Keyword ID  
keyword_match_type Keywords Match Type  
language language  
match_type Match Type  
media_source 미디어 소스  
network_account_id Network Account ID  
oaid OAID  
operator operator  
original_url Original URL  
os_version OS Version  
platform 플랫폼  
postal_code Postal Code  
region Region  
retargeting_conversion_type Retargeting Conversion Type  
revenue_in_selected_currency 선택된 통화로 표시된 수익 푸시 API에서만
sdk_version SDK Version  
selected_currency 선택된 통화 푸시 API에서만
selected_timezone 선택된 시간대 푸시 API에서만
state State  
store_reinstall (False=다운로드, True=재 다운로드) Store Reinstall  
user_agent User Agent  
wifi wifi  

푸시 API 설정하기

 주의

일부 미디어 소스는 해당 미디어 소스에서 제공한 사용자 수준 데이터의 사용 방법, 타사와의 공유 또는 둘 다를 제한합니다. 미디어 소스의 사용 약관을 준수하는지 확인하십시오.
예, 페이스북, 트위터, 스냅챗, 핀터레스트.

푸시 API를 설정하려면, 아래 작업 목록을 완료하십시오.

푸시 API 작업 목록
작업 번호  새 엔드포인트 설정 절차
1

서버 측 필요 사항 점검표 확인

2

체크리스트를 참고하며 엔드포인트 설정 계획

3

엔드포인트 설정

서버 측 필요 사항 (앱 개발사 서버)

서버가 여기에 나열된 필요 사항을 준수하는지 확인하십시오. 

서버 측 필요 사항
엔드포인트 URL
  • 유효한 도메인 이름
  • 동일한 엔드포인트는 앱 당 한 번만 사용할 수 있습니다. 
  • 앱 당 최대 엔드포인트 수: 6
엔드포인트 리턴 코드 메시지를 수신하면, 엔드포인트는 반드시 HTTP 200 상태 코드를 리턴해야만 합니다.
앱스플라이어 서버 허용 화이트리스트

엔드포인트와의 통신을 보장하기 위해, 앱스플라이어 서버 IP 주소를 화이트리스트합니다.

TLS 버전
포트

포트: 80, 443

푸시 API 계획 체크리스트

  • 다음 체크리스트를 사용하여 엔드포인트 설정을 계획하십시오. 그림 속의 숫자는 체크리스트의 행 번호와 같습니다.

엔드포인트 

PushAPI_us-en.png

엔드포인트 계획 체크리스트

아닙니다.

설정

상세 내용 현재 설정
1

방법

POST 또는 GET  

2

엔드포인트 URL

-  
3 이벤트 메시지 유형
  • 적어도 하나의 이벤트 메시지 유형을 선택하십시오.
  • 인앱 이벤트 메시지를 선택하려면, 인앱 이벤트를 기록해야 합니다. 그렇게 할 때까지는 인앱 이벤트 메시지를 선택할 수 없습니다. 

InappSelectionDisabled_us-en.png

 

4

필드 

필드 목록은 모든 메시지 유형에 공통입니다.

필요한 필드를 선택하십시오.

  • 일반적인 필드는 기본적으로 미리 선택되어 있습니다.
  • 앞으로는 비어있거나 null 필드의 전송을 중지할 계획입니다. 이는 연관키(associated key)에도 해당됩니다. 파싱/임포트 절차를 계획할 때, 이 점을 고려하십시오. 
 
5

인앱 이벤트 유형

 

인앱 이벤트 기준으로 필터링하여 엔드포인트로 전송되는 트래픽을 줄입니다.

  • 하나 또는 여러개, 또는 모든 인앱 이벤트를 선택합니다. 참고! 만약 이벤트가 목록에 표시되지 않는다면, 검색하십시오. 
  • 만약 모두 선택으로 설정한다면, 새로운 인앱 이벤트는 자동으로 추가됩니다.
  • 인앱 이벤트는 한 번 이상 기록된 후에만 선택할 수 있습니다. 
  • mceclip1.png
 
페이스북 페이스북으로 어트리뷰트된 사용자 데이터를 보내려고 하십니까? 
  • 페이스북 데이터를 받으려면, 페이스북 서비스 약관에 동의했는지 확인하십시오.

 

엔드포인트 설정 및 관리

  • 이 섹션에는 엔드포인트를 추가, 테스트, 수정 및 삭제하는 절차가 포함되어 있습니다.
  • 오직 어드민 계정만 API 설정을 변경할 수 있습니다. 팀 멤버는 푸시 API 설정을 볼 수만 있습니다.
AppsFlyerAdmin_us-en.png 푸시 API 엔드포인트를 추가하려면:
  1. 좌측 메뉴에서 연동 > API 액세스 로 갑니다.푸시 API 섹션까지 아래로 스크롤 합니다.
    푸시 API 섹션이 표시됩니다.
  2. 엔드포인트 추가 버튼을 클릭합니다.
  3. HTTP 메소드를 선택합니다: POST 또는 GET
  4. 엔드포인트 URL 을 입력합니다.
  5. 하나 또는 여러개의 이벤트 유형을 선택합니다.  참고! 만약 인앱 이벤트 메시지가 비활성화 상태라면, 아직까지 아무 인앱 이벤트도 기록되지 않은 것입니다. 
  6. 푸시 API 메시지에 포함될 필드를 선택합니다. 참고:
    • 항상 전송되는 필수 필드: App ID, Event name, Event time, IDFA (iOS) 또는 Advertising ID (안드로이드)
    • 다음 그림을 참고하여 옵션 필드를 선택하십시오. 

      PushAPIFieldSelect1.jpg

      • 가장 자주 선택된 필드가 미리 선택되어 있습니다. 해당 선택을 취소할 수도 있습니다.
      • 필요에 따라 옵션 필드를 선택하십시오.
      • 모든 옵션 필드를 선택 취소하려면 모두 지우기 를 클릭하십시오.
      • 이제 곧, 가까운 미래에, null/빈 필드 및 연관키(associated key) 전송을 중지할 것 입니다. 임포트/파싱 절차를 계획할 때, 이 점을 고려하십시오.
  7. 인앱 이벤트를 하나 또는 여러개 (최대 52개 이벤트) 선택하거나, 모두 선택 합니다.
    • 목록은 이미 기록된 적이 있는 이벤트 유형들로 이루어져 있습니다. 이벤트가 누락된 경우, 테스트 기기를 사용하여 이 유형의 이벤트를 보내십시오. 
  8. 저장 을 클릭합니다.
    이제 푸시 API가 활성화되었습니다.
    전환 데이터가 엔드포인트로 전송됩니다.
  9. 아래 설명된 절차를 통해 엔드포인트를 테스트 합니다.
  10. 페이스북으로 어트리뷰트된 이벤트를 수신하려면, 먼저 페이스북 서비스 약관을 수락해야만 합니다. 

엔드포인트를 테스트하려면:

  1. 테스트 전송 을 클릭합니다.
    테스트 전송  버튼 아래에 테스트 결과 메시지가 표시됩니다. 
    테스트 메시지가 엔드포인트로 전송됩니다.
  2. 엔드포인트가 테스트 메시지를 수신했는지 확인합니다.
    전송된 메시지 샘플은 아래와 같습니다.

POST 및 GET API 메시지 테스트

다음 POST 메시지가 테스트 메시지로 전송됩니다.

{                  
  "idfv": "123456789",
  "device_category": "phone",
  "af_sub1": "sub1-12345",
  "customer_user_id": "Customer User ID",
  "is_lat": null,
  "contributor_2_af_prt": "attributionagency",
  "bundle_id": "bundleIdentifier_test",
  "gp_broadcastreferrer": "",
  "contributor_2_touch_time": "2019-12-31 00:05:42.805",
  "contributor_3_touch_type": "click",
  "event_source": "SDK",
  "af_cost_value": "10",
  "contributor_1_match_type": "id_matching",
  "app_version": "app_version",
  "contributor_3_af_prt": "attributionagency",
  "custom_data": null,
  "contributor_2_touch_type": "click",
  "gp_install_begin": "2019-12-31 00:07:14.000",
  "city": "Redmond",
  "amazon_aid": "9173fe74-0578-4658-a461-ebb0b4fce6d6",
  "gp_referrer": "af_tranid=000712-31122019254604&pid=pdsagency_int&c=pushapi_v2",
  "af_cost_model": "CPI",
  "af_c_id": "cid12345",
  "attributed_touch_time_selected_timezone": "2019-12-31 00:06:32.891+0000",
  "selected_currency": "EUR",
  "app_name": "com.pds.pushapi2.v2.transparent.com",
  "install_time_selected_timezone": "2019-12-31 00:07:14.961+0000",
  "postal_code": "98052",
  "wifi": false,
  "install_time": "2019-12-31 00:07:14.961",
  "operator": "ORANGE",
  "attributed_touch_type": "click",
  "af_attribution_lookback": "25d",
  "keyword_match_type": null,
  "af_adset_id": "adset12345",
  "device_download_time_selected_timezone": "2019-12-31 00:07:14.961+0000",
  "contributor_2_media_source": "contrib2",
  "contributor_2_match_type": "id_matching",
  "api_version": "2.0",
  "attributed_touch_time": "2019-12-31 00:06:32.891",
  "revenue_in_selected_currency": null,
  "is_retargeting": false,
  "country_code": "US",
  "gp_click_time": "2019-12-31 00:07:12.000",
  "contributor_1_af_prt": "attributionagency",
  "match_type": "id_matching",
  "appsflyer_id": "e126a3b3-3406-4196-a964-563c9ae44ff8",
  "dma": "819",
  "http_referrer": "https://www.amazon.com/gp/bestsellers/gift-cards/ref=sv_gc_0",
  "af_sub5": "sub5-12345",
  "af_prt": "attributionagency",
  "event_revenue_currency": null,
  "store_reinstall": null,
  "install_app_store": null,
  "media_source": "pdsagency_int",
  "deeplink_url": null,
  "campaign": "pushapi_v2",
  "af_keywords": "keywords12345",
  "region": "NA",
  "cost_in_selected_currency": "1000",
  "event_value": null,
  "ip": "20.168.174.166",
  "oaid": null,
  "event_time": "2019-12-31 00:07:14.961",
  "is_receipt_validated": null,
  "contributor_1_campaign": "camp1",
  "af_sub4": "sub4-12345",
  "imei": null,
  "contributor_3_campaign": "camp3",
  "event_revenue_usd": null,
  "af_sub2": "sub2-12345",
  "original_url": "https://app.appsflyer.com/com.pds.pushapi2.v2.transparent.com?c=pushapi_v2&pid=pdsagency_int&clickid=click12345&af_ref=000632-31122019&advertiserId=9173fe74-0578-4658-a461-ebb0b4fce6d6&android_id=3e06b4caebc19356&sha1_android_id=sha12345&af_siteid=136396&af_sub_siteid=sub_siteid12345&af_c_id=cid12345&af_adset=adset12345&af_adset_id=adset12345&af_ad=ad12345&af_ad_id=adid12345&af_ad_type=adtype12345&af_channel=channel12345&af_keywords=keywords12345&is_retargeting=False&af_dp=ebay%3A%2F%2Fshoppingcart&af_web_dp=www.dp.com&af_sub1=sub1-12345&af_sub2=sub2-12345&af_sub3=sub3-12345&af_sub4=sub4-12345&af_sub5=sub5-12345&af_cost_model=CPI&af_cost_value=10&af_cost_currency=EUR&sha1_advertising_id=sha12345&sha1_el=sha12345&af_installpostback=false&af_force_dp=true&af_chrome_lp=true&af_ec=1&af_click_lookback=25d&af_viewthrough_lookback=1h&af_reengagement_window=2d&af_prt=attributionagency",
  "contributor_2_campaign": "camp2",
  "android_id": "3e06b4caebc19356",
  "contributor_3_media_source": "contrib3",
  "af_adset": "adset12345",
  "af_ad": "ad12345",
  "state": "WA",
  "network_account_id": null,
  "device_type": "Samsung::SH-220",
  "idfa": null,
  "retargeting_conversion_type": null,
  "af_channel": "channel12345",
  "af_cost_currency": "EUR",
  "contributor_1_media_source": "contrib1",
  "keyword_id": null,
  "device_download_time": "2019-12-31 00:07:14.961",
  "contributor_1_touch_type": "click",
  "af_reengagement_window": "2d",
  "af_siteid": "136396",
  "language": "English",
  "app_id": "com.pds.pushapi2.v2.transparent.com",
  "contributor_1_touch_time": "2019-12-31 00:06:07.847",
  "event_revenue": null,
  "af_ad_type": "adtype12345",
  "carrier": "carrier",
  "event_name": "install",
  "af_sub_siteid": "sub_siteid12345",
  "advertising_id": "9173fe74-0578-4658-a461-ebb0b4fce6d6",
  "os_version": "6.0",
  "platform": "android",
  "af_sub3": "sub3-12345",
  "contributor_3_match_type": "id_matching",
  "selected_timezone": "UTC",
  "af_ad_id": "adid12345",
  "contributor_3_touch_time": "2019-12-31 00:05:17.757",
  "user_agent": "Dalvik/1.6.0 (Linux; U; Android 6.0; Redmi Note 4 Build/KOT49I.F320S22g",
  "is_primary_attribution": null,
  "sdk_version": "v4.8.0",
  "event_time_selected_timezone": "2019-12-31 00:07:14.961+0000"
}

엔드포인트 변경하기

AppsFlyerAdmin_us-en.png 엔드포인트 설정을 수정하려면: 

  1. 좌측 메뉴에서 연동 > API 액세스 로 갑니다.
    푸시 API 섹션까지 아래로 스크롤 합니다.
    푸시 API 섹션이 표시됩니다.
  2. 수정할 엔드포인트를 찾습니다.
  3. 수정합니다.
  4. 저장 버튼을 클릭합니다.

엔드포인트 삭제하기

 AppsFlyerAdmin_us-en.png엔드포인트를 삭제하려면:

  1. 좌측 메뉴에서 연동 > API 액세스 로 갑니다.
    푸시 API 섹션까지 아래로 스크롤 합니다. 
  2. 엔드포인트 삭제 를 클릭합니다.
  3. 저장 을 클릭합니다.
    엔드포인트가 삭제되었습니다.

V1.0 에서 V2.0 으로 엔드포인트 마이그레이션하기

AppsFlyerAdmin_us-en.pngV1.0 에서 V2.0 으로 엔드포인트를 마이그레이션하려면:

  1. 좌측 메뉴에서 연동 > API 액세스 로 갑니다.푸시 API 섹션까지 아래로 스크롤 합니다.
    푸시 API 섹션이 표시됩니다.
  2. 마이그레이션할 엔드포인트를 찾습니다.
  3. 푸시 API 메시지에 포함될 필드를 선택합니다. 
    • 항상 전송되는 필수 필드: App ID, Event name, Event time, IDFA (iOS) 또는 Advertising ID (안드로이드)
    • 다음 그림을 참고하여 옵션 필드를 선택하십시오. 

      PushAPIFieldSelect1.jpg

      • 가장 자주 선택된 필드가 미리 선택되어 있습니다. 해당 선택을 취소할 수도 있습니다.
      • 필요에 따라 옵션 필드를 선택하십시오.
      • 모든 옵션 필드를 선택 취소하려면 모두 지우기 를 클릭하십시오.
      • 이제 곧, 가까운 미래에, null/빈 필드 및 연관키(associated key) 전송을 중지할 것 입니다. 임포트/파싱 절차를 계획할 때, 이 점을 고려하십시오.
  4. 인앱 이벤트를 하나 또는 여러개 (최대 52개 이벤트) 선택하거나, 모두 선택 합니다.
    • 목록은 이미 기록된 적이 있는 이벤트 유형들로 이루어져 있습니다. 이벤트가 누락된 경우, 테스트 기기를 사용하여 이 유형의 이벤트를 보내십시오. 
  5. 저장 버튼을 클릭합니다.
    • 푸시 API가 마이그레이션 되었습니다. 
    • 전환 데이터는 엔드포인트로 계속 전송됩니다.

트러블슈팅, 제한 특성

중복된 리타겟팅 인앱 이벤트

유저 유입(UA) 리인게이지먼트 윈도우 내에, 리타겟팅 캠페인의 영향으로 구매 이벤트가 일어나는 경우, 리타겟팅 인앱 이벤트는 중복 기록됩니다. 이는 UA 미디어 소스와 리타겟팅 미디어 소스 모두에 수익을 어트리뷰션 하기위해 이루어집니다.

아래 둘 다 활성화한 경우에만 중복 이벤트 기록이 발생합니다.

  • install in-app events
  • 리타겟팅 인앱 이벤트 

UA 미디어 소스에 어트리뷰션된 인앱 이벤트(인스톨 인앱 이벤트)가 또한 리타겟팅 캠페인의 일부라면, is_primary_attribtuion=false  필드를 가지고 있습니다.

 

  • 사용자가 example_app 을 인스톨하여, ua_network에 어트리뷰션 되었습니다.
  • 그 이후, 사용자는 example_app의 retar_network의 리타겟팅 캠페인에 리인게이지먼트하고 구매를 합니다.

해당 인앱 구매 이벤트는 다음 상세 내역과 함께 두 번 전송됩니다.

리타겟팅 인앱 이벤트 필드
이벤트 유형 미디어 소스 is_retargeting re_targeting conversion_type is_primary_
attribution 
Install in-app event ua_network true re-engagement 또는 reattribution  False
Retargeting in-app event retar_network true re-engagement 또는 reattribution  true


중복된 리타겟팅 이벤트는 어떻게 구분할 수 있습니까?

is_primary_attribution 불 방식(boolean) 필드는 리타겟팅 캠페인에서 primary와 secondary 미디어 소스를 구분합니다.

  • False : 원래 UA 미디어 소스를 표시합니다. 참고: 값이 false로 기록되는 유일한 경우 입니다. 
  • True: 리인게이지먼트 미디어 소스입니다. 

이에 대한 이유는 다음과 같습니다. 사용자가 리타겟팅 캠페인의 결과로 캠페인에 참여하면 리인게이지먼트 윈도우가 시작됩니다. 리인게이지먼트 미디어 소스는, 리인게이지먼트 윈도우에 포함되면서 UA 소스가 secondary인 경우, primary 미디어 소스로 간주됩니다. 리인게이지먼트 윈도우가 끝나면, 원래 UA 미디어 소스가 primary로 돌아갑니다. 

인앱 이벤트 메시지 선택란이 비활성화 상태입니다.

InappSelectionDisabled_us-en.png

  • 인앱 이벤트 메시지는 최소 하나의 인앱 이벤트가 기록된 후에만 선택할 수 있습니다.
  • 테스트 기기를 사용하여 인앱 이벤트를 생성하거나, S2S API 를 사용하여 수동으로 이벤트를 생성하십시오.

페이스북 데이터 누락

기본 설정으로는, 페이스북은 사용자 수준 로데이터를 제공하지 않습니다. 페이스북 사용 약관에 동의해야 합니다.
약관에 동의하고 나면, 페이스북 및 다른 로데이터 소스에서 제공된 사용자 수준 데이터가 푸시 API를 통해 전송됩니다.

누락된 푸시 메시지와 CloudFront

엔드포인트로 아마존 CloudFront를 사용하고 있습니까? 그렇다면, CloudFront가 거부 코드 421로 메시지를 거부하고 있는지 확인하십시오. 이 경우  CloudFront에서 HTTPS 요청을 처리하는 방법 선택 안내를 참고하십시오.

제한 & 특성

특성
항목 참고 
광고 네트워크 애드 네트워크에서는 사용할 수 없습니다. 
에이전시 에이전시에서는 사용할 수 없습니다.
앱 별 시간대 지원됨.
앱 별 통화  지원됨.
사이즈 제한 해당 사항 없음.
오가닉 
논오가닉
데이터 최신성 실시간
과거 데이터 Not supported. Event data is sent after configuring Push API. If you need historical raw data use Pull API. 
팀 멤버의 접근 권한 팀 멤버는 푸시 API 설정을 볼 수는 있지만, 변경할 수 없습니다. 
도움이 되었습니까?