このガイドでは、メディエーション アダプタを 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 の同意を得る方法をご覧ください。