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

概要

このガイドでは、メディエーションアダプタを iOS アプリに統合する方法について説明します。

前提条件

広告フォーマットにメディエーションを統合するには、その広告フォーマットをあらかじめアプリに組み込んでおく必要があります。

メディエーションを初めてご利用の場合は、メディエーションの概要を読む。

入札の場合: Google Mobile Ads SDK 7.53.1 以降。

Mobile Ads SDK を初期化する

クイックスタートガイドでは、Mobile Ads SDK を初期化する方法を説明します。この初期化の呼び出し中に、メディエーションアダプタも初期化されます。最初の広告リクエストにすべての広告ネットワークが参加できるようにするため、広告を読み込むのは初期化が完了するまで待ってからにしてください。

次のサンプルコードは、広告リクエストを行う前に各アダプタの初期化状況を確認する方法を示しています。

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    let ads = GADMobileAds.sharedInstance()
    ads.start { status in
      // Optional: Log each adapter's initialization latency.
      let adapterStatuses = status.adapterStatusesByClassName
      for adapter in adapterStatuses {
        let adapterStatus = adapter.value
        NSLog("Adapter Name: %@, Description: %@, Latency: %f", adapter.key,
        adapterStatus.description, adapterStatus.latency)
      }

      // Start loading ads here...
    }

    return true
  }

}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  GADMobileAds *ads = [GADMobileAds sharedInstance];
  [ads startWithCompletionHandler:^(GADInitializationStatus *status) {
    // Optional: Log each adapter's initialization latency.
    NSDictionary *adapterStatuses = [status adapterStatusesByClassName];
    for (NSString *adapter in adapterStatuses) {
      GADAdapterStatus *adapterStatus = adapterStatuses[adapter];
      NSLog(@"Adapter Name: %@, Description: %@, Latency: %f", adapter,
            adapterStatus.description, adapterStatus.latency);
    }

    // Start loading ads here...
  }];
  return YES;
}

@end

どの広告ネットワークが落札したかを確認する

各広告フォーマットクラスには、GADResponseInfo プロパティがあり、そこには adNetworkClassName が含まれています。これは、現在の広告の広告ネットワークのクラス名を返します。adNetworkClassName に値が設定されるのは、広告が正常に読み込まれた後です。次のコードは、バナー広告の情報を取得する方法を示しています。

Swift

func adViewDidReceiveAd(_ bannerView: GAMBannerView) {
  print("Banner adapter class name: \(bannerView.responseInfo.adNetworkClassName)")
}

Objective-C

- (void)adViewDidReceiveAd:(GAMBannerView *)bannerView {
  NSLog(@"Banner adapter class name: %@", bannerView.responseInfo.adNetworkClassName);
}

詳しくは、広告レスポンスに関する情報の取得をご覧ください。

メディエーションとバナー広告を使用する

メディエーションで使用しているバナー広告ユニットについては、すべての第三者広告ソースの管理画面で更新を無効にしてください。これにより、更新の重複を防ぐことができます。アドマネージャーでもバナー広告ユニットの更新頻度に基づいて更新が行われるためです。

メディエーションとネイティブ広告を使用する

ネイティブメディエーションを実装する際のおすすめの方法は次のとおりです。

ネイティブ広告プレゼンテーションポリシー: 各広告ネットワークには独自のポリシーがあります。メディエーションを使用する場合は、広告を提供したメディエーション対象ネットワークのポリシーにアプリが準拠している必要があります。

リクエストの際は GADMultipleAdsAdLoaderOptions クラスを使用しない: 複数のネイティブ広告をリクエストすると、Google 広告のみが配信されます。複数のネイティブ広告機能では、メディエーションはサポートされていません。

米国のプライバシー関連州法と GDPR

米国のプライバシー関連州法または一般データ保護規則（GDPR）に準拠する必要がある場合は、米国の州の規制の設定またはGDPR の設定の手順に沿って、アドマネージャーの [プライバシーとメッセージ] の米国の州または GDPR の広告パートナーリストにメディエーションパートナーを追加してください。追加しない場合、アプリに広告が配信されないことがあります。

詳しくは、Google User Messaging Platform（UMP）SDK で制限付きデータ処理（RDP）を有効にして GDPR の同意を得る方法をご覧ください。

ネットワークの選択