Tham chiếu tham số liên kết phân bổ

Read time 6 minutes

Liên kết phân bổ cho phép bạn chuyển tiếp dữ liệu tương tác từ máy chủ của ứng dụng đến các chiến dịch Unit Ads User Acquisition. Tham khảo các yêu cầu sau đây dành cho các liên kết theo dõi phân bổ này.

Để biết hướng dẫn về cách lấy liên kết phân bổ, hãy tham khảo tài liệu Tích hợp đối tác cho đối tác bạn ưa thích hoặc tài liệu Tích hợp tùy chỉnh.

Yêu cầu về URL
Yêu cầu về URL

Đảm bảo rằng các liên kết theo dõi phân bổ của bạn đáp ứng các yêu cầu sau:

  • Sử dụng HTTPS cho URL và chuyển hướng.
  • Bao gồm {ifa} mã thông báo tùy chỉnh linh hoạt. Tham khảo Mã thông báo tùy chỉnh linh hoạt dưới đây để biết thêm thông tin.
  • Sử dụng mã chuyển hướng HTTP 3XX. Không sử dụng chuyển hướng HTML hoặc JavaScript.
  • Không chuyển hướng URL đến Apple App Store hoặc Google Play Store.

Nếu MMP của bạn không hỗ trợ HTTPS, hãy liên hệ với Unity để được hỗ trợ.

Mã thông báo URL tùy chỉnh linh hoạt
Mã thông báo URL tùy chỉnh linh hoạt

Unity hỗ trợ các mã thông báo được thay thế linh hoạt sau đây trong các URL theo dõi phân bổ:

Mã thông báoMô tảVí dụLưu ý

{ifa} (iOS)

Mã định danh cho Quảng cáo (IDFA) của iOS dưới dạng văn bản thuần túy và ở dạng viết in hoa nguyên bản.
1234ABCD-1234-5678-ABCD-1A2B3C4D5E6F

{ifa} (Android)

ID Quảng cáo Google ở dạng viết thường nguyên bản. ID này sẽ thay thế Android ID với tư cách là phương thức định danh chính trên Android. Trong giai đoạn chuyển đổi, cả hai loại mã định danh đều cần phải chạy song song.

1234abcd-1234-5678-abcd-1a2b3c4d5e6f

{ifa_md5} (iOS)

Mã định danh cho Quảng cáo (IDFA) của iOS được tạo băm MD5 từ dạng viết in hoa nguyên bản.
9dd6df49d764d6ada0b250a6376d7b44

{ifa_md5} (Android)

ID Quảng cáo Google được tạo băm MD5 từ dạng viết thường nguyên bản.

9a6a0a84bd8003a97a2109f6c4
{android_id_md5}

Android ID được tạo băm MD5 của các thiết bị Android, dưới dạng tạo băm MD5. Cách này chỉ nên sử dụng khi ID Quảng cáo Google {ifa} không khả dụng, chẳng hạn như trường hợp Google Play Services không được cài đặt trên thiết bị Android.

MD5 12345678ABCDEFGH = 5756ae9022b2ea1e47d84fead75220c8

{mmp}
Tên Đối tác đo lường di động của bạn.
  • appsflyer
  • adjust
  • branch
  • tenjin
  • singular
{platform}
Nền tảng diễn ra lượt cài đặt.
  • ios
  • android
{ip}
Địa chỉ IP của người dùng cuối.
123.123.123.123
Thông tin này chỉ được cung cấp nhằm mục đích tham khảo và không phù hợp cho việc định danh người dùng trong quá trình theo dõi lượt cài đặt.
{organic}

Cờ biểu thị lượt cài đặt này có được phân bổ cho lưu lượng truy cập tự nhiên hay không. Tham khảo các giá trị sau đây cho cờ:

  • organic=1 cho biết lượt cài đặt này không được phân bổ cho bất kỳ quảng cáo nào từ bất kỳ mạng quảng cáo nào, Unity Ads hay mạng nào khác.
  • organic=0 cho biết lượt cài đặt này được phân bổ cho một mạng quảng cáo.

  • organic=1 (đúng)
  • organic=0 (sai)
{country_code}
Mã quốc gia ISO 3166-1 alpha-2 của người dùng viết thường.
GB

GB chỉ định Vương quốc Anh và Bắc Ireland.

{campaign_id}
ID chiến dịch Unity Ads.
12345678abcdefgh9012ijkl
{campaign_name}
Tên chiến dịch Unity Ads.
my_ad_campaign
{game_id}
ID Trò chơi Unity Ads của trò chơi được quảng cáo.
1234567
{gamer_id}

Mã định danh Unity Ads duy nhất là bắt buộc đối với người dùng đang phân bổ có bật chế độ Theo dõi Quảng cáo Giới hạn (LAT), trong đó giá trị của mã định danh quảng cáo là 00000000-0000-0000-0000-000000000000. Nếu không tìm thấy ID người chơi trong trường hợp này, bạn sẽ thấy lỗi sai định dạng, mã phản hồi 400.

Malformed hoặc missing input data

{source_app_id}
Mã định danh nguồn phổ thông của ứng dụng đang hiển thị quảng cáo. Chuỗi gồm chữ và số có phân biệt viết hoa, viết thường.
9g74cAw7WM1L

Trước khi chuyển đổi vào tháng 5 năm 2020, chuỗi này được trình bày bằng source_game_id.

{source_game_id}

Trường này không còn được dùng nữa kể từ tháng 5 năm 2020.

Mã thông báo {source_app_id} thay thế {source_game_id}.

7654321

{source_app_id} thay thế mã thông báo này.

{os}
Hệ điều hành của thiết bị của người dùng cuối.
  • 9.2.1 (iOS)
  • 4.4.0 (Android)
{device_type}
Loại thiết bị của người dùng cuối.
  • iPad4,1
  • motorola XT1254
  • samsung SM-G900F
{creative_pack}
Tên của gói quảng cáo được sử dụng trong quảng cáo.
Video Creatives Pack - EN - 15s
{creative_pack_id}
Mã định danh duy nhất của gói quảng cáo được sử dụng trong quảng cáo.
5beafbce74ed83001acb258c
{language}
Ngôn ngữ thiết bị của người dùng cuối.
en-GB
{user_agent}
Tác nhân người dùng thiết bị của người dùng cuối.
  • Mozilla/5.0 (iPhone; CPU iPhone OS 9_3_5 như Mac OS X)
  • AppleWebKit/601.1.46 (KHTML như Gecko)
  • Mobile/13G36 (iOS)
  • Mozilla/5.0 (Linux; Android 6.0.1; SM-G920V Build/MMB29K)
  • AppleWebKit/537.36 (KHTML như Gecko)
  • Chrome/52.0.2743.98 Mobile Safari/537.36 (Android)
{device_make}
Nhà sản xuất thiết bị của người dùng cuối.
  • Apple (iOS)
  • samsung (Android)
{device_model}
Mẫu thiết bị của người dùng cuối.
  • iPhone7,2 (iOS)
  • SM-G900F (Android)
{is_skadnetwork_supported}

Trạng thái hỗ trợ SKAdNetwork.

true hoặc trống.

Trường này chỉ khả dụng cho các thiết bị iOS.
{video_orientation}
Hướng của mẩu quảng cáo hiển thị trong quảng cáo.
  • portrait
  • landscape
{screen_size}

Kích thước màn hình dựa trên nhắm mục tiêu theo thiết bị.

  • small
  • normal
  • large
  • xlarge
Trường này chỉ khả dụng cho các thiết bị Android.
{screen_density}

Mật độ điểm ảnh màn hình dựa trên nhắm mục tiêu theo thiết bị.

  • ldpi
  • mdpi
  • hdpi
  • xhdpi
  • xxhdpi
  • xxxhdpi
Trường này chỉ khả dụng cho các thiết bị Android.