Cấu trúc và thông số liên kết phân bổ

Đề nghị cho
Nhà tiếp thị Đại lý Mạng quảng cáo
Cập nhật cuối cùng:

Khái quát: Tìm hiểu về cấu trúc và thông số đường dẫn phân bổ của AppsFlyer.

Tổng quan

Đường dẫn phân bổ cho phép nhà quảng cáo thu thập dữ liệu về mức độ tương tác của người dùng với quảng cáo. Các đường dẫn phân bổ được đặt sau quảng cáo và thông báo cho AppsFlyer khi người dùng tương tác với một quảng cáo. Tương tác có thể xảy ra thông qua một lượt nhấp vào quảng cáo hoặc khi người dùng xem một lượt hiển thị quảng cáo. Một bản sao của URL phân bổ được gửi tới AppsFlyer.

Đường dẫn phân bổ được tạo bằng cách sử dụng OneLink hoặc đường dẫn một nền tảng.

  OneLink (liên kết đa nền tảng) Liên kết một nền tảng

Mô tả và trường hợp sử dụng

Sử dụng khi:

  • Bạn muốn có một liên kết duy nhất cho tất cả các nền tảng.
  • Bắt buộc phải có khả năng liên kết sâu.
  • Bạn muốn sử dụng Liên kết Ứng dụng Android hoặc Liên kết Chung iOS để mở ứng dụng.

Tìm hiểu thêm về OneLink

Sử dụng khi:

  • Bạn chỉ sử dụng một nền tảng duy nhất. Ví dụ: Android mà không phải iOS.
  • Bạn chỉ sử dụng lược đồ URI để mở ứng dụng.

Tìm hiểu thêm về cách thiết lập đối tác tích hợp

Điều kiện tiên quyết

Mẫu OneLink

 Không

Thông tin bắt buộc

URL cơ sở

{subdomain}.onelink.me

app.appsflyer.com

Mã định danh duy nhất

ID mẫu

app_id
Cấu trúc URL https://{subdomain}.onelink.me/
{templateid}&pid{media_source}
&af_siteid={ApplicationID}
&c={CampaignName}

https://app.appsflyer.com/{app_id}?pid={media_source}&af_siteid={ApplicationID}&c={CampaignName}
Ví dụ: https://yourbrand.onelink.me/aAB1?pid=greatnetwork_int
&c=GreatCampaign&af_siteid=A1b1		 https://app.appsflyer.com/com.greatapp?pid=greatnetwork_int&
c=GreatCampaign&af_siteid=A1b1

Thông số đường dẫn phân bổ

  • Các thông số được liệt kê có sẵn để sử dụng trong đường dẫn phân bổ.
  • Cột loại trường giá trị là giới hạn ký tự của giá trị thông số. Tìm hiểu thêm về các giới hạn liên quan đến độ dài của các giá trị thông số tại đây.

Thông số đường dẫn phân bổ—UA và nhắm mục tiêu lại

Có thể tải xuống bảng sau dưới dạng tệp tin .csv.

Tham số Hiển thị tên trong dữ liệu thô Mô tả

Loại và độ dài trường
pid Nguồn truyền thông Xác định một đối tác tích hợp của AppsFlyer một cách duy nhất. Đừng thay đổi thông số này. Thông tin chi tiết khác.

Chuỗi 150
c Chiến dịch Được cung cấp bởi nhà quảng cáo hoặc nhà phát hành. Xem các giới hạn về tên chiến dịch.

Chuỗi 100

af_prt

Đối tác
  • Tên Tài khoản Đại lý cho phép phân bổ lượt cài đặt cho đại lý
  • Thận trọng: Không sử dụng tham số này trước khi đảm bảo đã bật Quyền Đại lý

Chuỗi 50

af_mp

 Không áp dụng
  • Cho phép gửi đăng lại cho các đối tác tiếp thị của nhà phát hành mỗi lượt cài đặt.
  • Lưu ý: Hiện tại thông số này chỉ thích hợp cho Đối tác Tiếp thị Pinterest.

 

clickid

Không áp dụng

Mã định danh lượt nhấp riêng của mạng quảng cáo

 

af_siteid

Site ID
  • 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

Chuỗi 24

af_sub_siteid

ID Trang phụ
  • 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

Chuỗi 50

af_c_id

ID Chiến dịch

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

Chuỗi 24

af_adset

Bộ quảng cáo
  • 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

Chuỗi 100

af_adset_id

ID Bộ quảng cáo

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

Chuỗi 24

af_ad

Quảng cáo

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

Chuỗi 100

af_ad_id

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

Chuỗi 24

af_ad_type

Loại quảng cáo

 Sử dụng quy ước đặt tên sau:

  • 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: một 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 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 lượt 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 nằm trong nội dung được tài trợ, như một bài viết quảng cáo
  • audio: một quảng cáo âm thanh

Chuỗi 24

af_click_lookback

Khung thời gian xem lại lượt phân bổ
  • Cửa sổ xem lại cho Phân bổ Lượt nhấp.  Thời lượng của cửa sổ này là CTIT (Thời gian nhấp để cài đặt) tối đa cho người dùng mới được phân bổ đến nguồn hiển thị quảng cáo/liên kết.
  • Số ngày có thể cấu hình cho thời gian phân bổ lượt nhấp xem lại.   Giá trị thông số khả dụng: 1d - 30d (ngày) HOẶC 1h-23h (giờ). Giá trị mặc định là 7d.
  • Có thể tùy chỉnh khung thời gian xem lại cho OneLink và SRN.

Lưu ý: Chỉ ảnh hưởng đến URL lượt nhấp mà không ảnh hưởng đến URL hiển thị.

Tối đa 3 ký tự

af_viewthrough_
lookback

Không áp dụng
  • Số giờ có thể cấu hình cho thời gian xem lại phân bổ lượt xem hết. Giá trị thông số khả dụng: 1h - 24h (giờ). Mặc định là 24h.
  • Khung thời gian xem lại có thể được tùy chỉnh cho SRN.

Lưu ý: Chỉ ảnh hưởng đến URL hiển thị mà không ảnh hưởng đến URL lượt nhấp

Tối đa 3 ký tự

af_channel

Kênh

Kênh nguồn truyền thông mà quảng cáo được phân bổ, ví dụ như UAC_Search, UAC_Display, Instagram, Mạng Đối tượng Meta, v.v.

Enum động. Chuỗi 20

af_keywords

Từ khóa

Danh sách từ khóa cho các chiến dịch nhắm mục tiêu văn bản

Chuỗi 100

af_cost_model

Mô hình Chi phí
  • Mô hình chi phí, CPI (mặc định) hiện là mô hình được hỗ trợ duy nhất, khi báo cáo chi phí theo lượt nhấp, mà điền giá trị chi phí trong báo cáo dữ liệu hợp nhất của AppsFlyer.
  • Trường hợp có thể, báo cáo chi phí bằng API. Trong trường hợp chi phí được báo cáo bằng trên liên kết và bằng API - API được ưu tiên.

Chuỗi 20

af_cost_currency

Đơn vị tiền tệ của chi phí
  • Mã tiền tệ 3 chữ cái tuân thủ ISO-4217. Ví dụ: USD, ZAR, EUR
  • [Mặc định]: USD

Enum. 3 ký tự 

af_cost_value

Giá trị Chi phí
  • Giá trị chi phí trong việc sử dụng tiền tệ chi phí.
  • Lên tới 4 chữ số sau dấu thập phân.
  • CHỈ thiết lập chữ số (sử dụng dấu thập phân nếu cần thiết) Ví dụ: "56", "2.85"

Chuỗi 20

af_sub[n] 

(n=1-5) ví dụ: af_sub1

Thông số phụ [n]

Thông số tùy chỉnh tùy chọn được xác định bởi nhà quảng cáo. Để biết thêm thông tin về cách sử dụng các tham số này, hãy xem phần Câu hỏi thường gặp.

Chuỗi 100
af_r Không áp dụng

Được sử dụng trong các liên kết đơn nền tảng để chuyển hướng người dùng đến URL được chỉ định cho cả hai nền tảng (Android và iOS).

Lưu ý:

  • Không sử dụng trong các liên kết OneLink.
  • Nếu bạn có Danh sách cho phép chuyển hướng đang hoạt động, hãy đảm bảo đưa miền của URL này vào danh sách.
  
af_web_dp Không áp dụng

URL chuyển hướng người dùng máy tính để bàn (ví dụ: Windows hoặc Mac) đến một trang web khác trang web đã cấu hình trong mẫu OneLink. Sử dụng tính năng này để duy trì dữ liệu phân bổ của người dùng máy tính để bàn trên các nền tảng khác (ví dụ: Google Analytics hoặc Omniture)

Lưu ý: Nếu bạn có Danh sách cho phép chuyển hướng đang hoạt động, hãy đảm bảo đưa miền của URL này vào danh sách.

  
af_dp Không áp dụng Giá trị dự phòng lược đồ URI để khởi chạy ứng dụng, được sử dụng nếu phương thức Liên kết Chung hoặc Liên kết Ứng dụng Android không thành công và cho người dùng Android có phiên bản thấp hơn phiên bản 6.0. Chỉ nên chỉ đến đường dẫn cơ sở, tức là hoạt động mặc định.  
af_force_deeplink Không áp dụng Đẩy liên kết sâu vào hoạt động được chỉ định trong giá trị af_dp  
af_ref Không áp dụng
Mạng quảng cáo làm việc với lượt nhấp S2S có thể gửi giá trị tham chiếu duy nhất bằng tham số sau đây: &af_ref=ReferrerValue
Giá trị af_ref phải bao gồm một giá trị duy nhất, có cấu trúc như sau:
NetworkName_UniqueClickValueForEachClick
Ví dụ: af_ref=networkname_123456789ABCDEF
 
Tên mạng có thể là bất kỳ chuỗi nào hợp lệ. Tên mạng có thể là networkname_int hoặc chỉ là networkname.
 
AppsFlyer có thể sử dụng tham số này cho phân bổ trong các thiết bị Android. AppsFlyer không sử dụng tham số này cho phân bổ trong các thiết bị iOS hoặc Windows.
  
is_incentivized Không áp dụng
Boolean: true/false
Chiến dịch khuyến khích hoặc không khuyến khích
  
af_param_
forwarding		 Không áp dụng
  • Khi được đặt thành false, các tham số trên liên kết phân bổ sẽ không được chuyển tiếp đến trang được chuyển hướng
  • Sử dụng điều này để tìm URL sạch hơn trong trang được chuyển hướng hoặc nếu các tham số liên kết phân bổ có thể gây ra sự cố do xử lý tham số truy vấn trên trang được chuyển hướng
  
af_partner_account_id ID tài khoản mạng ID tài khoản của nhà quảng cáo với đối tác Chuỗi 100
af_redirect Không áp dụng Khi af_redirect=false, thông số này cho phép AppsFlyer biết rằng đây là một lượt nhấp S2S và đối tác là người chịu trách nhiệm chuyển hướng người dùng đã nhấp.  
af_ua Tác nhân người dùng

Có liên quan đối với các mạng quảng cáo gửi lượt nhấp và lượt hiển thị từ máy chủ đến máy chủ.

Chuỗi tác nhân người dùng được gửi dưới dạng:

  1. Thông số URL (mã hóa URL)
  2. Tiêu đề yêu cầu HTTP (không được mã hóa)

Tác nhân người dùng phải giống hệt nhau trong cả thông số URL và tiêu đề HTTP.

Lưu ý: Trong Android, tác nhân người dùng đôi khi bị rút gọn thành Client Hints. Vẫn cần gửi tác nhân người dùng này.

  • Ví dụ về tác nhân người dùng đầy đủ: Mozilla/5.0 (Linux; Android 12; Pixel 5) AppleWebKit/537.36 (KHTML, như Gecko) Chrome/95.0.4638.16 Safari Di động/537.36
  • Ví dụ về tác nhân người rút gọn: Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, như Gecko) Chrome/95.0.0.0 Safari Di động/537.36
 
af_ip ip

Có liên quan đối với các mạng quảng cáo gửi lượt nhấp và lượt hiển thị từ máy chủ đến máy chủ.

Địa chỉ IP của thiết bị

Đề xuất: Nếu có, hãy cung cấp IP của thiết bị theo thông số af_ip.

Tùy chọn tiếp theo: Nếu có, AppsFlyer sẽ sử dụng IP trong X-Forwarded-For.

  
[Không còn được hỗ trợ] af_os Phiên bản hệ điều hành

[Chỉ dành cho iOS] Phiên bản hệ điều hành của thiết bị.

Thông số này không còn được hỗ trợ nữa nhưng vẫn được AppsFlyer cho phép dùng. Khuyến nghị: Thay vào đó, hãy sử dụng thông số af_os_version. 

  
af_os_version Phiên bản hệ điều hành
  • Có liên quan đối với các mạng quảng cáo gửi lượt nhấp và lượt hiển thị từ máy chủ đến máy chủ.
  • Phiên bản hệ điều hành của thiết bị.
    • Android:
      • Ví dụ: 12
      • Đối với tác nhân người dùng rút gọn (do trình duyệt chạy trên máy tính để bàn hoặc Android và sử dụng công cụ Chrome 110+), nên mạng quảng cáo phải sử dụng API Client Hints để nhận giá trị này.
      • Đối với tác nhân người dùng không bị rút gọn, hãy sử dụng biểu thức chính quy sau để trích xuất phiên bản HĐH Android từ chuỗi tác nhân người dùng: (\d+(?:\.\d+)*);(?:\s..-..;)?\s(.+?(?=\)|\s\w*\/)).
    • iOS:
      • Ví dụ: 16.2
  
af_model Model Thiết bị
  • Có liên quan đối với các mạng quảng cáo gửi lượt nhấp và lượt hiển thị từ máy chủ đến máy chủ.
  • Model thiết bị.
    •  Android:
      • Ví dụ: Pixel 5
      • Đối với tác nhân người dùng rút gọn (do trình duyệt chạy trên máy tính để bàn hoặc Android và sử dụng công cụ Chrome 110+), nên mạng quảng cáo phải sử dụng API Client Hints để nhận giá trị này.
      • Đối với tác nhân người dùng không bị rút gọn, hãy sử dụng biểu thức chính quy sau để trích xuất mô hình Android từ chuỗi tác nhân người dùng: (\d+(?:\.\d+)*);(?:\s..-..;)?\s(.+?(?=\)|\s\w*\/)).
    • iOS:
      • ipad hoặc iphone (tất cả đều là chữ thường)
  
af_media_type Loại đa phương tiện

Vị trí đặt quảng cáo có liên kết như sau:

  • ứng dụng: Liên kết có sẵn thông qua một ứng dụng
  • web: Liên kết có sẵn trong một trang web di động
  
deep_link_sub1-10 Không áp dụng

Giá trị liên kết sâu bổ sung. Nhà phát triển triển khai hành vi mong muốn của các giá trị trong mã.

  
deep_link_value Không áp dụng

Tên của nội dung trong ứng dụng cụ thể mà người dùng sẽ được chuyển hướng đến. Các nhà phát triển thực hiện hành vi mong muốn của deep_link_value trong mã. 

  
af_og_title Không áp dụng

Khi một liên kết được đăng lên mạng xã hội, tiêu đề biểu đồ mở (OG) sẽ tạo ra bản xem trước của tiêu đề.

 Chuỗi 40
af_og_description Không áp dụng

Khi một liên kết được đăng lên mạng xã hội, mô tả biểu đồ mở (OG) sẽ tạo ra bản xem trước của mô tả.

 Chuỗi 300
af_og_image Không áp dụng

Khi một liên kết được đăng lên mạng xã hội, hình ảnh biểu đồ mở (OG) sẽ tạo ra bản xem trước của hình ảnh.

  

Thông số đường dẫn phân bổ—chỉ nhắm mục tiêu lại

Tham số Hiển thị tên trong dữ liệu thô Mô tả

Loại và chiều rộng của trường

is_retargeting

 Đang nhắm lại mục tiêu (chiến dịch)  URL lượt nhấp của tất cả các chiến dịch nhắm lại mục tiêu phải bao gồm &is_retargeting=true.
Nếu tham số không được bao gồm hoặc có giá trị là "false" thì chiến dịch được coi là chiến dịch thu hút người dùng bình thường.

Enum 5 ký tự

af_reengagement_window

Thời gian tương tác lại

Thay đổi cửa sổ thuộc tính thu hút lại bằng cách thêm tham số này vào liên kết phân bổ.

Các tùy chọn khoảng thời gian có thể là:

  • Ngày: 1-90 hoặc Giờ 1-36
  • Trọn đời: Điều này có nghĩa là khung thời gian thu hút lại không giới hạn. Ví dụ: &af_reengloyment_window=lifetime

Giá trị mặc định: 30 ngày

Ví dụ - &af_reengagement_window=60d đặt cửa sổ thu hút lại là 60 ngày.

Không áp dụng

Thông số loại quảng cáo

Tùy thuộc vào loại quảng cáo, bạn cũng có thể gửi tham số khả năng xem có liên quan nêu ra chi tiết các thông số kỹ thuật của mức độ tương tác. Dưới đây là danh sách các giá trị có thể cho “af_ad_type” cùng với các tham số khả năng xem dự kiến.

Loại quảng cáo (af_ad_type)

Tham số Định dạng giá trị Mô tả
af_video_total_length giây Tổng thời lượng có thể của video
af_video_played_length giây Video được xem trong bao lâu
af_playable_played_length giây Thời gian thành phần có thể phát được phát sau khi được tải đầy đủ
af_ad_time_viewed giây Đơn vị quảng cáo hiển thị trên màn hình trong bao lâu
af_ad_displayed_percent % Tỷ lệ phần trăm tối đa của đơn vị quảng cáo hiển thị trên màn hình thiết bị
af_audio_total_length giây Tổng thời lượng có thể của âm thanh
af_audio_played_length giây Âm thanh được nghe trong bao lâu

Các tham số cụ thể cho Android

Tham số Hiển thị tên trong dữ liệu thô Mô tả

Loại trường

advertising_id

Advertising ID

ID quảng cáo Google - Yêu cầu hỗ trợ mạng quảng cáo

Tối đa 40 ký tự

sha1_advertising_id

Không áp dụng

ID quảng cáo Google biến đổi hash với SHA1 - Yêu cầu hỗ trợ mạng quảng cáo

 

md5_advertising_id

Không áp dụng

ID quảng cáo Google biến đổi hash với MD5 - Yêu cầu hỗ trợ mạng quảng cáo

Chỉ được hỗ trợ với lượt cài đặt và phân bổ lại

android_id

Android ID

Android_id thiết bị - Yêu cầu hỗ trợ mạng quảng cáo

Tối đa 20 ký tự

sha1_android_id

Không áp dụng

Android_id thiết bị biến đổi hash với SHA1 - Yêu cầu hỗ trợ mạng quảng cáo

 

md5_android_id

Không áp dụng

Android_id thiết bị được biến đổi hash với MD5 - Yêu cầu hỗ trợ mạng quảng cáo

Chỉ được hỗ trợ với lượt cài đặt và phân bổ lại

imei

IMEI

ID IMEI thiết bị

 

sha1_imei

Không áp dụng

ID IMEI của thiết bị được biến đổi hash bằng SHA1 - Yêu cầu hỗ trợ mạng quảng cáo

 

md5_imei

Không áp dụng

ID IMEI của thiết bị được biến đổi hash bằng MD5 - Yêu cầu hỗ trợ mạng quảng cáo

 

oaid

OAID

Mã định danh Thiết bị Ẩn danh Mở

Có sẵn kể từ phiên bản SDK Android 4.10.3

sha1_oaid

Không áp dụng

Mã định danh Thiết bị Ẩn danh Mở được biến đổi hash bằng SHA1 - Yêu cầu hỗ trợ mạng quảng cáo

Có sẵn kể từ phiên bản SDK Android 4.10.3

md5_oaid

 Không áp dụng Mã định danh Thiết bị Ẩn danh Mở được biến đổi hash bằng MD5 - Yêu cầu hỗ trợ mạng quảng cáo Có sẵn kể từ phiên bản SDK Android 4.10.3

af_android_url

Không áp dụng

Chuyển hướng người dùng Android đến một URL khác URL trên trang của ứng dụng trên Google Play. Sử dụng cho các cửa hàng ứng dụng của bên thứ ba.

Lưu ý: Nếu bạn có Danh sách cho phép chuyển hướng đang hoạt động, hãy đảm bảo đưa miền của URL này vào danh sách.

 

sha1_el

Không áp dụng

Được sử dụng để phân bổ từ máy tính đến thiết bị di động - biến đổi hash email với SHA1. Yêu cầu hỗ trợ mạng quảng cáo

 

fire_advertising_id

Không áp dụng

ID Quảng cáo Amazon Fire

 

af_android_store_csl

store_product_page

Trang thông tin tùy chỉnh trên Google Console

chuỗi

Các thông số cụ thể cho iOS

Tham số Tên hiển thị Mô tả

idfa

IDFA

Sử dụng chữ hoa. Yêu cầu hỗ trợ mạng quảng cáo

Loại trường: tối đa 40 ký tự

idfv

 IDFV Sử dụng chữ hoa. 

af_ios_url

  

Sử dụng thông số này để chuyển hướng trang đích nhằm chuyển hướng người dùng iOS (iPhone hoặc iPad) đến một URL khác với trang ứng dụng trên iTunes

Lưu ý: Nếu bạn có Danh sách cho phép chuyển hướng đang hoạt động, hãy đảm bảo đưa miền của URL này vào danh sách.
af_ios_store_cpp store_product_page

ID trang sản phẩm tùy chỉnh (ppid)

af_ios_fallback [không còn được hỗ trợ]

 Không áp dụng

Không còn được hỗ trợ: Người dùng được chuyển hướng dựa trên luồng lược đồ URI iOS. 

sha1_idfa

Không áp dụng

IDFA băm với SHA1. Yêu cầu hỗ trợ mạng quảng cáo

sha1_idfv

Không áp dụng

IDFV băm với SHA1

mac

Không áp dụng

Địa chỉ mac của thiết bị. Yêu cầu hỗ trợ mạng quảng cáo

md5_idfv

Không áp dụng

IDFV băm với MD5

sha1_mac

Không áp dụng

Địa chỉ mac của thiết bị biến đổi hash với SHA1. Yêu cầu hỗ trợ mạng quảng cáo

 Ví dụ

https://app.appsflyer.com/{app_id}/?pid=airpush_int&c=RedBanner&
	  af_siteid={publisher_id}&af_sub1=1.5&af_sub2=USD&af_sub3=burst_campaign

Tất cả các thông số có sẵn trong Báo cáo cài đặt và Phân tích, Báo cáo và API.

Thông số tùy chỉnh

Ngoài các thông số mặc định dành riêng cho Android và iOS, bạn cũng có thể chỉ định các thông số tùy chỉnh. Các thông số tùy chỉnh này có thể hữu ích cho bạn nếu bạn muốn tùy chỉnh trải nghiệm và nội dung của người dùng theo đường dẫn phân bổ dẫn đến lượt cài đặt.

Bạn có thể nối các thông số tùy chỉnh vào liên kết phân bổ ở định dạng thông số=giá trị. Ví dụ:

https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&af_adset=coats&af_ad=cashmere&my_custom_param=my_custom_value

Hai điều quan trọng cần biết về thông số tùy chỉnh:

Thông số ID đối tác (PID)

Trong số tất cả các thông số đường dẫn phân bổ có sẵn, PID là bắt buộc. PID là mã định danh duy nhất của nguồn truyền thông do AppsFlyer phân bổ. 

Mỗi đối tác tích hợp đều có giá trị PID duy nhất của riêng họ. PID kết thúc bằng hậu tố _int. Khi sử dụng liên kết OneLink, bạn có thể đặt PID thành bất kỳ giá trị nào bạn mong muốn, miễn là chưa có đối tác tích hợp nào dùng giá trị này. Để tránh xung đột, không sử dụng hậu tố _int. 

Ví dụ về các ID nhà phát hành tích hợp quan trọng: tự nhiên, googleadwords_int (Google AdWords), quảng cáo Meta và Twitter. Bạn có thể sử dụng bất kỳ tên nào cho những nguồn không tích hợp, chẳng hạn như email, SMS hoặc bồ câu đưa thư.

Tránh các sự cố PID phổ biến:

  • Luôn đưa PID vào đường dẫn phân bổ của bạn. Nếu không có PID trên đường dẫn phân bổ, người dùng được tự động phân bổ vào nguồn truyền thông "None" và nguồn cài đặt ban đầu biến mất.
  • Đối với các Nguồn Tùy chỉnh, hãy sử dụng PID của đối tác không tích hợp. Đối với mỗi nguồn tích hợp, chỉ sử dụng PID được chỉ định để phân bổ chính xác lượt cài đặt. Đối với bất cứ nguồn truyền thông tùy chỉnh, chẳng hạn như email, SMS hoặc thậm chí là những bài đăng phổ biến không trả tiền trên Facebook, hãy sử dụng các giá trị PID không tích hợp khác.
  • Chỉ sử dụng các ký tự hợp lệ. Nếu tham số PID trong Liên kết Phân bổ bao gồm một trong các ký tự sau đây ":<>*&?/"-lượt nhấp/lượt cài đặt xuất hiện trong bảng điều khiển theo invalid_media_source_name.

 Lời khuyên

Tránh sử dụng khoảng trắng trong giá trị PID hoặc đảm bảo URL mã hóa liên kết phân bổ của bạn trước khi sử dụng.

Thông số ID trang web

ID trang web là mã định danh duy nhất của nhà phát hành phân phát quảng cáo. Nói cách khác, trang web hoặc ứng dụng hiển thị quảng cáo. Các mạng quảng cáo phân bổ ID trang web duy nhất cho từng nhà phát hành. 

ID này được đưa vào thông số af_siteid được chuyển đến AppsFlyer trong đường dẫn phân bổ và được cung cấp thông qua các bảng điều khiển, tùy chọn báo cáo và đăng lại khác nhau. 

ID trang web phải được chuyển đến AppsFlyer trong đường dẫn phân bổ vì ID này:

  • Cho phép minh bạch và tăng tính rõ ràng về nhà phát hành
  • Được AppsFlyer sử dụng để xác định và loại bỏ các nhà phát hành gian lận và các cụm lưu lượng truy cập khác.

Thông số ID trang web chỉ bao gồm ID của nhà phát hành phục vụ quảng cáo.

Để đưa vào thông tin bổ sung, chẳng hạn như loại quảng cáo, vị trí đặt hoặc cả hai trong ứng dụng, ví dụ như biểu ngữ, quảng cáo xen kẽ hoặc video, hãy sử dụng thông số ID trang phụ.

 Ví dụ

Đường dẫn phân bổ sau đây bao gồm:

  • af_siteid (ID trang web): ID Nhà phát hành
  • af_sub_siteid (ID trang phụ): Thông tin ID bổ sung (trong trường hợp này là nguồn liên kết và vị trí đặt loại quảng cáo)
https://app.appsflyer.com/com.yourapp?pid=mediaName_int&clickid={clickid}&advertising_id={gaid}&af_siteid=1234&af_sub_siteid=ABCD_4567

Trong liên kết ví dụ:

  • 1234 = ID Nhà phát hành
  • ABCD = Nguồn liên kết (nhà phát hành phụ) mà nhà phát hành đang hợp tác làm việc
  • 4567 = Vị trí đặt loại quảng cáo trong ứng dụng, chẳng hạn như biểu ngữ, quảng cáo xen kẽ hoặc video

Câu hỏi thường gặp: Tại sao lưu lượng truy cập dẫn đến nhiều lượt cài đặt bị chặn?

Lượt cài đặt bị chặn có thể do những nguyên nhân sau:

  • Thiếu ID trang web: Thông số af_siteid trống trong URL trang đích. Các lượt thu hút được gửi cùng ID Trang web trống biểu thị đã xảy ra sự cố kỹ thuật hoặc cố ý vượt qua các cơ chế phát hiện gian lận.
  • Nhiều ID trang web: Cùng một nhà phát hành được gửi trên nhiều URL trang đích, sử dụng các ID trang web khác nhau. Đây được coi là hành vi gian lận che giấu hoạt động thực sự của nhà phát hành và thường liên quan đến hành vi nhấp hàng loạt.
  • ID trang web được định dạng không chính xác: Việc gửi sai định dạng, kết hợp với các dấu hiệu gian lận khác, có thể dẫn đến việc chặn không chỉ nhà phát hành cụ thể mà còn ở cấp độ cụm cao hơn và có thể ảnh hưởng đến khối lượng hoạt động lớn hơn của đối tác.

Để tránh lượt cài đặt bị chặn, hãy đảm bảo bạn gửi một thông số ID trang web cho mỗi nhà phát hành, như được minh họa trong ví dụ.

Mức độ Chi tiết Dữ liệu

Bạn có thể sử dụng tối đa bốn thông số URL để tìm hiểu chi tiết hiệu suất quảng cáo.

Sử dụng tất cả 4 tham số trên tất cả liên kết phân bổ hoạt động cho phép bạn:

  • Phân bổ tất cả lượt cài đặt và sự kiện của người dùng cho các quảng cáo cụ thể
  • Truy cập sâu và so sánh hiệu suất của tất cả quảng cáo cho mỗi bộ quảng cáo, mỗi chiến dịch và mỗi nguồn truyền thông trên các báo cáo hợp nhất để tối ưu trên từng mức độ
  • So sánh tất cả quảng cáo của bạn trong tất cả nguồn truyền thông trên các báo cáo dữ liệu thô và Bảng tổng hợp

Các tham số là:

  • Nguồn truyền thông (pid=)
  • tên chiến dịch (c=) 
  • Bộ quảng cáo (af_adset=)
  • Tên quảng cáo (af_ad=) 

 Ví dụ

Các liên kết phân bổ sau đây sử dụng 4 mức độ chi tiết để ghi nhận quảng cáo "cashmere" trong bộ quảng cáo "áo khoác" trong chiến dịch "mùa đông" chạy trên nguồn truyền thông "networkx" tích hợp.


https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere

Đặc điểm và hạn chế

Đặc điểm Lưu ý
Ký tự đặc biệt

Dưới đây là các ký tự đặc biệt không được phép sử dụng trong các thông số hoặc giá trị: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %
Giới hạn ký tự URL

Tổng chiều dài URL không được vượt quá 2000 ký tự 

Câu hỏi thường gặp

Tôi nên sử dụng chữ thường hay chữ hoa đối với các thông số

Bạn có thể sử dụng một trong hai nhưng cần phải nhất quán. Nếu bạn đặt thông số tùy chỉnh gồm các ký tự chữ hoa hoặc chữ thường, hãy đảm bảo luôn sử dụng thông số đó.

Ví dụ, nếu bạn đặt pid=MyMediaSource, hãy đảm bảo luôn sử dụng thông số này. Nếu bạn sử dụng pid=MyMediaSource trên một đường dẫn phân bổ và pid=mymediasource trên một đường dẫn khác, có thể xảy ra sự khác biệt về dữ liệu. Điều tương tự cũng xảy ra với bất kỳ thông số nào khác mà bạn đặt trên đường dẫn phân bổ.

Đường dẫn phân bổ của AppsFlyer là động hay tĩnh?

Liên kết phân bổ của AppsFlyer không phải là trình theo dõi và có thể là động hoặc tĩnh.
Làm thế nào để bạn biết một liên kết là động hay tĩnh?
Nếu liên kết phân bổ có chứa thông số, đó là liên kết phân bổ đã xác định trước, vì vậy là liên kết tĩnh.
Chỉ các URL rút gọn (ví dụ: yourbrand.onelink.me/HaT8/r5c2b371), được sử dụng cho các đường dẫn phân bổ tùy chỉnh, là động.
Điều này có nghĩa là khi bạn bắt đầu sử dụng đường dẫn phân bổ cho đối tác được tích hợp hoặc URL đầy đủ cho truyền thông sở hữu, đường dẫn sẽ không thay đổi đối với bất kỳ khách hàng tiềm năng nào tương tác với nó, ngay cả khi bạn thay đổi giá trị đường dẫn phân bổ trên bảng điều khiển của AppsFlyer. Để thực hiện thay đổi, bạn phải sử dụng URL đầy đủ mới từ giờ về sau.
Mặt khác, các URL rút gọn dùng cho truyền thông sở hữu, không trực tiếp chứa các thông số. Khi khách hàng tiềm năng tương tác với URL rút gọn của AppsFlyer, khách hàng tiềm năng được chuyển hướng đến AppsFlyer và các thông số cài đặt hiện tại diễn ra có tính động.

Thông báo lỗi trên Cửa hàng Play này là gì?

Nếu bạn đã từng gặp thông báo lỗi sau trong Cửa hàng Play sau khi vào một liên kết phân bổ:

TL_error_message.png

Nguyên nhân là do liên kết phân bổ có chứa ký tự #. Ví dụ: 
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#

Thông thường, các ký tự này nằm trong liên kết vì chúng là các macro và được thay thế động bằng một giá trị, do đó, đây không phải là một vấn đề lớn và bạn có thể bỏ qua thông báo.  

 Tham số Người đăng ký có mục đích gì?

Thông số Người đăng ký, nghĩa là af_sub1, af_sub2, ..., af_sub_5 có thể được sử dụng để ghi nhận bất kỳ KPI hữu ích nào. Các thông số này được phân tích và xuất hiện trong báo cáo dữ liệu thô, giúp chúng trở nên rất tiện dụng để thực hiện hợp nhất hoặc lọc dữ liệu.

 Ví dụ

Một ứng dụng gọi xe, Luber, có quảng cáo với 3 mẫu màu: xanh lam, vàng và đỏ. Nhà marketing trên thiết bị di động của Luber muốn kiểm tra xem mẫu màu nào mang đến nhiều lượt cài đặt hơn. Để kiểm tra, cô ấy thêm &af_sub3=blue vào liên kết phân bổ của tất cả quảng cáo màu xanh trong TẤT CẢ nguồn truyền thông không phải SRN. Cách tương tự được thực hiện với quảng cáo màu vàng và đỏ. Khi thông tin này được phân tích và xuất hiện trong các báo cáo dữ liệu thô, Linda có thể phân tích thành công của các quảng cáo có màu khác nhau và chọn quảng cáo chuyển đổi tốt nhất.

Có các giới hạn nào về tên chiến dịch?

  • Độ dài tối đa của tên chiến dịch trong URL liên kết phân bổ là 100 ký tự. Nếu vượt quá, tên chiến dịch được đổi thành: c_name_exceeded_max_length
  • Tên chiến dịch không nên bắt đầu hoặc kết thúc bằng dấu cách, vì có thể gây ra sai khác trong bảng điều khiển và báo cáo