Macro đăng lại cho mạng quảng cáo

Khai quát: Là một mạng quảng cáo, bạn có thể xác định nội dung và điểm cuối của các đăng lại được gửi cho bạn như một phần của việc tích hợp với AppsFlyer. Các đăng lại liên quan đến thu hút của người dùng ứng dụng như lượt cài đặt, sự kiện trong ứng dụng, thu hút lại, v.v.

Hướng dẫn đăng lại đối tác tích hợp liên quan:

Bài đăng lại cho mạng quảng cáo

  • Cấu hình đăng lại: Để yêu cầu thay đổi cài đặt đăng lại của bạn, hãy liên hệ với integration@appsflyer.com hoặc người quản lý phát triển đối tác AppsFlyer của bạn. 
  • Loại đăng lại: Đăng lại có sẵn cho Lượt cài đặt và sự kiện trong ứng dụng cùng Lượt cài đặt và sự kiện trong ứng dụng bị Chặn do gian lận được Protect360 xác định hoặc vi phạm Quy tắc Xác thực nhắm mục tiêu.
Nguồn dữ liệu đăng lại
Nguồn Mô tả
Thông số đường dẫn phân bổ

Các thông số do đối tác cung cấp trên URL lượt nhấp và URL lượt hiển thị

Ví dụ: thông số click ID trên liên kết phân bổ - "&click_id=CLICK_ID"

ID đối tác trong AppsFlyer

ID duy nhất do đối tác cung cấp cho nhà quảng cáo

Ví dụ: ID ứng dụng, ID tài khoản, ID người dùng, ID mạng.

Thông tin bắt nguồn từ SDK

Thông tin được trích xuất từ thiết bị bằng SDK AppsFlyer.

Ví dụ: ID của thiết bị iOS có thể được trích xuất bằng cách dùng "&IDFA=(idfa)" trên đăng lại

Được lấy từ nền tảng AppsFlyer

Thông tin được lấy từ nền tảng AppsFlyer. 

Protect360 và quy tắc xác thực Thông tin về các lượt cài đặt được xác định là gian lận và các lượt cài đặt vi phạm các quy tắc nhắm mục tiêu của chiến dịch cùng các sự kiện trong ứng dụng liên quan

Macro đăng lại

Khi được đưa vào một đăng lại, macro được thay thế bằng dữ liệu có liên quan đến người dùng. Ví dụ: để lấy địa chỉ IP của người dùng cài đặt ứng dụng, hãy thêm country_code=(ip) trong cấu trúc đăng lại. Các macro được hỗ trợ được liệt kê trong bảng sau:

Các cột trong bảng dưới đây có ý nghĩa như sau:

  • Nguồn: Dữ liệu bắt nguồn từ đâu.
    • Liên kết: Đường dẫn phân bổ
    • SDK: SDK AppsFlyer được nhúng trong ứng dụng hoặc API từ máy chủ đến máy chủ
    • AF: Sau khi được AppsFlyer xử lý
  • Gửi tất cả: Nếu có, bạn có thể nhận dữ liệu về lượt cài đặt và sự kiện được phân bổ cho các mạng khác hoặc tự nhiên. (Có nghĩa là không được phân bổ cho bạn).
  • [Cơ sở] Macro cho tất cả các bài đăng lại: Các macro có liên quan đến lượt cài đặt, sự kiện trong ứng dụng và các đăng lại sự kiện bị từ chối
  • [Tùy chọn] cho các sự kiện trong ứng dụng và sự kiện bị từ chối như được chỉ ra trong cột (bị từ chối, trong ứng dụng)
Macro—lượt cài đặt, sự kiện trong ứng dụng và sự kiện bị từ chối
Macro đăng lại (tên) Nguồn Gửi tất cả Mô tả [Cơ sở] Macro cho tất cả các bài đăng lại [Tùy chọn] Sự kiện trong ứng dụng và bị từ chối
advertising_id SDK ID thiết bị người dùng có thể đặt lại, AKA GAID. Cũng khả dụng dưới dạng: (sha1-advertiserId)  
app_name SDK Tên ứng dụng do nhà quảng cáo đặt  
appsflyer_id SDK Mã định danh duy nhất của AppsFlyer được ghi nhận khi có chuyển đổi  
attributed_touch_type SDK Không Giá trị có thể: lượt nhấp, lượt hiển thị, TV, pre-install  
blocked_reason AF Không Lý do gian lận/quy tắc xác thực Không Bị từ chối
blocked_reason_value AF Không Giá trị lý do gian lận/quy tắc xác thực (như ID trang web) Không Bị từ chối
blocked_sub_reason AF Không Lý do phụ gian lận/quy tắc xác thực Không Bị từ chối
bundle_id SDK iOS: Nhận dạng để khớp với một ứng dụng hoặc một nhóm ứng dụng trong iOS (Xem ID gói nhà phát triển của Apple) Android: Tên ứng dụng  
country_code AF Mã Quốc gia sử dụng ISO 3166 (alpha-2) Ví dụ: US, CN.  
event_name SDK Tên được phân bổ cho một sự kiện Không Trong ứng dụng
event_revenue_USD AF Giá trị sự kiện theo USD Không Trong ứng dụng
event_revenue SDK Giá trị sự kiện được SDK báo cáo bằng cách sử dụng event_revenue_currency hoặc đơn vị tiền tệ do bạn chọn. Không Trong ứng dụng
event_revenue
_currency
SDK Mã tiền tệ của doanh thu sự kiện được báo cáo trong sự kiện hoặc đơn vị tiền tệ do bạn chọn Không Trong ứng dụng
event_time SDK Thời gian sự kiện Không Trong ứng dụng
event_value SDK sự kiện trong ứng dụng bao gồm các thuộc tính có giá trị, có thể được gửi hoàn toàn trong bài đăng lại ở định dạng JSON. URL được mã hóa bằng macro (mã hóa). Không Trong ứng dụng
idfa SDK ID quảng cáo người dùng có thể đặt lại được tìm thấy trên thiết bị iOS cũng có sẵn dưới dạng: (sha1-idfa)  
idfv SDK Mã định danh duy nhất cho mỗi người dùng mỗi nhà cung cấp trên thiết bị IOS  
install_time SDK Nhãn thời gian lượt cài đặt  
install_unix_ts SDK Install timestamp in unix format  
is_attributed AF 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  
is_lat SDK Giới hạn theo dõi quảng cáo (LAT): iOS: Bắt đầu từ iOS 14 LAT không còn được Apple hỗ trợ. Xác định trạng thái quyền riêng tư của người dùng bằng ATT. Trong trường hợp này, bỏ qua is_lat. Trước iOS 14, nếu là true, IDFA không khả dụng và được đặt thành 0. Android: Khi là true, người dùng đã chọn không tham gia quảng cáo dựa trên sở thích. Điều này không ngăn chặn việc thu thập GAID.  
is_primary_attribution AF

Nếu là false, hãy xem is_retargeting.

Không Trong ứng dụng
is_retargeting Liên kết Không

Sử dụng kết hợp với is_primary_attribution. Tìm hiểu thêm về phân bổ kép các sự kiện nhắm mục tiêu lại.

Nếu là true (1), sự kiện được báo cáo là một phần của chiến dịch nhắm mục tiêu lại và nguồn truyền thông là nguồn truyền thông nhắm mục tiêu lại.

Nếu là false (0) và is_primary_attribution là false, thì sự kiện là một phần của chiến dịch nhắm mục tiêu lại nhưng nguồn truyền thông được tham chiếu là nguồn truyền thông phân bổ người dùng

 

Không  
ngôn ngữ SDK Ngôn ngữ (địa phương) được báo cáo bởi thiết bị và được thiết lập bởi HĐH thiết bị.  
OAID SDK ID người dùng có thể đặt lại trên một số thiết bị Android thường thay thế cho GAID  
partner_event_id AF Tên/ID của sự kiện tương ứng trong nền tảng đối tác Không Trong ứng dụng
nền tảng SDK Nền tảng thiết bị: iOS, Android hoặc Windows Mobile  
retargeting_
conversion_type
AF Không Một cờ đánh dấu đây là phân bổ lại hay thu hút lại Chỉ nhắm mục tiêu lại  
app_version SDK Tên phiên bản ứng dụng do nhà phát triển đặt trong mã ứng dụng  
app_id SDK ID ứng dụng được ứng dụng báo cáo   
att-0-1 SDK

Những giá trị khả thi:

  • 1: Trạng thái ATT là authorized hoặc af_authorized.
  • 0: Bất kỳ trạng thái ATT nào khác. 
 
att-status SDK

Trạng thái ATT do iOS báo cáo. Như là authorized, not_determined. 

Trong một số trường hợp sẽ không có giá trị và trả về "". 

 
af_ad LINK Không

Tên Quảng cáo (xem thêm) - do nhà quảng cáo/nhà xuất bản cung cấp

af_ad_id LINK Không

Do nhà quảng cáo/nhà phát hành cung cấp

af_adset Liên kết Không
  • Do nhà quảng cáo/nhà phát hành cung cấp.
  • Bộ quảng cáo là cấp trung gian giữa Chiến dịch và Quảng cáo trong cấu trúc phân cấp. Xem thêm
af_adset_id Liên kết Không Do nhà quảng cáo/nhà phát hành cung cấp
c Liên kết Không Do nhà quảng cáo/nhà phát hành cung cấp. Tên của chiến dịch vượt quá 100 ký tự được hiển thị trên bảng điều khiển là "c_name_exceeded_max_length"
af_c_id Liên kết Không Do nhà quảng cáo/nhà phát hành cung cấp
af_siteid Liên kết Không
  • ID duy nhất xác định nhà phát hành hiển thị quảng cáo. Tìm hiểu thêm
af_subsite_id Liên kết Không
  • Mạng phụ quảng cáo/ID Nhà phát hành. 
  • Nếu ngoài nhà phát hành chính (ID trang web), còn có nhà phát hành phụ hoặc bạn muốn thêm thông tin bổ sung, chẳng hạn như loại hình/vị trí đặt quảng cáo trong ứng dụng, như biểu ngữ, quảng cáo xen kẽ, video, v.v., hãy sử dụng af_sub_siteid. Ví dụ: af_sub_siteid =ABCD_4567
af_ad_type Liên kết Không

Use the following naming convention:

  • text: một đơn vị quảng cáo chỉ chứa văn bản, ví dụ: kết quả tìm kiếm
  • banner: một định dạng cơ bản xuất hiện ở trên cùng hoặc dưới cùng của màn hình thiết bị
  • interstitial: quảng cáo toàn trang xuất hiện trong khoảng nghỉ trong trải nghiệm hiện tại
  • video: một video chuẩn, đó không phải là video xem có thưởng
  • rewarded_video: một đơn vị quảng cáo cung cấp phần thưởng trong ứng dụng để đổi lấy việc xem video
  • playable: một đơn vị quảng cáo chứa bản xem trước tương tác của trải nghiệm ứng dụng
  • sponsored_content: một liên kết được bao gồm trong một phần nội dung được tài trợ, giống như một bài viết quảng cáo
  • audio: một quảng cáo âm thanh
imei SDK

A unique number used to identify mobile phones

 

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

Các ví dụ tiếp theo liên quan đến đăng lại sự kiện trong ứng dụng có sẵn cho các đối tác.

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


Giá trị JSON được giải mã của postback này là

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


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

Đăng lại 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 các đăng lại, URL AppsFlyer mã hóa các giá trị không phải chữ và số.

Để giải mã hoặc mã hóa một bài đăng lại, hãy sử dụng một dịch vụ web mã hóa. 

Postback mẫu

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

Android iOS
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&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?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ề đăng lại sự kiện trong ứng dụng

Thông số sự kiện:

  • Tên sự kiện: af_revenue
  • Doanh thu của Sự kiện: 120,00
  • Đơn vị tiền tệ của sự kiện: USD
  • Giá trị của 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