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

インプレッションが発生すると、Google Mobile Ads SDK は関連する収益データを含む有料イベント ハンドラを呼び出します。このハンドラを実装すると、データを使用してユーザーのライフタイム バリュー（LTV）を計算したり、データをダウンストリームの他の関連システムに転送したりできます。

このガイドでは、iOS アプリでの LTV データ キャプチャの実装について説明します。

前提条件

• AdMob の管理画面でインプレッション単位の広告収益機能を有効にしていること。

• Google Mobile Ads SDK 9.10.0 以降をインポートしていること。
• スタートガイドの手順を完了していること。

• インプレッション単位の広告収益を受信するために、以下の広告フォーマットを少なくとも 1 つ実装していること。

  • バナー
  • インタースティシャル
  • リワード
  • リワード インタースティシャル
  • ネイティブ

有料イベント ハンドラを実装する

各広告フォーマットには、GADPaidEventHandler 型の paidEventHandler プロパティがあります。Google Mobile Ads SDK は広告イベントのライフサイクル全体でインプレッション イベントを監視しており、インプレッションが発生すると、得られた収益の値とともにハンドラを呼び出します。

Swift

class ViewController: UIViewController, GADFullScreenContentDelegate {
  var rewardedAd: GADRewardedAd?
  func requestRewardedAd() {
    GADRewardedAd.load(
      withAdUnitID: "AD_UNIT_ID", request: GADRequest()
    ) { (ad, error) in
      if let error = error {
        print("Rewarded ad failed to load with error: \(error.localizedDescription)")
        return
      }
      if let ad = ad {
        self.rewardedAd = ad
        self.rewardedAd?.paidEventHandler = { adValue in
          // TODO: Send the impression-level ad revenue information to your preferred analytics
          // server directly within this callback.

          // Extract the impression-level ad revenue data.
          let value = adValue.value
          let precision = adValue.precision
          let currencyCode = adValue.currencyCode

          // Get the ad unit ID.
          let adUnitId = ad.adUnitID

          let responseInfo = ad.responseInfo
          let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo
          let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
          let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
          let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
          let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
          let mediationGroupName = responseInfo?.extrasDictionary["mediation_group_name"]
          let mediationABTestName = responseInfo?.extrasDictionary["mediation_ab_test_name"]
          let mediationABTestVariant = responseInfo?.extrasDictionary["mediation_ab_test_variant"]
        }
      }
    }
  }
}

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()
@property(nonatomic, strong) GADRewardedAd *rewardedAd;
@end

@implementation ViewController
- (void)requestRewardedAd {
  __weak ViewController *weakSelf = self;

  GADRequest *request = [GADRequest request];
  [GADRewardedAd
   loadWithAdUnitID:@"AD_UNIT_ID"
   request:request
   completionHandler:^(GADRewardedAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
      return;
    }
    self.rewardedAd = ad;
    self.rewardedAd.paidEventHandler = ^void(GADAdValue *_Nonnull value){
      ViewController *strongSelf = weakSelf;
      // TODO: Send the impression-level ad revenue information to your preferred analytics
      // server directly within this callback.

      // Extract the impression-level ad revenue data.
      NSDecimalNumber *value; = value.value;
      NSString *currencyCode = value.currencyCode;
      GADAdValuePrecision precision = value.precision;

      // Get the ad unit ID.
      NSString *adUnitId = strongSelf.rewardedAd.adUnitID;

      GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo =
          strongSelf.rewardedAd.responseInfo.loadedAdNetworkResponseInfo;
      NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
      NSString *adSourceID = loadedAdNetworkResponseInfo.adSourceID;
      NSString *adSourceInstanceName = loadedAdNetworkResponseInfo.adSourceInstanceName;
      NSString *adSourceInstanceID = loadedAdNetworkResponseInfo.adSourceInstanceID;
      NSDictionary<NSString *, id> *extras = strongSelf.rewardedAd.responseInfo.extrasDictionary;
      NSString *mediationGroupName = extras["mediation_group_name"];
      NSString *mediationABTestName = extras["mediation_ab_test_name"];
      NSString *mediationABTestVariant = extras["mediation_ab_test_variant"];
    };
  ]};
}

キーポイント: adNetworkClassName() ではなく adSourceName() を使用して、広告を読み込んだ広告ソースを特定することをおすすめします。

広告枠を落札した広告ソースについてさらに詳しい情報が必要な場合は、広告レスポンスに関する情報を取得するをご覧ください。

App Attribution Partner（AAP）と統合する

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

パートナー SDK
調整
AppsFlyer
単数形
Tenjin

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

• 広告オブジェクトを作成または取得したら、広告を表示する前に、すぐにハンドラを設定します。これにより、有料イベントのコールバックを逃すことがなくなります。
• paidEventHandler メソッドが呼び出されたらすぐに、ご希望の分析サーバーに有料イベント情報を送信します。誤ってコールバックを逃すことを防ぎ、データ不一致の発生を回避できます。

GADAdValue

GADAdValue は、広告で得られた金銭的価値を表すクラスで、その金銭的価値の通貨コードと、以下に示すエンコードされた精度タイプが含まれます。

ポイント: GADAdValue.value の値は、各広告の価値を表す 10 進数です。たとえば値が 0.5 の場合、その広告の価値は 0.5 円と見積もられています。

GADAdValuePrecision	説明
GADAdValuePrecisionUnknown	広告の価値が不明。LTV Pingback が有効になっているものの、十分なデータがない場合に返されます。
GADAdValuePrecisionEstimated	集計データから推定された広告の価値。
GADAdValuePrecisionPublisherProvided	パブリッシャーが指定した広告の価値（メディエーション グループ内の手動 CPM など）。
GADAdValuePrecisionPrecise	広告に支払われた正確な金額。

ポイント: メディエーションの場合、AdMob は最初に GADAdValuePrecisionEstimated の提供を試みますが、意味のある値を報告するのに十分な集計データがない場合は GADAdValuePrecisionPublisherProvided にフォールバックします。

入札広告ソースのインプレッションをテストする

テスト リクエストを介して入札広告ソースのインプレッション単位の広告収益イベントが発生すると、次の値のみが返されます。

• GADAdValuePrecisionUnknown: 精度タイプを示します。

• 0: 広告の価値を示します。

以前は、精度タイプが GADAdValuePrecisionUnknown 以外の値で、広告値が 0 より大きい場合がありました。

テスト広告リクエストの送信の詳細については、テストデバイスを有効にするをご覧ください。