애드 네트워크를 위한 포스트백 매크로

소개

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

AppsFlyer가 포스트백 데이터를 광고 네트워크로 다시 전송할 수 있는 3가지 다른 소스가 있습니다.
  1. 어트리뷰션 링크 파라미터
    클릭 시에 파트너가 제공한 파라미터나 임프레션 URL이 포스트백 URL로 반환됩니다.
    예: 어트리뷰션 링크의 클릭 ID 파라미터 - "&click_id=CLICK_ID"
  2. AppsFlyer의 파트너 ID
    파트너가 광고주에게 제공한 고유 ID가 포스트백을 통해 반환됩니다.
    예: 앱 ID, 계정 ID, 사용자 ID, 네트워크 ID, SDK 키 등

    ad_network_key.png

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

 중요!

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

지원하는 포스트백 매크로

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

  • Source: 데이터가 수신되는 위치 (SDK 또는 링크) 를 나타냅니다.
  • Send all: 광고주의 네트워크(오가닉 포함)에 어트리뷰션되지 않는 인스톨과 이벤트 데이터를 받을 수 있는지 여부를 표시합니다.

설치 및 인앱 이벤트 매크로

매크로 소스 설명 모두 전송
(app-id) SDK 앱 ID 이름 Y
(app-name) SDK 앱 이름 Y
(app-version-name) SDK 앱 코드에서 앱 개발자가 설정한 앱 버전 Y
(appName) SDK 앱 이름 (예: com.appsflyer.adNetworkTest) Y
(appsflyer-device-id) SDK 전환 시에 기록된 앱스플라이어 고유 식별자 Y
(bundle-id) SDK 앱 ID (예: com.appsflyer.adNetworkTest) Y
(sdk-version) SDK 앱스플라이어 SDK 버전 Y
(campaign) 링크 앱스플라이어 어트리뷰션 링크에서 전송된 캠페인 이름(c=) N
(click-ts) SDK 앱스플라이어 어트리뷰션 링크의 클릭 또는 노출 시간 N
(unix-ts) SDK Unix 시간 양식의 타임 스탬프 값 (예: 1510000000) Y
(gp_referrer_click_ts) SDK Google Play를 실행한 시간 N
(gp_referrer_install_ts) SDK 사용자가 Google Play에서 설치를 클릭한 시간 N
(install-ts) SDK 인스톨 시점 Y
(install-unix-ts) SDK 설치(처음 앱 실행) 시의 UNIX 타임스탬프 Y
(publisher_id) 링크 앱스플라이어 어트리뷰션 링크에서 전송된 사이트 ID(af_siteid=) Y
(match-type) SDK 어트리뷰션 매칭 유형(예: uid(id_matching), ref(gp_referrer) 및 fp(확률적 모델링)) N
(is_attributed) SDK 인스톨이나 이벤트가 이 미디어 소스에 어트리뷰션 됐음을 표시하는 플래그 Y
(is-impression) SDK 뷰-쓰루로 어트리뷰션이 발생하면 표시되는 플래그 (1 = 노출, 0 = 클릭) N
(is-reattr-tf) SDK 리어트리뷰션 캠페인임을 표시하는 플래그 (TRUE/FALSE) N
(is-reattr) SDK 리어트리뷰션 캠페인임을 표시하는 플래그 (1/0) N
(is-reengage-tf) SDK 리인게이지먼트 캠페인임을 표시하는 플래그 (TRUE/FALSE) N
(is-reengage) SDK 리인게이지먼트 캠페인임을 표시하는 플래그 (0/1) N
(is-retarget-tf) SDK 리타겟팅 캠페인임을 표시하는 플래그 (TRUE/FALSE) N
(is-retarget) SDK 리타겟팅 캠페인임을 표시하는 플래그 (1/0) N
(is-s2s-0or-1) SDK 인스톨 혹은 이벤트의 소스 - S2S/Not S2S (1/0) Y
(is-s2s) SDK 인스톨 혹은 이벤트의 소스 - S2S/Not S2S (TRUE/FALSE) Y
(is-tracking-disable-0-or-1) SDK 광고 추적 기능이 꺼져있음을 표시하는 플래그 (1/0) N
(is-tracking-disable) SDK 사용자가 제한된 광고 트래킹(LAT) 활성화를 선택하였는지 여부를 표시하는 플래그 TRUE 혹은 FALSE가 될 수 있습니다. N
(is-tracking-enable-0-or-1) SDK 사용자가 제한된 광고 트래킹(LAT) 활성화를 선택하였는지 여부를 표시하는 플래그 (1/0) Y
(is-tracking-enable) SDK 사용자가 제한된 광고 트래킹(LAT) 활성화를 선택하였는지 여부를 표시하는 플래그 (TRUE/FALSE) Y
(android-id) SDK Android ID 고유 식별자
(sha1-android-id)도 사용 가능
Y
(idfa) SDK iOS 고유 식별자
(sha1-idfa)도 사용 가능
Y
(ip) SDK 전환 시에 기록된 사용자 기기의 IP Y
(language) SDK 전환 시에 기록된 사용자 기기에서 사용된 언어 Y
(operator) SDK 사용자 기기 통신사 (예: SKT, KT) Y
(os-version) SDK 운영 체제 버전 이름 Y
(platform) SDK 디바이스 운영체제 (iOS/Android) Y
(device-brand) SDK 전환 시에 기록된 사용자 기기의 브랜드 Y
(device-model) SDK 전환 시에 기록된 사용자 기기의 모델 Y
(device-type) SDK 기기 유형 (예: 아이폰, 삼성폰) Y
(advertiserId) SDK Android GAID 고유 식별자
(sha1-advertiserId)도 사용 가능
Y
(user-agent) SDK 사용자 에이전트 형식(예: "Mozilla/5.0 (iPad)" Y
(vendorId) SDK iOS의 IDFV와 같은 벤더용 ID Y
(wifi) SDK 전환 시에 사용자가 사용한 데이터 연결 유형 (TRUE/FALSE) Y
(carrier) SDK 기기의 서비스 제공업체(예: "AT&T") Y
(city) SDK 전환 시에 기록된 사용자 기기의 도시 Y
(region) SDK 사용자 IP 주소의 지역 Y
(state) SDK 사용자 IP 주소 상태  
(postal-code) SDK 우편번호 Y
(country-code) SDK 전환 시에 기록된 두 글자의 국가 코드 Y
(blocked-reason) SDK 프로드 이유 (예: devicerank, bots, click_flood) N
(blocked-reason-value) SDK 프로드 이유 값 (예: Advertising ID, Site ID) N
(transaction-id) SDK 앱스플라이어가 생성한 고유 값(예: DgC3kh7hWMMC-kPeFLSjNA) Y
(random-str) SDK 앱스플라이어가 생성한 랜덤 스트링 Y
(oaid) SDK 안드로이드 비영구 디바이스 ID Y
(blocked-sub-reason) SDK 프로드(fraud) 하위 이유 (예: high_fraud_rate, new_devices) N

인앱이벤트 전용 매크로

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

매크로 설명 모두 전송 

(event-name)

앱에서 발생한 이벤트 이름

Y

(mapped-iae)

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

Y

(monetary)

이벤트 값, USD

Y

(orig-monetary)

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

Y

(currency)

이벤트 통화 코드

Y

(timestamp)

인앱이벤트 시간

Y

(event-value)

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

Y

(is-primary)

리타겟팅 플래그를 나타냅니다. 리포트의 "is-primary" 컬럼(True/False)에 해당합니다.

Y

 

이벤트 포스트백 템플릿 "&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
도움이 되었습니까?