Unity Plugin – AppLovin Max

1分で読む

Tenjin SDKはAppLovinのインプレッションレベルの収益データを受信し、収益イベントをTenjinに送信できます。この連携により、AppLovinから配信された広告インプレッションごとに収益関連データが送信されます。連携手順は以下のとおりです。

AppLovin Unity SDKをインストールしてください：https://developers.axon.ai/en/max/unity/overview/integration

最新のAppLovin Unity SDK（>AppLovin-MAX-Unity-Plugin-5.1.2-Android-11.1.2-iOS-11.1.1）がインストールされていることを確認してください。
以下のサンプルコードを使用して、収益データをTenjinに連携してください。

C#

[System.Serializable]
public class AppLovinImpressionData
{
    public string creative_id;
    public string placement;
    public string format;
    public string country;
    public string ad_revenue_currency;
    public string network_placement;
    public string revenue_precision;
    public string ad_unit_id;
    public double revenue;
    public string network_name;
}

// Attach callbacks based on the ad format(s) you are using
MaxSdkCallbacks.Interstitial.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.Rewarded.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.Banner.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.MRec.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;

private void OnAdRevenuePaidEvent(string adUnitId, MaxSdk.AdInfo adInfo)
{
    // Create impression data object for serialization
    var impressionData = new AppLovinImpressionData
    {
        creative_id = adInfo.CreativeIdentifier ?? "",
        placement = adInfo.Placement ?? "",
        format = adInfo.AdFormat ?? "",
        country = MaxSdk.GetSdkConfiguration().CountryCode ?? "",
        ad_revenue_currency = "USD",
        network_placement = adInfo.NetworkPlacement ?? "",
        revenue_precision = adInfo.RevenuePrecision ?? "",
        ad_unit_id = adInfo.AdUnitIdentifier ?? "",
        revenue = adInfo.Revenue,
        network_name = adInfo.NetworkName ?? ""
    };

    // Convert to JSON string using JsonUtility
    string jsonString = JsonUtility.ToJson(impressionData);

    // Send to Tenjin
    Tenjin.getInstance("<SDK_KEY>").AppLovinImpressionFromJSON(jsonString);
}

[System.Serializable]
public class AppLovinImpressionData
{
    public string creative_id;
    public string placement;
    public string format;
    public string country;
    public string ad_revenue_currency;
    public string network_placement;
    public string revenue_precision;
    public string ad_unit_id;
    public double revenue;
    public string network_name;
}

// Attach Callbacks based on the ad format(s) you are using
MaxSdkCallbacks.Interstitial.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.Rewarded.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.Banner.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.MRec.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;

private void OnAdRevenuePaidEvent(string adUnitId, MaxSdk.AdInfo adInfo)
{
    // Create impression data object for serialization
    var impressionData = new AppLovinImpressionData
    {
        creative_id = adInfo.CreativeIdentifier ?? "",
        placement = adInfo.Placement ?? "",
        format = adInfo.AdFormat ?? "",
        country = MaxSdk.GetSdkConfiguration().CountryCode ?? "",
        ad_revenue_currency = "USD",
        network_placement = adInfo.NetworkPlacement ?? "",
        revenue_precision = adInfo.RevenuePrecision ?? "",
        ad_unit_id = adInfo.AdUnitIdentifier ?? "",
        revenue = adInfo.Revenue,
        network_name = adInfo.NetworkName ?? ""
    };

    // Convert to JSON string using JsonUtility
    string jsonString = JsonUtility.ToJson(impressionData);

    // Send to Tenjin
    Tenjin.getInstance("<SDK_KEY>").AppLovinImpressionFromJSON(jsonString);
}

以下は、AppLovin MAXからのインプレッションレベルの収益データ入力例です。revenueパラメータには、string型ではなく、double型を使用してください。

パラメータ	必須?	例
creative_id	いいえ	2813803997
placement	いいえ	placementBanner
format	いいえ	BANNER
country	いいえ	DE
ad_revenue_currency	いいえ	USD
network_placement	いいえ	banner_regular
revenue_precision	いいえ	exact
ad_unit_id	いいえ	a7d1aa174c93c716
revenue	はい	4.7455200000000006E-5
network_name	はい	APPLOVIN_EXCHANGE

reference: https://developers.axon.ai/en/max/unity/overview/advanced-settings/#impression-level-user-revenue-API

あなたの気持ちは？