소개
모바일 사용자가 인앱이벤트를 설치하거나 실행하면, AppsFlyer가 이를 발생시킨 네트워크나 다른 엔드포인트로 포스트백을 전송합니다. 이 포스트백은 다양한 매크로를 포함합니다.
-
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" -
AppsFlyer의 파트너 ID
파트너가 광고주에게 제공한 고유 ID가 포스트백을 통해 반환됩니다.
예: 앱 ID, 계정 ID, 사용자 ID, 네트워크 ID, SDK 키 등
-
SDK 추출 정보
AppsFlyer의 SDK가 기기에서 추출한 정보입니다.
예: 포스트백에서 "&IDFA=(idfa)"를 사용하여 추출할 수 있는 iOS 기기 ID
중요!
광고 네트워크에서 포스트백 메시지의 구조 및 정보를 업데이트하려면, 관련 AppsFlyer 파트너 개발팀으로 연락해야 합니다.
지원하는 포스트백 매크로
AppsFlyer가 지원하는 모든 매크로 목록을 아래에서 확인할 수 있습니다. 포스트백에 포함시킬 때, 이 매크로는 자동적으로 사용자 관련 데이터로 대체됩니다. 예를 들어, 설치하는 사용자의 IP 주소를 얻기 위해서는 포스트백 구조에 "&ip_address=(ip)"를 포함시킵니다.
설치 및 인앱이벤트 매크로
매크로 | 소스 | 설명 |
---|---|---|
|
SDK |
iOS 고유 식별자. |
|
SDK |
Android GAID 고유 식별자. |
|
SDK |
Android ID 고유 식별자. |
|
SDK |
앱 ID 이름 |
|
SDK |
전환 시에 사용자가 사용한 데이터 연결 유형("TRUE" 또는 "FALSE") |
|
SDK |
설치(처음 앱 실행) 시의 유닉스 타임스탬프 |
|
SDK |
Click or impression time on AppsFlyer attribution link |
|
링크 |
Campaign name as sent in AppsFlyer attribution link (c=) |
|
링크 |
Site ID as sent in AppsFlyer attribution link (af_siteid=) |
|
SDK |
전환 시에 기록된 두 글자의 국가 코드 |
|
SDK |
전환 시에 기록된 사용자 기기의 도시 |
|
SDK |
전환 시에 기록된 사용자 기기의 브랜드 |
|
SDK |
기기의 서비스 제공업체(예: "AT&T") |
|
SDK |
전환 시에 기록된 사용자 기기의 IP |
|
SDK |
전환 시에 기록된 사용자 기기의 모델 |
|
SDK |
전환 시에 기록된 사용자 기기에서 사용된 언어 |
|
SDK |
전환 시에 기록된 AppsFlyer 고유 식별자 |
|
SDK |
AppsFlyer SDK 버전 |
|
SDK |
앱 코드에서 앱 개발자가 설정한 앱 버전 |
|
SDK |
사용자 에이전트 형식(예: "Mozilla/5.0 (iPad)" |
|
SDK |
iOS의 IDFV와 같은 벤더용 ID |
|
SDK |
운영 체제 버전 이름 |
|
SDK |
앱 이름 |
|
SDK |
어트리뷰션 매칭 유형(예: uid(id_matching), ref(gp_referrer) 및 fp(fingerprint)) |
|
SDK |
Google Play를 실행한 시간 |
|
SDK |
사용자가 Google Play에서 설치를 클릭한 시간 |
|
SDK |
사용자가 제한된 광고 트래킹(LAT) 활성화를 선택하였는지 여부를 표시하는 플래그. "TRUE" 또는 "FALSE"가 될 수 있음. |
인앱이벤트 전용 매크로
아래 매크로는 파트너로 전송된 인앱이벤트(또는 서버간 전송) 포스트백에서만 사용할 수 있습니다.
매크로 | 설명 |
---|---|
|
앱에서 발생한 이벤트 이름 |
|
파트너 플랫폼의 해당 이벤트 이름 및 ID |
|
이벤트 값, USD |
|
이벤트 값, 앱에서 설정한 통화 |
|
이벤트 통화 코드 |
|
인앱이벤트 시간 |
|
리치 인앱이벤트는 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이 포스트백의 영문자/숫자가 아닌 값을 인코딩합니다.
인코딩된 포스트백을 디코딩하거나, 디코딩된 포스트백을 인코딩하려면, 여기와 같은 무료 인코딩 웹 서비스를 사용할 수 있습니다.
샘플 포스트백
일반적인 설치 포스트백 예시
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)
&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)
&install_time=(install-unix-ts)
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install-unix-ts)
일반적인 인앱이벤트 포스트백 예시
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)¤cy=(currency)&
json=(event-value)
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&idfa=(idfa)&install_time=(install-unix-ts)
&event_name=(event-name)¤cy=(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