s2s install tracking - unity-vn/unityads-help-vn GitHub Wiki
/*
Tiêu đề: Theo dõi lượt cài đặt từ Máy chủ tới Máy chủ (S2S)
Phân loại:
7 */
Để giúp khởi động các chiến dịch CPI trong Unity Ads, Unity cho phép các nhà phát triển gửi thông tin theo dõi lượt cài đặt thông qua tích hợp máy chủ đến máy chủ, vì vậy các ứng dụng được quảng cáo không cần cập nhật để thêm tính năng theo dõi cài đặt dành riêng cho Unity Ads. Tài liệu này giải thích cách tích hợp dịch vụ theo dõi lượt cài đặt bên thứ ba hoặc các máy chủ ứng dụng của riêng bạn để thông báo Unity Ads về các lượt cài đặt mới trong các trò chơi iOS và Android.
Cần có nhà cung cấp dịch vụ phân bổ bên thứ ba hoặc nội bộ để tiến hành các chiến dịch trong Unity Ads thật chính xác. Các liên kết sau đây sẽ giới thiệu một số nhà cung cấp phổ biến:
Adjust (Đối tác giải pháp đã xác minh của Unity)
Branch (mua lại Tune vào năm 2019)
Nếu bạn vẫn đang sử dụng dịch vụ bên ngoài để theo dõi lượt cài đặt trên điện thoại di động như Kochava (Đối tác cửa hàng sản phẩm ưu tiên của Unity), AppsFlyer, Adjust hoặc Mobile App Tracking của Tune, bạn có thể dễ dàng thiết lập các liên kết theo dõi tình trạng phân bổ trong Unity Ads để thông báo cho dịch vụ theo dõi lượt cài đặt của bạn về lượt xem (hoặc lượt nhấn), rồi thiết lập URL đăng lại của Unity Ads trong dịch vụ theo dõi lượt cài đặt của bạn để thông báo cho Unity Ads về tỷ lệ quy đổi thành lượt cài đặt.
Bảng điều khiển thu hút giúp bạn xác định URL theo dõi tùy chỉnh cho chiến dịch của bạn. URL này báo cáo danh tính của người dùng tại thời điểm phát sinh lượt xem (hoặc lượt nhấn) từ chiến dịch đến dịch vụ theo dõi lượt cài đặt của bạn. Sau đó, dịch vụ này sử dụng thông tin này để phân bổ bất kỳ lượt cài đặt nào sau đó đến mạng quảng cáo phù hợp và tạo hàm gọi lại cho mạng lưới đó bằng các thông tin người dùng thích hợp.
Hãy đảm rằng tất cả các URL theo dõi tuân theo các yêu cầu sau đây, nếu không khâu phân bổ sẽ hoạt động chính xác.
- URL và bất kỳ thao tác chuyển hướng nào cũng sử dụng HTTPS.
- URL chứa token tùy chỉnh linh hoạt
{ifa}(xem dưới đây). - Thao tác Chuyển hướng HTTP được thực thi thông qua các mã 3XX HTTP chứ không phải HTML hay JavaScript.
- URL không chuyển hướng đến Apple Store hoặc Google Play.
Nếu bạn sử dụng nhà cung cấp theo dõi không hỗ trợ HTTPS, vui lòng liên hệ với chúng tôi để được hỗ trợ.
Các token được thay thế linh hoạt sau đây có sẵn trong URL Theo dõi:
| Token | Mô tả | Ví dụ |
|---|---|---|
{ifa} (trên 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} (trên 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} (trên 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. | 1234567890ABCDEFGHIJK123456ABCDEF |
{ifa_md5} (trên Android) |
ID Quảng cáo Google được tạo băm MD5 từ dạng viết thường nguyên bản. | 1234567890ABCDEFGHIJK123456ABCDEF |
{android_id_md5} |
Android ID được tạo băm MD5 của các thiết bị Android, dưới dạng 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 = 123ABC456DEF789GHI012JKL345MNO67890
|
{ip} |
Địa chỉ IP của người dùng. 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. | 123.123.123.123 |
{country_code} |
Mã quốc gia ISO 3166-1 alpha-2 viết thường. Lưu ý: "GB" chỉ định Vương quốc Anh và Bắc Ireland. |
GB |
{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 quảng cáo (trò chơi đang được quảng cáo). | 1234567 |
{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. 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. |
9g74cAw7WM1L |
{source_game_id} |
Đã ngưng hoạt động từ ngày 11 tháng 5 năm 2020. Đây là ID Trò chơi Unity Ads của trò chơi đang hiển thị quảng cáo. ID này đã được thay thế bằng source_app_id. |
7654321 |
{os} |
Hệ điều hành của thiết bị. |
|
{device_type} |
Kiểu thiết bị. |
|
{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ị. | en-GB |
{user_agent} |
Tác nhân người dùng thiết bị. |
|
{device_make} |
Nhà sản xuất thiết bị. |
|
{device_model} |
Mẫu thiết bị. |
|
{cpi} |
Chi phí trên mỗi lượt cài đặt tính bằng USD. | 2.85 |
{video_orientation} |
Hướng màn hình của hình ảnh hiển thị trong quảng cáo. |
|
{screen_size} |
Kích thước màn hình dựa trên định hướng mục tiêu có trong Bảng điều khiển thu hút. Lưu ý: Kích thước màn hình chỉ khả dụng với các thiết bị Android. |
|
{screen_density} |
Chỉ khả dụng với các thiết bị Android. Mật độ màn hình dựa trên định hướng mục tiêu có trong Bảng điều khiển thu hút. Lưu ý: Kích thước màn hình chỉ khả dụng với các thiết bị Android. |
|
Ví dụ như URL theo dõi AppsFlyer sau đây:
https://app.appsflyer.com/id1234567890?idfa={ifa}&c={campaign_name}&af_sub2={source_app_id}&redirect=false
có thể hiển thị như sau:
https://app.appsflyer.com/id1234567890?idfa=1234ABCD-1234-5678-ABCD-1A2B3C4D5E6F&c=Unity_Android_USA_Target&af_sub2=9g74cAw7WM1L&redirect=false
Lưu ý: Mã định danh Source (source_id) đã ngưng hoạt động. Mã này đã được thay thế bằng SourceAppID (source_App_Id). Token tương ứng cũng được thay thế như trình bày trong bảng trên.
URL theo dõi có thể kích hoạt từ lượt xem (khi người dùng xem quảng cáo) hoặc lượt nhấn (khi người dùng nhấn vào liên kết tải về trong quảng cáo). Trong cả hai trường hợp, URL không nên chuyển hướng đến Apple App Store hoặc Google Play và máy chủ nên phản hồi bằng thông báo HTTP 200 OK. Unity Ads sẽ tải trang cửa hàng tương ứng trong bảng ứng dụng để tránh điều hướng người chơi ra khỏi trò chơi.
Người dùng bị thuyết phục cài đặt trò chơi quảng cáo nhờ chiến dịch sẽ được báo cáo thông qua URL Đăng lại. Bạn có thể truy xuất báo cáo này bằng yêu cầu GET HTTP.
Đối với iOS, hãy sử dụng URL sau đây:
https://postback.unityads.unity3d.com/games/[GAME_ID]/install?advertisingTrackingId=[YOUR_MACRO_FOR_IDFA]
Đối với Android, hãy sử dụng URL sau đây:
https://postback.unityads.unity3d.com/games/[GAME_ID]/install?advertisingTrackingId=[YOUR_MACRO_FOR_GOOGLE_AD_ID]
Tham số GAME_ID là ID Trò chơi Unity Ads của bạn. Bạn có thể tìm ID này bằng cách đăng nhập vào Bảng điều khiển thu hút và chọn Chiến dịch.
Lưu ý: Đối với người dùng đã tồn tại, tên miền impact.applifier.com thừa hưởng sẽ tiếp tục hoạt động song song với tên miền postback.unityads.unity3d.com. Tuy nhiên, Unity khuyên bạn nên chuyển sang phiên bản mới.
Tham số định danh sau đây phải được chuyển tiếp trong yêu cầu URL Đăng lại:
| Tham số | Mô tả | Ví dụ |
|---|---|---|
advertisingTrackingId (iOS) |
Mã định danh cho Quảng cáo (IDFA) viết in hoa. ID này là bắt buộc cho tất cả các lượt cài đặt (ở dạng nguyên bản hoặc ở dạng tạo băm MD5). | XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX |
advertisingTrackingIdMD5 (iOS) |
Mã định danh cho Quảng cáo (IDFA) ở dạng tạo băm MD5, viết thường. ID này là bắt buộc cho tất cả các lượt cài đặt (ở dạng nguyên bản hoặc ở dạng tạo băm MD5). | |
advertisingTrackingId (Android) |
ID Quảng cáo Google viết thường. ID này là bắt buộc cho tất cả các lượt cài đặt (ở dạng nguyên bản hoặc ở dạng tạo băm MD5). | XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX |
advertisingTrackingIdMD5 (Android) |
ID Quảng cáo Google ở dạng tạo băm MD5, viết thường. ID này là bắt buộc cho tất cả các lượt cài đặt (ở dạng nguyên bản hoặc ở dạng tạo băm MD5). | |
gamerId |
Mã định danh Unity Ads duy nhất được sử dụng cho 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. Mã này là bắt buộc khi phân bổ người dùng iOS có vân tay. |
58c116080dbe250047a2a398 |
rawAndroidId |
Android ID viết in thường nguyên bản. Lưu ý: Không nên sử dụng ID này vì sẽ không bắt buộc nếu thiết bị Android đã tích hợp đúng cách với Google Play Services và đã cài đặt Google Play. Tuy nhiên, ID này là bắt buộc với tất cả các lượt cài đặt không có ID Quảng cáo Google. |
|
androidId |
Android ID dưới dạng tạo băm MD5. Lưu ý: Không nên sử dụng ID này vì sẽ không bắt buộc nếu thiết bị Android đã tích hợp đúng cách với Google Play Services và đã cài đặt Google Play. Tuy nhiên, ID này là bắt buộc với tất cả các lượt cài đặt không có ID Quảng cáo Google. |
|
attributed |
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 này sẽ chỉ được đánh dấu cho người chơi đó và sẽ không được tính phí.Lưu ý: Tham số này chỉ nên dùng nếu sử dụng Truyền tín hiệu lớp phủ, khi tất cả các lượt cài đặt đều được gửi đi thay vì chỉ phân bổ. |
|
Phản hồi từ máy chủ theo dõi lượt cài đặt của Unity Ads sẽ được xuất ra dưới dạng tệp JSON. Nếu nhận được thông báo thành công, máy chủ sẽ phản hồi bằng trường status có giá trị là ok. Máy chủ cũng luôn xuất ra mã phản hồi HTTP của mình.
Phản hồi này chứa tham số "install":true nếu hàm đăng lại khởi tạo lượt quy đổi thành công thành lượt cài đặt tính phí. Nếu đây không phải lượt quy đổi hợp lệ (ví dụ như khi người dùng đã cài đặt trò chơi trước đó hoặc đã hết thời gian cân nhắc), phản hồi này có nội dung là "install":false.
Nếu trường status không hiện diện, lỗi bất kỳ có thể phát sinh sẽ có trong trường error.
Lưu ý: Mã trạng thái không xác định thao tác gọi hàm đăng lại này có thực sự được ghi nhận dưới dạng lượt cài đặt tính phí hay không. Mã này chỉ cho biết thông báo đã được nhận và xử lý thành công. Đối với lượt cài đặt tính phí, hãy sử dụng trường "install":true để thay thế.