Macro postback cho Mạng quảng cáo

At a glance: When mobile users install or perform in-app events, AppsFlyer sends postbacks to the originating ad networks and to other endpoints as defined. These postbacks may include macros.

AppsFlyer sends postbacks to ad networks using the following data sources:
  • Attribution link parameters: Parameters provided by the partner on click, by impression URLs can be returned on the postback URLs. Example: click ID parameter on the attribution link - "&click_id=CLICK_ID"
  • Partner IDs in AppsFlyer: Unique IDs given to the advertiser by the partner can be sent back via a postback. Examples: app ID, account ID, user ID, network ID, SDK key etc.
  • SDK derived information: Information extracted from the device by the AppsFlyer SDK. Example: iOS device IDs can be extracted by using "&IDFA=(idfa)" on the postback
  • Protect360 and Validation Rules: Information about installs identified as fraud and installs violating campaign targeting rules, and their associated in-app events. 

Changing postback settings

  • Ad networks request changes to macro settings by reaching out to their AppsFlyer partner development manager
  • Postbacks are available for:
    • install and in-app events
    • Blocked Install and in-app events due to fraud identified by Protect360 or violation of Targeting Validation rules.

Postback Macro được hỗ trợ

Dưới đây là danh sách toàn bộ các macro được hỗ trợ của AppsFlyer. Khi được đặt trên một postback, những macro này sẽ được tự động thay thế bằng dữ liệu có liên quan của người dùng. Ví dụ, để lấy địa chỉ IP của những người dùng đang cài đặt, hãy đưa cả "&ip_address=(ip)" vào trong cấu trúc của postback. 

  • Nguồn: cho biết nhận dữ liệu từ đâu (SDK hoặc liên kết)
  • Gửi tất cả: cho biết bạn có thể nhận dữ liệu này về các lượt cài đặt và sự kiện không được phân bổ cho mạng của bạn hay không (bao gồm cả tự nhiên)

Macro Cài đặt và Sự kiện trong ứng dụng

Macro Nguồn Mô tả Gửi tất cả
(app-id) SDK Tên của id ứng dụng  Y
(app-name) SDK Tên của ứng dụng Y
(app-version-name) SDK Phiên bản ứng dụng được thiết lập bởi nhà phát triển ứng dụng trong mã nguồn của ứng dụng Y
(appName) SDK Tên ứng dụng (ví dụ: com.appsflyer.adNetworkTest) Y
(appsflyer-device-id) SDK Mã định danh riêng của AppsFlyer được ghi lại trên chuyển đổi Y
(bundle-id) SDK ID Ứng dụng (ví dụ: com.appsflyer.adNetworkTest) Y
(sdk-version) SDK Phiên bản AppsFlyer SDK Y
(campaign) Liên kết Tên chiến dịch như được gửi trong liên kết phân bổ AppsFlyer (c=) N
(click-ts) SDK Thời gian nhấp chuột hoặc hiển thị trên liên kết phân bổ AppsFlyer N
(unix-ts) SDK Giá trị nhãn thời gian ở định dạng thời gian Unix (ví dụ: 1510000000) Y
(gp_referrer_click_ts) SDK Thời gian Google Play được mở N
(gp_referrer_install_ts) SDK Thời gian khi người dùng nhấp Cài đặt trên Google Play N
(install-ts) SDK Nhãn thời gian cài đặt Y
(install-unix-ts) SDK Nhãn thời gian cài đặt (mở ứng dụng lần đầu) trong thời gian UNIX Y
(publisher_id) Liên kết ID trang như được gửi trong liên kết phân bổ AppsFlyer (af_siteid=) Y
(match-type) SDK Kiểu so khớp phân bổ (ví dụ: uid (id_matching), ref (gp_referrer) và fp (Mô hình xác suất)) N
(is_attributed) SDK Cờ đánh dấu cài đặt hoặc sự kiện có được phân bổ cho nguồn truyền thông này hay không Y
(is-impression) SDK Cờ đánh dấu phân bổ có xảy ra do xem hết (1 = lượt hiển thị, 0 = lượt nhấp) hay không N
(is-reattr-tf) SDK Cờ đánh dấu đây có phải là chiến dịch phân bổ lại hay không (TRUE/FALSE) N
(is-reattr) SDK Cờ đánh dấu đây có phải là chiến dịch phân bổ lại hay không (1/0) N
(is-reengage-tf) SDK Cờ đánh dấu đây có phải là chiến dịch thu hút lại hay không (TRUE/FALSE) N
(is-reengage) SDK Cờ đánh dấu đây có phải là chiến dịch thu hút lại hay không (0/1) N
(is-retarget-tf) SDK Cờ đánh dấu đây có phải là chiến dịch nhắm mục tiêu lại hay không (TRUE/FALSE) N
(is-retarget) SDK Cờ đánh dấu đây có phải là chiến dịch nhắm mục tiêu lại hay không (1/0) N
(is-s2s-0or-1) SDK Nguồn cài đặt hoặc sự kiện - S2S/Không phải S2S (1/0) Y
(is-s2s) SDK Nguồn cài đặt hoặc sự kiện - S2S/Không phải S2S (TRUE/FALSE) Y
(is-tracking-disable-0-or-1) SDK Cờ đánh dấu theo dõi quảng cáo có bị tắt hay không (1/0) N
(is-tracking-disable) SDK Cờ đánh dấu người dùng có chọn tắt theo dõi quảng cáo giới hạn (LAT) hay không. Có thể là TRUE hoặc FALSE. N
(is-tracking-enable-0-or-1) SDK Cờ đánh dấu người dùng có chọn bật LAT - theo dõi quảng cáo giới hạn hay không (1/0) Y
(is-tracking-enable) SDK Cờ đánh dấu người dùng có chọn bật LAT - theo dõi quảng cáo giới hạn hay không (TRUE/FALSE) Y
(android-id) SDK Bộ định danh riêng của Android ID.
Cũng khả dụng dưới dạng: (sha1-android-id)
Y
(idfa) SDK Bộ định danh riêng của iOS.
Cũng khả dụng dưới dạng: (sha1-idfa)
Y
(ip) SDK IP của thiết bị người dùng được ghi lại khi chuyển đổi Y
(language) SDK Tên của ngôn ngữ dùng trên thiết bị người dùng được ghi lại trên chuyển đổi Y
(operator) SDK Nhà mạng di động của người dùng (ví dụ: airtel) Y
(os-version) SDK Tên phiên bản của Hệ điều hành Y
(platform) SDK Nền tảng thiết bị (IOS/Android) Y
(device-brand) SDK Nhãn hiệu thiết bị của thiết bị người dùng được ghi lại khi chuyển đổi Y
(device-model) SDK Model của thiết bị người dùng được ghi lại khi chuyển đổi Y
(device-type) SDK Loại thiết bị (ví dụ: IPHONE, SAMSUNG) Y
(advertiserId) SDK Mã định danh riêng của Android GAID.
Cũng khả dụng dưới dạng: (sha1-advertiserId)
Y
(user-agent) SDK Định dạng User-Agent (VD: "Mozilla/5.0 (iPad)" Y
(vendorId) SDK ID cho các nhà cung cấp, ví dụ IDFV cho iOS Y
(wifi) SDK Loại kết nối dữ liệu được người dùng sử dụng khi chuyển đổi (TRUE/FALSE) Y
(carrier) SDK Nhà cung cấp dịch vụ cho thiết bị (ví dụ "AT&T") Y
(city) SDK Thành phố của thiết bị người dùng được ghi lại khi chuyển đổi Y
(region) SDK Khu vực của địa chỉ IP người dùng Y
(state) SDK Tiểu bang của địa chỉ IP người dùng 
(postal-code) SDK Mã bưu chính/ZIP Y
(country-code) SDK Mã quốc gia gồm hai ký tự được ghi lại khi chuyển đổi Y
(blocked-reason) Blocking* Lý do gian lận (ví dụ: devicerank, bots, click_flood) N
(blocked-reason-value) Blocking* Giá trị lý do gian lận (ví dụ: ID Quảng cáo, ID Trang web) N
(transaction-id) SDK Một giá trị duy nhất do Appsflyer tạo (ví dụ: DgC3kh7hWMMC-kPeFLSjNA) Y
(random-str) SDK Chuỗi ngẫu nhiên do Appsflyer tạo. Y
(oaid) SDK Mã định danh thiết bị không cố định Android Y
(blocked-sub-reason) Blocking* Fraud sub-reason (high_fraud_rate, new_devices) N
* Blocking: Protect360 or targeting Validation Rules as the case maybe  

Sự kiện trong ứng dụng chỉ có macro

Các macro bên dưới chỉ khả dụng cho những postbacks được gửi tới đối tác sau một sự kiện trong ứng dụng (hoặc máy chủ tới máy chủ):

Macro Mô tả Gửi tất cả 

(event-name)

Tên của sự kiện được kích hoạt trong ứng dụng

Y

(mapped-iae)

Tên/ID của sự kiện tương ứng trong nền tảng đối tác

Y

(monetary)

Giá trị sự kiện theo USD

Y

(orig-monetary)

Giá trị sự kiện theo đơn vị tiền tệ gốc như cấu hình trong ứng dụng

Y

(currency)

Mã Tiền tệ sự kiện

Y

(timestamp)

Thời gian của sự kiện trong ứng dụng

Y

(event-value)

Sự kiện trong ứng dụng phong phú được cải tiến với các giá trị có thẻ được gửi hoàn toàn trên postback theo định dạng JSON, URL được giải mã bằng macro (encode).

Y

(is-primary)

Đại diện cho cờ Nhắm mục tiêu lại, tương đương với cột "is-primary" trên các báo cáo (TRUE/FALSE)

Y

 Ví dụ

Mẫu postback sự kiện "&event=(event)&json=(encode)" đã được dịch thành postback sau đây cho sự kiện af_purchase cụ thể:

&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

The decoded JSON value of this postback is

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

Giá trị được mã hóa

Postback có thể cần chứa các ký tự bất quy tắc, không phải chữ và số. Để chuyển chính xác các giá trị này qua postback, AppsFlyer URL giải mã các giá trị không phải chữ và số trong postback. 

Nếu bạn muốn giải mã một postback được mã hóa, hoặc mã hóa một postback đã giải mã, bạn có thể dùng bất kỳ dịch vụ web mã hóa miễn phí nào, ví dụ như dịch vụ này.

Postback mẫu

Ví dụ về Postback Cài Đặt tổng quan

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)

Ví dụ về Postback Sự kiện trong ứng dụng chung

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)

Ví dụ về Postback Sự kiện trong ứng dụng phong phú

Thông số sự kiện:

Tên sự kiện: af_revenue
Doanh thu sự kiện: 120.00
Tiền tệ sự kiện: USD
Giá trị sự kiện: {"af_quantity":1,"af_revenue":"120","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

Postback:

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
Bài viết này có hữu ích không?

Các bài viết trong mục này