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