本指南說明如何將中介服務轉接程式整合至 iOS 應用程式。
必要條件
您必須先將廣告格式整合至應用程式，才能整合該廣告格式的中介服務：
第一次使用中介服務嗎？請參閱「中介服務簡介」。
出價：Google Mobile Ads SDK 7.53.1 以上版本。
初始化 Google Mobile Ads SDK
快速入門指南會說明如何初始化 Google Mobile Ads SDK。中介服務轉接程式也會在初始化呼叫期間完成初始化。請務必等待初始化完成，再載入廣告，確保每個廣告聯播網都能完整參與首次廣告請求。
以下程式碼範例說明如何在發出廣告請求前，檢查各個轉接程式的初始化狀態。
Swift
MobileAds.shared.start { initializationStatus in
// Check each adapter's initialization status.
for (adapterName, status) in initializationStatus.adapterStatusesByClassName {
print(
"Adapter: \(adapterName), Description: \(status.description), Latency: \(status.latency)")
}
}
Objective-C
[[GADMobileAds sharedInstance]
startWithCompletionHandler:^(GADInitializationStatus *_Nonnull status) {
// Check each adapter's initialization status.
NSDictionary<NSString *, GADAdapterStatus *> *adapterStatuses =
status.adapterStatusesByClassName;
for (NSString *adapterName in adapterStatuses) {
GADAdapterStatus *adapterStatus = adapterStatuses[adapterName];
NSLog(@"Adapter: %@, Description: %@, Latency: %f", adapterName,
adapterStatus.description, adapterStatus.latency);
}
}];
瞭解勝出的廣告聯播網
每種廣告格式類別都有 GADResponseInfo 屬性，其中包含 adNetworkClassName，可傳回目前廣告的廣告聯播網類別名稱。只有在廣告成功載入後，adNetworkClassName 才會有值。以下程式碼說明如何取得橫幅廣告的這項資訊。
Swift
print(
"Adapter class name: \(ad.responseInfo?.loadedAdNetworkResponseInfo?.adNetworkClassName ?? "Unknown")"
)
Objective-C
NSLog(@"Adapter class name: %@",
ad.responseInfo.loadedAdNetworkResponseInfo.adNetworkClassName ?: @"Unknown");
詳情請參閱「擷取廣告回應資訊」。
搭配中介服務使用橫幅廣告
請務必在所有第三方廣告來源使用者介面中，停用中介服務所用橫幅廣告單元的重新整理功能。Ad Manager 也會根據橫幅廣告單元的重新整理頻率觸發重新整理，因此請務必停用，以免重複重新整理。
搭配中介服務使用原生廣告
以下是導入原生中介服務時，可參考的一些最佳做法。
- 原生廣告顯示政策
- 每個廣告聯播網都有各自的政策。使用中介服務時，請務必注意，應用程式仍須遵守中介服務聯播網的政策。
- 提出要求時，請避免使用
GADMultipleAdsAdLoaderOptions類別 - 多則原生廣告的請求只會放送 Google 廣告。多重原生廣告功能不支援中介服務。
美國州級隱私權法律和 GDPR
如果您需要遵守美國州級隱私權法律或一般資料保護規則 (GDPR)，請按照美國州級法規設定或 GDPR 設定中的步驟，在 Ad Manager「隱私權與訊息」的美國州級或 GDPR 廣告合作夥伴名單中，新增中介服務合作夥伴。否則合作夥伴可能無法在您的應用程式中放送廣告。
進一步瞭解如何啟用受限的資料處理 (RDP)，以及透過 Google User Messaging Platform (UMP) SDK 取得 GDPR 同意聲明。