AppsFlyer 포스트백에서 사용할 수 있는 매크로

소개

모바일 사용자가 인앱이벤트를 설치하거나 실행하면, AppsFlyer가 이를 발생시킨 네트워크나 다른 엔드포인트로 포스트백을 전송합니다. 이 포스트백은 다양한 매크로를 포함합니다.

AppsFlyer가 포스트백 데이터를 광고 네트워크로 다시 전송할 수 있는 3가지 다른 소스가 있습니다.
  1. Attribution link parameters
    Parameters provided by the partner on click or impression URLs can be returned on the postback URLs.
    Example: click ID parameter on the attribution link - "&click_id=CLICK_ID"
  2. AppsFlyer의 파트너 ID
    파트너가 광고주에게 제공한 고유 ID가 포스트백을 통해 반환됩니다.
    예: 앱 ID, 계정 ID, 사용자 ID, 네트워크 ID, SDK 키 등

    ad_network_key.png

  3. SDK 추출 정보
    AppsFlyer의 SDK가 기기에서 추출한 정보입니다.
    예: 포스트백에서 "&IDFA=(idfa)"를 사용하여 추출할 수 있는 iOS 기기 ID

 중요!

광고 네트워크에서 포스트백 메시지의 구조 및 정보를 업데이트하려면, 관련 AppsFlyer 파트너 개발팀으로 연락해야 합니다.

지원하는 포스트백 매크로

AppsFlyer가 지원하는 모든 매크로 목록을 아래에서 확인할 수 있습니다. 포스트백에 포함시킬 때, 이 매크로는 자동적으로 사용자 관련 데이터로 대체됩니다. 예를 들어, 설치하는 사용자의 IP 주소를 얻기 위해서는 포스트백 구조에 "&ip_address=(ip)"를 포함시킵니다.

설치 및 인앱이벤트 매크로

매크로 소스 설명

(idfa)

SDK

iOS 고유 식별자.
(sha1-idfa)도 사용 가능

(advertiserId)

SDK

Android GAID 고유 식별자.
(sha1-advertiserId)도 사용 가능

(android-id)

SDK

Android ID 고유 식별자.
(sha1-android-id)도 사용 가능

(app-id)

SDK

앱 ID 이름

(wifi)

SDK

전환 시에 사용자가 사용한 데이터 연결 유형("TRUE" 또는 "FALSE")

(install-unix-ts)

SDK

설치(처음 앱 실행) 시의 유닉스 타임스탬프

(click-ts)

SDK

Click or impression time on AppsFlyer attribution link

(campaign)

링크

Campaign name as sent in AppsFlyer attribution link (c=)

(publisher_id)

링크

Site ID as sent in AppsFlyer attribution link (af_siteid=)

(country-code)

SDK

전환 시에 기록된 두 글자의 국가 코드

(city)

SDK

전환 시에 기록된 사용자 기기의 도시

(device-brand)

SDK

전환 시에 기록된 사용자 기기의 브랜드

(carrier)

SDK

기기의 서비스 제공업체(예: "AT&T")

(ip)

SDK

전환 시에 기록된 사용자 기기의 IP

(device-model)

SDK

전환 시에 기록된 사용자 기기의 모델

(language)

SDK

전환 시에 기록된 사용자 기기에서 사용된 언어

(appsflyer-device-id)

SDK

전환 시에 기록된 AppsFlyer 고유 식별자

(sdk-version)

SDK

AppsFlyer SDK 버전

(app-version-name)

SDK

앱 코드에서 앱 개발자가 설정한 앱 버전

(user-agent)

SDK

사용자 에이전트 형식(예: "Mozilla/5.0 (iPad)"

(vendorId)

SDK

iOS의 IDFV와 같은 벤더용 ID

(os-version)

SDK

운영 체제 버전 이름

(app-name)

SDK

앱 이름

(match-type)

SDK

어트리뷰션 매칭 유형(예: uid(id_matching), ref(gp_referrer) 및 fp(fingerprint))

(gp_referrer_click_ts)

SDK

Google Play를 실행한 시간

(gp_referrer_install_ts)

SDK

사용자가 Google Play에서 설치를 클릭한 시간

(is-tracking-disable)

 SDK

 

사용자가 제한된 광고 트래킹(LAT) 활성화를 선택하였는지 여부를 표시하는 플래그. "TRUE" 또는 "FALSE"가 될 수 있음.


인앱이벤트 전용 매크로

아래 매크로는 파트너로 전송된 인앱이벤트(또는 서버간 전송) 포스트백에서만 사용할 수 있습니다.

매크로 설명

(event-name)

앱에서 발생한 이벤트 이름

(mapped-iae)

파트너 플랫폼의 해당 이벤트 이름 및 ID

(monetary)

이벤트 값, USD

(orig-monetary)

이벤트 값, 앱에서 설정한 통화

(currency)

이벤트 통화 코드

(timestamp)

인앱이벤트 시간

(event-value)

리치 인앱이벤트는 JSON 형식의 포스트백 및 (encode) 매크로를 사용하여 인코딩된 URL의 포스트백에서 전체적으로 전송되는 값이 있는 속성을 포함합니다.

 

이벤트 포스트백 템플릿 "&event=(event)&json=(encode)"는 특정 af_purchase 이벤트에 대해 다음 포스트백으로 해석됩니다.

&event=af_purchase&json=%7B%22af_quantity%22%3A1%2C%22
af_revenue%22%3A%2212000%22%2C%22af_currency%22%3A%
22USD%22%2C%22af_content_id%22%3A%221107%22%2C%22
af_content_type%22%3A%22default_type%22%7D%0A


이 포스트백의 디코딩된 JSON 값은 다음과 같습니다.

{"af_quantity":1,"af_revenue":"12000","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

인코딩된 값

포스트백은 영문자나 숫자가 아닌 특수 문자를 포함해야할 경우가 있습니다. 포스트백을 통해 이 값을 정확하게 전송하기 위해서는 AppsFlyer URL이 포스트백의 영문자/숫자가 아닌 값을 인코딩합니다.

인코딩된 포스트백을 디코딩하거나, 디코딩된 포스트백을 인코딩하려면, 여기와 같은 무료 인코딩 웹 서비스를 사용할 수 있습니다.

샘플 포스트백

일반적인 설치 포스트백 예시

Android iOS
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)
&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)
&install_time=(install-unix-ts)

일반적인 인앱이벤트 포스트백 예시

Android iOS
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)&
install_time=(install-unix-ts)&event_name=(event-name)&currency=(currency)&
json=(event-value)

리치 인앱이벤트 포스트백 예시

이벤트 파라미터:

이벤트 이름: af_revenue
이벤트 수익: 120.00
이벤트 통화: USD
이벤트 값: {"af_quantity":1,"af_revenue":"120","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

포스트백

http://YourCompanyDomain.com?clickid=8594845&site_id=click123&device_ip=
38.166.144.142&advertising_id=121sxxxx-xxxx-xxxx-xxxx-52454bd7500b&
android_id=9aaeecc4455xxxxx&;install_time=1451923560&event_name=af_purchase&
currency=USD&revenue=120.00&json=%7B%22af_quantity%22%3A1%2C%22 />af_revenue
%22%3A%22120.10%22%2C%22af_currency%22%3A%22USD%22%2C%22af_content_id
%22%3A%221107%22%2C%22af_content_type%22%3A%22default_type%22%7D%0A
도움이 되었습니까?
4명 중 3명이 도움이 되었다고 했습니다.