本指南說明如何將中介服務介面卡整合至 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");
詳情請參閱「擷取廣告回應資訊」。
使用中介服務橫幅廣告
請務必在所有第三方廣告來源 UI 中，停用中介服務使用的橫幅廣告單元重新整理功能。這樣可避免重複重新整理，因為 Ad Manager 也會根據橫幅廣告單元的重新整理頻率觸發重新整理。
透過中介服務使用原生廣告
以下是實作原生中介服務時可參考的最佳做法。
- 原生廣告呈現方式政策
- 每個廣告聯播網都有自己的政策。使用中介服務時，請務必注意，應用程式仍須遵守提供廣告的中介服務聯播網政策。
- 提出要求時，請避免使用
GADMultipleAdsAdLoaderOptions類別 - 如果要求多個原生廣告，系統只會放送 Google 廣告。多個原生廣告功能不支援中介服務。
美國州級隱私權法律和 GDPR
如需遵守《美國州級隱私權法》或《一般資料保護規則 (GDPR)》，請按照「美國州級法規設定」或「GDPR 設定」中的步驟，在 Ad Manager「隱私權與訊息」的美國州級或 GDPR 廣告合作夥伴清單中，加入中介服務合作夥伴。否則合作夥伴可能無法在您的應用程式中放送廣告。
進一步瞭解如何使用 Google User Messaging Platform (UMP) SDK 啟用受限的資料處理模式 (RDP)，以及取得 GDPR 同意聲明。