Gửi liên kết phân bổ với tích hợp tùy chỉnh

Read time 3 minutes

Để chuyển tiếp dữ liệu lượt cài đặt đến Unity bằng tích hợp máy chủ đến máy chủ tùy chỉnh, hãy sử dụng yêu cầu máy chủ để tạo liên kết theo dõi phân bổ. Tham khảo bài viết này để biết các yêu cầu GET mà bạn có thể sử dụng để gửi liên kết phân bổ đến Unity.

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

Để gửi dữ liệu lượt cài đặt đến Unity, bạn phải thêm ít nhất một ứng dụng vào bảng điều khiển Unity Ads User Acquisition

Gửi liên kết với yêu cầu postback
Gửi liên kết với yêu cầu postback

Sử dụng các yêu cầu HTTP GET sau để gửi postback lượt cài đặt đến Unity. Tham khảo bảng Tham chiếu yêu cầu postback tích hợp tùy chỉnh để đảm bảo bạn cung cấp các tham số bắt buộc.

iOS
iOS

Sử dụng URL yêu cầu postback sau đây để gửi postback iOS:

https://postback.unityads.unity3d.com/games/[GAME_ID]/install?advertisingTrackingId=[YOUR_MACRO_FOR_IDFA]&gamerId=[unity_gamer_id]&attributed=[attributed]

Android
Android

Sử dụng URL yêu cầu postback sau đây để gửi postback Android:

https://postback.unityads.unity3d.com/games/[GAME_ID]/install?advertisingTrackingId=[YOUR_MACRO_FOR_GOOGLE_AD_ID]&gamerId=[GAMER_ID]&attributed=[ATTRIBUTED]

Xem các tham số postback sau để đảm bảo yêu cầu postback Android của bạn được định dạng chính xác:

Tên tham sốYêu cầuĐịnh dạngMô tảLưu ý
GAME_ID
Bắt buộcChuỗi

ID trò chơi Unity Ads của bạn.

Bạn có thể tìm thấy ID trò chơi ở đầu trang Campaigns cho ứng dụng bạn đã chọn trong bảng điều khiển User Acquisition.

GAMER_ID
Không bắt buộcChuỗi

Mã định danh Unity Ads duy nhất bắt buộc để phân bổ người dùng đã bật tính năng Theo dõi quảng cáo giới hạn (LAT).

Bạn có thể tìm giá trị tham số gamer_id từ lượt bắt đầu, lượt xem hoặc lượt nhấp được gửi để phân bổ.

Tham số GAMER_ID này là bắt buộc để phân bổ lượt cài đặt thành công.

Đối với các lượt cài đặt không được phân bổ, tham số này là không bắt buộc.

ATTRIBUTED
Không bắt buộc

Số nguyên (0 hoặc 1)

Cờ cho biết lượt cài đặt này có được phân bổ cho Unity Ads và có thể tính phí hay không.

Giá trị mặc định (attributed=1) biểu thị điều kiện là đúng. Nếu điều kiện là sai (attributed=0), lượt cài đặt sẽ không được phân bổ và sẽ không bị tính phí.

Định dạng URL
Định dạng URL

Để đảm bảo việc phân bổ hoạt động chính xác, hãy đảm bảo bạn đã định dạng liên kết theo các yêu cầu sau:

  • Sử dụng HTTPS cho URL và mọi chuyển hướng.
  • Bao gồm {ifa} mã thông báo tùy chỉnh linh hoạt. Tham khảo tài liệu Mã thông báo tùy chỉnh linh hoạt để xem các mã thông báo được hỗ trợ.
  • 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.

Khi bạn lưu liên kết phân bổ, bảng điều khiển sẽ kiểm tra lỗi để xác thực rằng URL đã đúng cú pháp.