本指南說明如何使用 Google Mobile Ads SDK,透過 AdMob Mediation 載入及顯示 DT Exchange 廣告,並涵蓋瀑布流程整合。這篇文章將說明如何將 DT Exchange 新增至廣告單元的中介服務設定,以及如何將 DT Exchange SDK 和轉接程式整合至 iOS 應用程式。
支援的整合和廣告格式
DT Exchange 的仲介轉接器具有下列功能:
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
原生 |
需求條件
- iOS 部署目標為 12.0 以上版本
最新版 Google Mobile Ads SDK
完成中介服務入門指南
步驟 1:在 DT Exchange UI 中設定
新增應用程式和廣告刊登位置
按一下「新增應用程式」按鈕,即可新增應用程式。
選取平台、填妥表單的其餘部分,然後按一下「新增刊登位置」。
在「請為刊登位置命名」欄位中輸入新刊登位置的名稱,然後從下拉式清單中選取所需的「刊登位置類型」。最後,按一下「儲存刊登位置」。
應用程式 ID 和刊登位置 ID
將滑鼠游標懸停在左側導覽列上,即可開啟該列。接著,按一下左選單中的「應用程式」。
在「App Management」頁面中,記下應用程式旁邊的「App ID」。
選取應用程式,前往「刊登位置」分頁,然後按一下「刊登位置名稱」旁的複製圖示。記下刊登位置 ID。
發布商 ID、用戶端金鑰和用戶端密鑰
在左選單中按一下使用者名稱,然後選取「使用者個人資料」。
請記下「發布商 ID」、「消費者金鑰」和「消費者密鑰」,因為下一個步驟會用到這些資訊。
步驟 2:在 AdMob UI 中設定 DT Exchange 需求
設定廣告單元的中介服務設定
您必須將 DT Exchange 新增至廣告單元的中介服務設定。
首先,請登入 AdMob 帳戶。接著,前往「Mediation」分頁。如果您有要修改的現有中介服務群組,請按一下該中介服務群組的名稱進行編輯,然後跳到「將 DT Exchange 新增為廣告來源」一節。
如要建立新的中介服務群組,請選取「建立中介服務群組」。
輸入廣告格式和平台,然後按一下「繼續」。
為中介服務群組命名,並選取指定地區。接著,將中介服務群組狀態設為「已啟用」,然後按一下「新增廣告單元」。
將這個中介服務群組與一或多個現有的 AdMob 廣告單元建立關聯。接著點選「完成」。
您現在應該會看到廣告單元資訊卡,其中顯示您選取的廣告單元:
新增 DT Exchange 做為廣告來源
在「廣告來源」部分的「刊登序列」資訊卡下方,選取「新增廣告來源」。然後選取「DT Exchange」。
選取「DT Exchange」,然後啟用「最佳化」切換鈕。輸入先前章節取得的發布商 ID、消費端密碼和消費端金鑰,即可為 DT Exchange 設定廣告來源最佳化。接著,請輸入 DT Exchange 的有效千次曝光出價,然後按一下「繼續」。
如果您已為 DT Exchange 建立對應項目,可以選取該項目。否則請按一下「新增對應」。
接著,請輸入上一節取得的應用程式 ID 和刊登位置 ID。然後按一下「完成」。
將 DT Exchange (Fyber Monetization) 新增至 GDPR 和美國州級法規廣告合作夥伴名單
請按照 GDPR 設定和美國州級法規設定中的步驟操作,將 DT Exchange (Fyber Monetization) 新增至 AdMob 使用者介面中的 GDPR 和美國州級法規廣告合作夥伴名單。
步驟 3:匯入 DT Exchange SDK 和轉接程式
使用 CocoaPods (建議做法)
在專案的 Podfile 中加入以下行:
pod 'GoogleMobileAdsMediationFyber'
在指令列中執行:
pod install --repo-update
手動整合
- 下載最新版的 DT Exchange SDK for iOS,並將下列架構連結至專案:
IASDKCore.framework
IASDKMRAID.framework
IASDKVideo.framework
- 請從「Changelog」中的下載連結,以及專案中的連結
FyberAdapter.framework
下載最新版的 DT Exchange 轉接器。 - 將下列架構新增至專案:
libxml2.2.tbd
步驟 4:在 DT Exchange SDK 上實作隱私權設定
歐盟同意聲明和 GDPR
根據 Google 的《歐盟地區使用者同意授權政策》,您必須確保向歐洲經濟區 (EEA) 境內的使用者揭露特定資訊,並徵得使用者同意聲明,才能使用裝置 ID 和個人資料。本政策是配合《歐盟電子通訊隱私指令》和《一般資料保護規則》(GDPR) 的法規而制定。在徵求同意聲明時,您必須指出中介服務鏈中可能會收集、接收或使用個人資料的每個廣告聯播網,並提供每個聯播網的使用方式相關資訊。Google 目前無法自動將使用者的同意聲明選項傳送至這類網路。
DT Exchange 包含 API,可讓您將使用者同意聲明轉寄至 SDK。以下程式碼範例說明如何手動將同意聲明資訊傳送至 DT Exchange SDK。如果您選擇手動將同意資訊傳送至 DT Exchange SDK,建議您在透過 Google Mobile Ads SDK 要求廣告之前,先呼叫這段程式碼。
Swift
import IASDKCore
// ...
IASDKCore.sharedInstance().gdprConsent = IAGDPRConsentType.given
IASDKCore.sharedInstance().gdprConsentString = "myGdprConsentString"
Objective-C
#import <IASDKCore/IASDKCore.h>
// ...
[IASDKCore.sharedInstance setGDPRConsent:YES];
[IASDKCore.sharedInstance setGDPRConsentString:@"myGdprConsentString"];
如需詳細資訊和方法中可能提供的值,請參閱 DT Exchange 的 GDPR 資源頁面和GDPR 導入指南。
美國州級隱私權法律
美國州級隱私權法律 規定使用者有權選擇拒絕「販售」自己的「個人資訊」(如該法案對「販售」一詞的定義),且「賣方」必須在首頁上提供顯眼的「不要販售我的個人資訊」連結,供使用者選擇拒絕。美國州級隱私權法律遵循指南提供啟用 Google 廣告放送服務的受限資料處理功能,但 Google 無法將這項設定套用至中介鏈中的每個廣告聯播網。因此,您必須在中介服務鏈中找出可能參與個人資訊販售的廣告聯播網,並遵循各個廣告聯播網的指示,確保符合規定。
DT Exchange 包含 API,可讓您將使用者同意聲明轉寄至 SDK。以下程式碼範例說明如何手動將同意聲明資訊傳送至 DT Exchange SDK。如果您選擇手動將同意資訊傳送至 DT Exchange SDK,建議您在透過 Google Mobile Ads SDK 要求廣告之前,先呼叫這段程式碼。
Swift
import IASDKCore
// ...
IASDKCore.sharedInstance().ccpaString = "myCCPAConsentString"
Objective-C
#import <IASDKCore/IASDKCore.h>
// ...
[IASDKCore.sharedInstance setCCPAString:@"myCCPAConsentString"];
如需詳細資訊和方法中可能提供的值,請參閱 DT Exchange 的 《加州消費者隱私法》資源頁面和《加州消費者隱私法》實作指南。
步驟 5:新增必要程式碼
SKAdNetwork 整合
請按照 DT Exchange 的說明文件將 SKAdNetwork 識別碼新增至專案的 Info.plist
檔案。
步驟 6:測試導入作業
啟用測試廣告
請務必為 AdMob 註冊測試裝置。
驗證測試廣告
如要確認您是否收到來自 DT Exchange 的測試廣告,請使用 DT Exchange (刊登序列) 廣告來源,在廣告檢查器中啟用單一廣告來源測試。
選擇性步驟
網路專屬參數
DT Exchange 轉接器支援額外的請求參數,可透過 GADMAdapterFyberExtras()
傳遞至轉接器。轉接器會在套件中尋找下列索引鍵:
要求參數和值 | |
---|---|
setUserData 使用者的年齡、性別和郵遞區號。 |
IAUserData |
setMuteAudio
|
布林值。將影片設為靜音或取消靜音 |
以下是如何設定這些廣告請求參數的程式碼範例:
Swift
let userData = IAUserData.build({ builder in
builder.age = 23
builder.gender = IAUserGenderType.male
builder.zipCode = "1234"
}];
let request = GADRequest()
let extras = GADMAdapterFyberExtras()
extras.userData = userData
extras.muteAudio = true
request.register(extras)
Objective-C
IAUserData *userData = [IAUserData build:^(id<IAUserDataBuilder> _Nonnull builder) {
builder.age = 23;
builder.gender = IAUserGenderTypeMale;
builder.zipCode = @"1234";
}];
GADRequest *request = [GADRequest request];
GADMAdapterFyberExtras *extras = [[GADMAdapterFyberExtras alloc] init];
extras.userData = userData;
extras.muteAudio = YES;
[request registerAdNetworkExtras:extras];
詳情請參閱 DT Exchange 整合指南。
錯誤代碼
如果轉接程式無法從 DT Exchange 接收廣告,您可以使用下列類別中的 GADResponseInfo.adNetworkInfoArray
,檢查廣告回應的基礎錯誤:
GADMediationAdapterFyber
以下是廣告載入失敗時,DT Exchange 轉接器擲回的程式碼和隨附訊息:
錯誤代碼 | 原因 |
---|---|
0-10 | DT Exchange SDK 傳回錯誤。詳情請參閱說明文件。 |
101 | AdMob 使用者介面中設定的 DT Exchange 伺服器參數遺失/無效。 |
102 | 請求的廣告大小與 DT Exchange 支援的橫幅廣告大小不符。 |
103 | 廣告物件已使用,因此無法顯示廣告。 |
104 | 廣告尚未準備就緒,因此無法顯示 DT Exchange 廣告。 |
105 | DT Exchange SDK 傳回初始化錯誤。 |
DT Exchange iOS 中介服務適配器變更記錄
8.3.3.0 版
- 已確認與 DT Exchange SDK 8.3.3 相容。
建構及測試時使用:
- Google Mobile Ads SDK 11.12.0 版。
- DT Exchange SDK 8.3.3 版。
8.3.2.1 版
- 移除已淘汰的關鍵字用法。
- 修正導致插頁式廣告和獎勵廣告消失,並顯示空白畫面的錯誤。
- 更新
CFBundleShortVersionString
,使其包含三個元件,而非四個。
建構及測試時使用:
- Google Mobile Ads SDK 11.10.0 版。
- DT Exchange SDK 8.3.2 版。
8.3.2.0 版
- 已確認與 DT Exchange SDK 8.3.2 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 11.8.0 版。
- DT Exchange SDK 8.3.2 版。
8.3.1.0 版
- 已確認與 DT Exchange SDK 8.3.1 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 11.6.0 版。
- DT Exchange SDK 8.3.1 版。
8.3.0.0 版
- 已確認與 DT Exchange SDK 8.3.0 相容。
建構及測試時使用:
- Google Mobile Ads SDK 11.5.0 版。
- DT Exchange SDK 8.3.0 版。
8.2.8.0 版
- 已確認與 DT Exchange SDK 8.2.8 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 11.3.0 版。
- DT Exchange SDK 8.2.8 版。
8.2.7.0 版
- 已確認與 DT Exchange SDK 8.2.7 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 11.2.0 版。
- DT Exchange SDK 8.2.7 版。
8.2.6.1 版
- 在獎勵廣告中新增
didFailToPresentWithError
回呼。 - 在插頁式廣告和獎勵廣告中新增
IAAdDidExpire
委派方法。 - 目前最低 iOS 版本為 12.0。
- 現在需要 Google Mobile Ads SDK 11.0 以上版本。
- 在
DTExchangeAdapter.xcframework
的架構中加入Info.plist
。
建構及測試時使用:
- Google Mobile Ads SDK 11.0.1 版。
- DT Exchange SDK 8.2.6 版。
8.2.6.0 版
- 已確認與 DT Exchange SDK 8.2.6 版相容。
- 已從橫幅和插頁式廣告導入方式中移除已淘汰的
willBackgroundApplication
委派方法。
建構及測試時使用:
- Google Mobile Ads SDK 10.14.0 版。
- DT Exchange SDK 8.2.6 版。
8.2.5.0 版
- 已確認與 DT Exchange SDK 8.2.5 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 10.14.0 版。
- DT Exchange SDK 8.2.5 版。
8.2.4.0 版
- 已確認與 DT Exchange SDK 8.2.4 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 10.9.0 版。
- DT Exchange SDK 8.2.4 版。
8.2.3.0 版
- 已確認與 DT Exchange SDK 8.2.3 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 10.7.0 版。
- DT Exchange SDK 8.2.3 版。
8.2.2.0 版
- 已確認與 DT Exchange SDK 8.2.2 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 10.5.0 版。
- DT Exchange SDK 8.2.2 版。
8.2.1.0 版
- 已確認與 DT Exchange SDK 8.2.1 版相容。
- 已停止支援
armv7
架構。 - 目前最低 iOS 版本為 11.0。
- 現在需要 Google Mobile Ads SDK 10.4.0 以上版本。
建構及測試時使用:
- Google Mobile Ads SDK 10.4.0 版。
- DT Exchange SDK 8.2.1 版。
8.2.0.0 版
- 已確認與 DT Exchange SDK 8.2.0 相容。
建構及測試時使用:
- Google Mobile Ads SDK 10.2.0 版。
- DT Exchange SDK 8.2.0 版。
8.1.9.1 版
- 現在需要 Google Mobile Ads SDK 10.0.0 以上版本。
建構及測試時使用:
- Google Mobile Ads SDK 10.0.0 版。
- DT Exchange SDK 8.1.9 版。
8.1.9.0 版
- 移除已淘汰的性別、生日和位置仲介 API 使用。
- 已確認與 DT Exchange SDK 8.1.9 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 9.14.0 版。
- DT Exchange SDK 8.1.9 版。
8.1.7.0 版
- 已確認與 DT Exchange SDK 8.1.7 版相容。
- 轉接器已重新命名為「DT Exchange」。
建構及測試時使用:
- Google Mobile Ads SDK 9.13.0 以上版本。
- DT Exchange SDK 8.1.7 版。
8.1.6.0 版
- 新增支援在
GADMAdapterFyberExtras
類別中傳遞muteAudio
額外資料。 - 更新轉接程式,以便使用
didRewardUser
API。 - 現在需要 Google Mobile Ads SDK 9.8.0 以上版本。
- 已確認與 Fyber Marketplace SDK 8.1.6 相容。
建構及測試時使用:
- Google Mobile Ads SDK 9.11.0 版。
- Fyber Marketplace SDK 8.1.6 版。
8.1.5.0 版
- 已確認與 Fyber Marketplace SDK 8.1.5 相容。
建構及測試時使用:
- Google Mobile Ads SDK 9.5.0 版。
- Fyber Marketplace SDK 8.1.5 版。
8.1.4.0 版
- 已確認與 Fyber Marketplace SDK 8.1.4 相容。
- 新增對 arm64 模擬器架構的支援。
建構及測試時使用:
- Google Mobile Ads SDK 9.1.0 版。
- Fyber Marketplace SDK 8.1.4 版。
8.1.3.1 版
- 已確認與 Google Mobile Ads SDK 9.0.0 相容。
- 現在需要 Google Mobile Ads SDK 9.0.0 以上版本。
建構及測試時使用:
- Google Mobile Ads SDK 9.0.0 版。
- Fyber Marketplace SDK 8.1.3 版。
8.1.3.0 版
- 已確認與 Fyber Marketplace SDK 8.1.3 相容。
建構及測試時使用:
- Google Mobile Ads SDK 8.13.0 版。
- Fyber Marketplace SDK 8.1.3 版。
8.1.2.0 版
- 已確認與 Fyber Marketplace SDK 8.1.2 相容。
建構及測試時使用:
- Google Mobile Ads SDK 8.13.0 版。
- Fyber Marketplace SDK 8.1.2 版。
8.1.1.0 版
- 已確認與 Fyber Marketplace SDK 8.1.1 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 8.12.0 版。
- Fyber Marketplace SDK 8.1.1 版。
8.1.0.0 版
- 已確認與 Fyber Marketplace SDK 8.1.0 相容。
建構及測試時使用:
- Google Mobile Ads SDK 8.12.0 版。
- Fyber Marketplace SDK 8.1.0 版。
8.0.0.0 版
- 已確認與 Fyber Marketplace SDK 8.0.0 相容。
建構及測試時使用:
- Google Mobile Ads SDK 8.12.0 版。
- Fyber Marketplace SDK 8.0.0 版。
7.9.0.0 版
- 已確認與 Fyber Marketplace SDK 7.9.0 相容。
建構及測試時使用:
- Google Mobile Ads SDK 8.11.0 版。
- Fyber Marketplace SDK 7.9.0 版。
7.8.9.0 版
- 已確認與 Fyber Marketplace SDK 7.8.9 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 8.10.0 版。
- Fyber Marketplace SDK 版本 7.8.9。
7.8.8.1 版
- 將廣告事件
didEndVideo
移至獎勵廣告回呼IAAdDidReward
。
建構及測試時使用:
- Google Mobile Ads SDK 8.9.0 版。
- Fyber Marketplace SDK 7.8.8 版。
7.8.8.0 版
- 目前最低 iOS 版本為 10.0。
- 已確認與 Fyber Marketplace SDK 7.8.8 相容。
建構及測試時使用:
- Google Mobile Ads SDK 8.9.0 版。
- Fyber Marketplace SDK 7.8.8 版。
7.8.7.0 版
- 已確認與 Fyber Marketplace SDK 7.8.7 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 8.8.0 版。
- Fyber Marketplace SDK 7.8.7 版。
7.8.6.0 版
- 已確認與 Fyber Marketplace SDK 7.8.6 相容。
建構及測試時使用:
- Google Mobile Ads SDK 8.5.0 版。
- Fyber Marketplace SDK 7.8.6 版。
7.8.5.0 版
- 已確認與 Fyber Marketplace SDK 7.8.5 版相容。
- 現在需要針對 Xcode 12.5 以上版本進行建構。
建構及測試時使用:
- Google Mobile Ads SDK 8.5.0 版。
- Fyber Marketplace SDK 版本 7.8.5。
7.8.1.0 版
- 已確認與 Fyber Marketplace SDK 7.8.1 版相容。
- 放寬 Google Mobile Ads SDK 8.0.0 以上版本的依附元件。
- 新增標準化轉接器錯誤代碼和訊息。
- 更新轉接程式,以便使用
.xcframework
格式。
建構及測試時使用:
- Google Mobile Ads SDK 8.0.0 版。
- Fyber Marketplace SDK 7.8.1 版。
7.8.0.0 版
- 已確認與 Fyber Marketplace SDK 7.8.0 相容。
建構及測試時使用:
- Google Mobile Ads SDK 7.69.0 版。
- Fyber Marketplace SDK 7.8.0 版。
7.7.3.0 版
- 已確認與 Fyber Marketplace SDK 7.7.3 版相容。
- 現在需要 Google Mobile Ads SDK 7.69.0 以上版本。
建構及測試時使用:
- Google Mobile Ads SDK 7.69.0 版。
- Fyber Marketplace SDK 版本 7.7.3。
7.7.2.0 版
- 已確認與 Fyber Marketplace SDK 7.7.2 版相容。
- 現在需要 Google Mobile Ads SDK 7.67.0 以上版本。
建構及測試時使用:
- Google Mobile Ads SDK 7.67.0 版。
- Fyber Marketplace SDK 版本 7.7.2。
7.7.1.0 版
- 已確認與 Fyber Marketplace SDK 7.7.1 版相容。
- 現在需要 Google Mobile Ads SDK 7.66.0 以上版本。
建構及測試時使用:
- Google Mobile Ads SDK 7.66.0 版。
- Fyber Marketplace SDK 版本 7.7.1。
7.6.4.0 版
- 已確認與 Fyber Marketplace SDK 7.6.4 相容。
- 現在需要 Google Mobile Ads SDK 7.65.0 以上版本。
- 新增 GADMAdapterFyberExtras 類別,讓發布商可將關鍵字和 userData 傳遞至 Fyber Marketplace SDK。
建構及測試時使用:
- Google Mobile Ads SDK 7.65.0 版。
- Fyber Marketplace SDK 7.6.4 版。
7.6.3.0 版
- 已確認與 Fyber Marketplace SDK 7.6.3 版相容。
建構及測試時使用:
- Google Mobile Ads SDK 7.64.0 版。
- Fyber Marketplace SDK 7.6.3 版。
7.6.2.0 版
- 已確認與 Fyber Marketplace SDK 7.6.2 相容。
- 現在需要 Google Mobile Ads SDK 7.64.0 以上版本。
建構及測試時使用:
- Google Mobile Ads SDK 7.64.0 版。
- Fyber Marketplace SDK 7.6.2 版。
7.6.0.0 版
- 已確認與 Fyber Marketplace SDK 7.6.0 相容。
- 現在需要 Google Mobile Ads SDK 7.62.0 以上版本。
- 更新轉接器,以支援內嵌自動調整橫幅廣告要求。
- 新增獎勵 HTML 支援功能。
- 新增獎勵回呼:IAAdDidReward (適用於獎勵影片和獎勵 HTML)。IAVideoCompleted 不再用於獎勵。
建構及測試時使用:
- Google Mobile Ads SDK 7.62.0 版。
- Fyber Marketplace SDK 7.6.0 版。
7.5.6.1 版
- 暫時移除 Fyber Marketplace SDK 專屬記錄。
建構及測試時使用:
- Google Mobile Ads SDK 7.60.0 版。
- Fyber Marketplace SDK 7.5.6 版。
7.5.6.0 版
- 已確認與 Fyber Marketplace SDK 7.5.6 相容。
- 將 Google Mobile Ads SDK 最低需求版本更新至 7.60.0。
建構及測試時使用:
- Google Mobile Ads SDK 7.60.0 版。
- Fyber Marketplace SDK 7.5.6 版。
7.5.5.0 版
- 已確認與 Fyber Marketplace SDK 7.5.5 版相容。
- 將最低要求的 Google Mobile Ads SDK 版本更新至 7.59.0。
建構及測試時使用:
- Google Mobile Ads SDK 7.59.0 版。
- Fyber Marketplace SDK 版本 7.5.5。
7.5.4.0 版
- 已確認與 Fyber Marketplace SDK 7.5.4 相容。
- 已停止支援 i386 架構。
建構及測試時使用:
- Google Mobile Ads SDK 7.57.0 版。
- Fyber Marketplace SDK 版本 7.5.4。
7.5.3.0 版
- 已確認與 Fyber Marketplace SDK 7.5.3 相容。
建構及測試時使用:
- Google Mobile Ads SDK 7.55.0 版。
- Fyber Marketplace SDK 7.5.3 版。
7.5.1.0 版
- 已確認與 Fyber Marketplace SDK 7.5.1 版相容。
- 修正初始化 Fyber SDK 時發生的異常終止問題。
建構及測試時使用:
- Google Mobile Ads SDK 7.55.0 版。
- Fyber Marketplace SDK 版本 7.5.1。
版本 7.5.0.0 (已淘汰)
- 這個版本已遭移除。請使用 7.5.1.0 以上版本。
- 已確認與 Fyber Marketplace SDK 7.5.0 相容。
- 如果 Fyber SDK 尚未初始化,轉接程式現在會在發出廣告請求前先初始化 Fyber SDK。
建構及測試時使用:
- Google Mobile Ads SDK 7.53.0 版。
- Fyber Marketplace SDK 7.5.0 版。
7.4.0.0 版
- 初始版本!
- 新增支援橫幅、插頁式和獎勵廣告格式。
建構及測試時使用:
- Google Mobile Ads SDK 7.52.0 版。
- Fyber Marketplace SDK 7.4.0 版。