LƯU Ý: Vui lòng đảm bảo rằng bạn đã cài đặt phiên bản mới nhất của TopOn Unity SDK (phiên bản TopOn_Unity_Release_Android&iOS_5.9.51 hoặc cao hơn)
Tenjin SDK có thể thu thập dữ liệu doanh thu ở cấp độ hiển thị quảng cáo từ TopOn và gửi các sự kiện doanh thu đến Tenjin. Tích hợp này sẽ gửi thông tin doanh thu cho mỗi lần hiển thị quảng cáo được phân phối từ TopOn. Dưới đây là các bước để thực hiện tích hợp:
- Cài đặt TopOn Unity SDK: https://docs.toponad.com/#/en-us/unity/download/package?id=topon-unity-sdk-integration-tool
- Khi khởi tạo SDK Tenjin, hãy đăng ký nhận TopOn Impressions:
C#
var tenjin = Tenjin.getInstance("<SDK_KEY>");
tenjin.Connect();
tenjin.SubscribeTopOnImpressions();Dưới đây là một ví dụ về việc tích hợp TopOn Banner và đăng ký nhận thông báo về các sự kiện hiển thị.
C#
public class TopOnBehavior : MonoBehaviour
{
void Start()
{
InitializeTopOn();
}
private void InitializeTopOn()
{
var tenjin = Tenjin.getInstance("<YOUR-TENJIN-SDK_KEY>");
tenjin.Connect();
tenjin.SubscribeTopOnImpressions();
AnyThinkAds.API.ATSDKAPI.setChannel("<YOUR-APP-CHANNEL>");
AnyThinkAds.API.ATSDKAPI.setSubChannel("<YOUR-APP-SUB-CHANNEL>");
AnyThinkAds.API.ATSDKAPI.setLogDebug(true);
AnyThinkAds.API.ATSDKAPI.setGDPRLevel(AnyThinkAds.API.ATSDKAPI.PERSONALIZED);
AnyThinkAds.API.ATSDKAPI.initSDK("<YOUR-APP_ID>", "<SDK_KEY>");
// Load Banner
Dictionary<string, object> jsonmap = new Dictionary<string,object>();
#if UNITY_ANDROID && !UNITY_EDITOR
AnyThinkAds.API.ATSize bannerSize = new AnyThinkAds.API.ATSize(320, 50, true);
#elif UNITY_IPHONE && !UNITY_EDITOR
AnyThinkAds.API.ATSize bannerSize = new AnyThinkAds.API.ATSize(320, 50, false);
#else
AnyThinkAds.API.ATSize bannerSize = new AnyThinkAds.API.ATSize(320, 50, false);
#endif
jsonmap.Add(AnyThinkAds.API.ATBannerAdLoadingExtra.kATBannerAdLoadingExtraBannerAdSizeStruct, bannerSize);
AnyThinkAds.API.ATBannerAd.Instance.loadBannerAd("<YOUR-PLACEMENT-BANNER-AD-ID>", jsonmap);
// Show Banner
AnyThinkAds.API.ATBannerAd.Instance.showBannerAd("<YOUR-PLACEMENT-BANNER-AD-ID>", AnyThinkAds.API.ATBannerAdLoadingExtra.kATBannerAdShowingPisitionBottom);
//Ad Impression Data Event
AnyThinkAds.API.ATInterstitialAd.Instance.client.onAdShowEvent += (sender, args) =>
{
Debug.Log($"!!! Unity got ATInterstitialAd impression data - {args}");
};
AnyThinkAds.API.ATBannerAd.Instance.client.onAdImpressEvent += (sender, args) =>
{
Debug.Log($"!!! Unity got ATBannerAd impression data - {args}");
};
AnyThinkAds.API.ATRewardedVideo.Instance.client.onAdVideoStartEvent += (sender, args) =>
{
Debug.Log($"!!! Unity got ATRewardedVideo impression data - {args}");
};
AnyThinkAds.API.ATNativeAd.Instance.client.onAdImpressEvent += (sender, args) =>
{
Debug.Log($"!!! Unity got ATNativeAd impression data - {args}");
};
}
public void GoBack()
{
// Hide banner ad
AnyThinkAds.API.ATBannerAd.Instance.hideBannerAd("<YOUR-PLACEMENT-BANNER-AD-ID>");
}- [QUAN TRỌNG] Nếu một thư viện phụ thuộc khác đã sử dụng TopOn Callbacks, các phương thức đăng ký có thể không hoạt động. Trong trường hợp này, bạn có thể sử dụng
TopOnImpressionFromJSON(string json)Phương pháp gửi thủ công từng lần hiển thị kèm theo các trường được liệt kê trong bảng dưới đây. Điều này yêu cầu Tenjin Unity SDK phiên bản 1.13.1 trở lên.
Ví dụ về dữ liệu doanh thu theo mức độ hiển thị của TopOn:
| Tham số | Có bắt buộc không? | Ví dụ |
| adsource_index | Không | 0 |
| loại_mạng_quảng_cáo | Không | Dây |
| is_header_bidding_adsource | Không | Int |
| ecpm_độ_chính_xác | Không | Dây |
| adsource_id | Không | 5656 |
| ecpm | Không | 1 |
| id_kịch_bản | Không | Dây |
| quy tắc tùy chỉnh | Không | Dây |
| kênh con | Không | testSubChannel |
| doanh thu từ nhà xuất bản | Có | 0.001 |
| tên_phần_thưởng_kịch_bản | Không | Dây |
| kênh | Không | testChannel |
| topon_định_dạng_quảng_cáo | Không | Dây |
| segment_id | Không | 0 |
| quốc gia | Không | DE |
| show_id | Không | Dây |
| số_phần_thưởng_kịch_bản | Không | 0 |
| mã_vị_trí_mạng | Không | ca-app-pub-3940256099942544%2F6300978111 |
| topon_mã_vị_trí | Không | Dây |
| ecpm_level | Không | 1 |
| thông_tin_tùy_chỉnh_người_dùng_để_tặng_phần_thưởng | Không | Dây |
| mã_công_ty_mạng | Không | 2 |
| tiền tệ | Không | USD |
| độ chính xác | Không | Dây |