このページは Cloud Translation API によって翻訳されました。

インプレッション単位の広告収益

インプレッションが発生すると、Google Mobile Ads SDK から広告収入データが提供されます。関連付けられますこのデータを使用してダウンストリームの別の関連システムにデータを転送できます。

このガイドは、インプレッション単位の広告収入の実装に役立つガイドです。必要があります。

前提条件

インプレッション単位の広告収入が有効になっていることを確認する機能をご覧ください。
Unity プラグイン 5.0.0 以降。
スタートガイドの手順を踏みます。Unity アプリでは、 Google Mobile Ads Unity プラグインがインポート済みであること。
インプレッション単位の広告収益データを受け取るには、以下を行う必要があります。広告フォーマットを 1 つ以上導入する:

有料イベントハンドラの実装

各広告フォーマットには OnPaidEvent イベントがあります。広告イベントのライフサイクルでは Google Mobile Ads SDK がインプレッションイベントを監視し、獲得できます

次のコードは、リワード広告の有料イベントを処理する方法を示しています。

RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

落札した広告ソースについて詳しくは、情報の取得に関するページ広告レスポンスについて

App Attribution Partner（AAP）との統合

広告収益データを分析プラットフォームに転送する方法について詳しくは、パートナーのガイドを参照してください。

パートナー SDK
調整
AppsFlyer
単数形
天神

実装に関するベストプラクティス

次のイベントを作成または取得したら、すぐに OnPaidEvent イベントを設定します。必ず広告を表示する前にオブジェクトを返す必要がありますこれによりコールバックを逃す可能性があります。
ご希望のアナリティクスにインプレッション単位の広告収益情報を送信する OnPaidEvent ハンドラで呼び出します。これによりデータの不一致を回避できます

AdValue

AdValue は、広告で得られる金銭的価値を表すクラスです。値の通貨コードと、次のようにエンコードされた精度型を含む。

`AdValue.PrecisionType`	説明
`Unknown`	不明な広告の値。これは LTV Pingback が十分なデータがありません。
`Estimated`	集計データから推定された広告の価値。
`PublisherProvided`	パブリッシャー指定の広告値（メディエーショングループの手動 CPM など）。
`Precise`	この広告の正確な値。

メディエーションの場合、AdMob は最適化された広告ソースの ESTIMATED 値を提供しようとします。最適化されていない広告ソースの場合、または有意な推定値をレポートするのに十分な集計データがない場合は、PUBLISHER_PROVIDED 値が返されます。