踏出第一步

本指南說明如何將中介服務介面卡整合至 iOS 應用程式。

必要條件

如要整合廣告格式的中介服務，您必須先將該廣告格式整合至應用程式：

• 橫幅廣告
• 插頁式廣告
• 原生廣告
• 獎勵廣告
• 插頁式獎勵廣告

第一次使用中介服務嗎？請參閱中介服務簡介。

出價： Google Mobile Ads SDK 7.53.1 以上版本。

初始化 Google Mobile Ads SDK

快速入門指南說明如何初始化 Google Mobile Ads SDK。在該初始化呼叫期間，中介服務轉接程式也會初始化。請務必等待初始化作業完成，再載入廣告，確保每個廣告聯播網都能參與第一次廣告請求。

重要事項： 出價轉接程式需要您明確初始化 Google Mobile Ads SDK。

下列程式碼範例說明如何在發出廣告請求前，檢查每個中介服務的初始化狀態。

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

    MobileAds.shared.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: AdManagerBannerView) {
  print("Banner adapter class name: \(bannerView.responseInfo.adNetworkClassName)")
}

Objective-C

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

詳情請參閱「擷取廣告回應資訊」。

使用中介服務橫幅廣告

請務必在所有第三方廣告來源 UI 中，停用中介服務所用橫幅廣告單元的重新整理功能。這樣可避免重複重新整理，因為 Ad Manager 也會根據橫幅廣告單元的重新整理頻率觸發重新整理。

透過中介服務使用原生廣告

以下是實作原生中介服務時可參考的最佳做法。

原生廣告呈現方式政策

每個廣告聯播網都有自己的政策。使用中介服務時，請務必注意，應用程式仍須遵守提供廣告的中介服務聯播網政策。

提出要求時，請避免使用 GADMultipleAdsAdLoaderOptions 類別

要求多個原生廣告時，只會放送 Google 廣告。多個原生廣告功能不支援中介服務。

美國州級隱私權法律和 GDPR

如需遵守《美國州級隱私權法律》或《一般資料保護規則 (GDPR)》，請按照美國州級法規設定或 GDPR 設定中的步驟，在 Ad Manager「隱私權與訊息」的美國州別或 GDPR 廣告合作夥伴名單中，新增中介服務合作夥伴。否則合作夥伴可能無法在您的應用程式中放送廣告。

進一步瞭解如何使用 Google User Messaging Platform (UMP) SDK 啟用受限的資料處理模式 (RDP)，以及取得 GDPR 同意聲明。