注記: 最新のTopOn Unity SDK(バージョンTopOn_Unity_Release_Android&iOS_5.9.51以降)がインストールされていることを確認してください。
Tenjin SDKは、TopOnのインプレッションレベルの収益データを取得し、収益イベントをTenjinに送信することができます。この連携により、TopOnから配信された各広告インプレッションの収益情報が送信されます。連携の手順は以下の通りです:
- TopOn Unity SDKをインストールします: https://docs.toponad.com/#/en-us/unity/download/package?id=topon-unity-sdk-integration-tool
- Tenjin SDKを初期化する際、TopOn Impressionsをサブスクライブしてください:
C#
var tenjin = Tenjin.getInstance("<SDK_KEY>");
tenjin.Connect();
tenjin.SubscribeTopOnImpressions();以下は、TopOn Bannerの統合およびインプレッションイベントの購読の例です。.
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>");
}- 【重要】別の依存関係がすでにTopOnのコールバックを使っている場合、subscribeメソッドが動作しないことがあります。その場合は、
TopOnImpressionFromJSON(string json)メソッドを使い、下表のフィールドを付けて各インプレッションを手動で送信できます。Tenjin Unity SDK v1.13.1以上が必要です。
TopOnのインプレッションベースの収益データの例:
| パラメータ | 必須? | 例 |
| adsource_index | いいえ | 0 |
| ad_network_type | いいえ | String |
| is_header_bidding_adsource | いいえ | Int |
| ecpm_precision | いいえ | String |
| adsource_id | いいえ | 5656 |
| ecpm | いいえ | 1 |
| scenario_id | いいえ | String |
| custom_rule | いいえ | String |
| sub_channel | いいえ | testSubChannel |
| publisher_revenue | はい | 0.001 |
| scenario_reward_name | いいえ | String |
| channel | いいえ | testChannel |
| topon_ad_format | いいえ | String |
| segment_id | いいえ | 0 |
| country | いいえ | DE |
| show_id | いいえ | String |
| scenario_reward_number | いいえ | 0 |
| network_placement_id | いいえ | ca-app-pub-3940256099942544%2F6300978111 |
| topon_placement_id | いいえ | String |
| ecpm_level | いいえ | 1 |
| reward_user_custom_data | いいえ | String |
| network_firm_id | いいえ | 2 |
| currency | いいえ | USD |
| precision | いいえ | String |