Skip to content

post install events

Jump to bottom
Yasuyuki Kamata edited this page Apr 9, 2021 · 1 revision

*/
Tiêu đề: Chuyển tiếp các sự kiện sau cài đặt sang Unity Phân loại: 8
*/

Tích hợp điểm cuối chuyển đổi thứ cấp

Các tham số sự kiện giúp tinh chỉnh thuật toán máy học của Unity và cải thiện hiệu suất của chiến dịch. Các chiến dịch Audience Pinpointer yêu cầu dữ liệu sự kiện lượt chơi cho các chiến dịch tối ưu sự duy trì và dữ liệu sự kiện mua hàng cho các chiến dịch tối ưu doanh thu (để biết thêm thông tin, hãy xem phần Các tham số sự kiện Audience Pinpointer bắt buộc dưới đây). Triển khai lệnh gọi lại sự kiện sau cài đặt thông qua đối tác bên thứ ba của bạn.

Các tham số sự kiện Audience Pinpointer bắt buộc

Bạn phải đưa các thành phần sau vào câu hỏi về sự kiện dành cho các chiến dịch Audience Pinpointer.

Lưu ý: Mọi tham số đều phân biệt chữ.

Thành phần Tham số
URL cơ bản https://ads-secondary-conversion.unityads.unity3d.com/v1/events
Định danh người dùng Yếu tố định danh bắt buộc:

  • gamer_id={Unity Ads gamer ID of installing user}
  • ifa={iOS identifier for advertising in iOS} (bắt buộc đối với iOS; ngoài ra còn chấp nhận idfa)
  • aid={Google Play Advertising Identifier} (bắt buộc đối với Android)
Yếu tố định danh không bắt buộc:

  • android_id_md5={md5 hash of lowercase Android ID}

    • Lưu ý: Unity đề xuất chuyển tiếp ifa hoặc aid để giúp chẩn đoán sự cố tiềm ẩn với dữ liệu đến. Chuyển tiếp gamer_id là bắt buộc để chạy các chiến dịch Audience Pinpointer, ngoại trừ trường hợp người dùng theo dõi giới hạn (LAT).
Thiết lập theo dõi quảng cáo tracking_enabled={1|0} hoặc tracking_limited={1|0}
ID chiến dịch campaign_id={Unity Ads campaign ID}
Định danh Game game_id={Unity Ads Game ID} (bắt buộc; xác định vị trí trên trang chính của bảng tin quảng cáo, được liệt kê dưới tiêu đề của tựa game)

Thêm một trong những mã sau:

  • platform={ios|android}&store_id={itunes id|googleplay id}
  • platform={ios|android}&bundle_id={bundle id}
  • platform={ios|android}&project_id={Unity Project ID}
Các giá trị được chấp nhận cho iOS bao gồm ios, itunes, iOS và iTunes.

Các giá trị được chấp nhận cho Android bao gồm android, google, Android, Google, gplay và GooglePlay.
Nhãn thời gian cài đặt gốc install_ts={unix time in seconds or milliseconds}

Lưu ý: Tham số và giá trị giống nhau phải được chuyển tiếp cho Unity cùng postback thuộc tính cài đặt.
Định danh sự kiện Xác định xem sự kiện nào được người dùng kích hoạt:

event={event name}, trong đó tên sự kiện là một trong những trường hợp sau:
  • session (người dùng bắt đầu lượt chơi game; bắt buộc đối với các chiến dịch tối ưu sự duy trì)
  • purchase (người dùng mua vật phẩm qua IAP) và value={amount}&currency={currency} (cả hai đều bắt buộc đối với các chiến dịch tối ưu doanh thu. Số lượng phải chứa phần thập phân, ví dụ 1.23)
  • ad_revenue (doanh thu quảng cáo do người dùng tạo ra) và value={amount}&currency={currency}(cả hai đều bắt buộc đối với các chiến dịch tối ưu doanh thu. Số lượng phải chứa phần thập phân, ví dụ 1.23)
Chuyển đối gốc có được phân bổ không? Cho biết rằng chuyển đổi gốc của người dùng này có được phân bổ về nguồn mạng lưới này hay không:

was_conversion_attributed=1

Các tham số sự kiện không bắt buộc

Bao gồm các thành phần không bắt buộc sau đây với câu hỏi sự kiện để giúp cải thiện hiệu suất của chiến dịch.

Thành phần Tham số
Nhãn thời gian ts={unix time in seconds or milliseconds}

Khi sự kiện xảy ra. Theo cài đặt mặc định, sự kiện đã xảy ra tại (hoặc gần) thời điểm bị đẩy tới điểm cuối.
Định danh sự kiện Nếu sự kiện này không phải là một lượt chơi hoặc sự kiện mua hàng:

event={event name}, trong đó tên sự kiện là một trong những trường hợp sau:
  • registration (người dùng đã đăng ký ứng dụng)
  • spent_credits (người dùng đã sử dụng tiền ảo để mua vật phẩm trong game), cùng với value={how many credits} (không bắt buộc) và type={what type credits} (không bắt buộc)
  • invite (người dùng đã mời bạn bè chơi game)
  • share (người dùng đã chia sẻ tựa game với bạn bè)
  • level_complete (người dùng đã hoàn thành một màn chơi), cùng với value={level name} (không bắt buộc)
  • tutorial_complete (người dùng đã hoàn thành phần hướng dẫn)
  • achievement_unlocked (người dùng đã mở khóa thành tích)
  • custom (sự kiện tùy chỉnh), cùng với custom_event={custom_event_name} và value={value}&type={type} (không bắt buộc)
Chế độ kiểm tra test=1

Đây là sự kiện kiểm tra bị đẩy sang dịch vụ. Sự kiện này không tính là sự kiện thực tế từ người dùng cuối.
Đối tác theo dõi tracking_partner={tracking service name or other string to identify attribution provider}
Tên ứng dụng app_name=Game+Name
Tên đơn vị quảng cáo advertiser_name=Advertiser+Name+In+Here
Nhãn thời gian lượt xem gốc impression_ts=1234567890

Được định dạng là nhãn thời gian Unix.
Nhãn thời gian lượt nhấn gốc click_ts=1234567890

Được định dạng là nhãn thời gian Unix.
Địa chỉ IP ip=123.456.78.90
Mạng lưới quảng cáo ad_network=UnityAds
Quốc gia country=GB
Phiên bản ứng dụng app_version=1.2.3
Loại thiết bị Chuỗi mẫu thiết bị:

device_type=iPhone6,2

hoặc

device_type=samsung+GT-S7582
Phiên bản HĐH os_version=9.3.4
Ngôn ngữ language=en_US hoặc language=en

Ví dụ về sự kiện lượt chơi trên iOS

ios - https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=AE06DF78-CA5A-46C3-BD44-1D3B6AA4D6E9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=UNITY_ADS_GAME_ID&platform=ios&store_id=123456789&event=session&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3

Ví dụ về sự kiện lượt chơi trên Android

https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=UNITY_ADS_GAME_ID&platform=android&store_id=com.example.store&event=session&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3

Ví dụ về sự kiện mua hàng trên iOS

https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=AE06DF78-CA5A-46C3-BD44-1D3B6AA4D6E9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=UNITY_ADS_GAME_ID&platform=ios&store_id=123456789&event=purchase&value=1.0&currency=USD&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3

Ví dụ về sự kiện mua hàng trên Android

https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=UNITY_ADS_GAME_ID&platform=android&store_id=com.example.store&event=purchase&value=1.0&currency=USD&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3

Clone this wiki locally