此页面由 Cloud Translation API 翻译。

开始使用

本指南介绍了如何将中介适配器与 iOS 应用相集成。

前提条件

在为广告格式集成中介功能之前，您需要先将该广告格式集成到您的应用中：

第一次使用中介功能？阅读中介简介。

对于出价：Google 移动广告 SDK 7.53.1 或更高版本。

初始化移动广告 SDK

快速入门指南介绍了如何初始化移动广告 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);
}

有关详情，请参阅检索有关广告响应的信息。

将横幅广告与中介结合使用

对于中介中使用的横幅广告单元，请确保停用所有第三方广告来源界面中的刷新功能。这可防止重复刷新，因为 Ad Manager 还会根据横幅广告单元的刷新频率触发刷新。

结合使用原生广告和中介

以下是实现原生中介时需要考虑的一些最佳做法。

原生广告展示政策: 每个广告网络都有自己的政策。使用中介功能时请务必注意，您的应用仍需遵守提供相应广告的中介广告联盟的政策。

在发出请求时避免使用 GADMultipleAdsAdLoaderOptions 类: 针对多个原生广告的请求仅会投放 Google 广告。多原生广告功能不支持中介。

美国州级隐私保护法律和 GDPR

如果您需要遵守美国州级隐私保护法律或一般数据保护条例 (GDPR)，请按照美国州级法规设置或 GDPR 设置中的步骤，在 Ad Manager 的“隐私权和消息”工具的美国各州或 GDPR 广告合作伙伴列表中添加中介合作伙伴。否则，可能会导致合作伙伴无法在您的应用中投放广告。

详细了解如何使用 Google User Messaging Platform (UMP) SDK 启用受限的数据处理 (RDP) 并获取 GDPR 用户同意。

选择广告网络