本指南將說明如何使用 Google Mobile Ads SDK,使用 中介服務 (涵蓋刊登序列整合) 來載入及顯示 DT Exchange 的廣告。本篇文章將說明如何將 DT Exchange 新增至廣告單元的中介服務設定,以及如何將 DT Exchange SDK 和轉接程式整合至 應用程式。
支援的整合和廣告格式
DT Exchange 的仲介轉接器具有下列功能:
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
原生 |
需求條件
- iOS 部署目標為 12.0 以上版本
最新版 Google Mobile Ads SDK
完成中介服務入門指南
步驟 1:在 DT Exchange UI 中設定
新增應用程式和廣告刊登位置
按一下「Add App」按鈕新增應用程式。
選取您的「Platform」,填妥表單的其餘部分,然後按一下「Add placements」。
在「請為刊登位置命名」欄位中輸入新刊登位置的名稱,然後從下拉式清單中選取所需的「刊登位置類型」。最後,按一下「儲存刊登位置」。
應用程式 ID 和刊登位置 ID
將滑鼠游標懸停在左側導覽列上,即可開啟該列。然後按一下左選單中的「應用程式」。
在「App Management」頁面中,記下應用程式旁邊的「App ID」。
選取應用程式,前往「刊登位置」分頁,然後按一下「刊登位置名稱」旁的複製圖示。記下刊登位置 ID。
發布商 ID、用戶端金鑰和用戶端密鑰
在左選單中按一下使用者名稱,然後選取「使用者個人資料」。
請記下「發布商 ID」、「消費者金鑰」和「消費者密鑰」,因為下一個步驟會用到這些資訊。
步驟 2:在 Ad Manager UI 中設定 DT Exchange 需求
調整廣告單元中介服務設定
將 DT Exchange (Fyber Monetization) 新增至 GDPR 和美國州級法規廣告合作夥伴清單
按照 GDPR 設定和美國州級法規設定中的步驟,在 AdMob UI 的 GDPR 和美國州級法規廣告合作夥伴名單中加入 DT Exchange (Fyber 營利)。
步驟 3:匯入 DT Exchange SDK 和轉接程式
使用 CocoaPods (建議)
在專案的 Podfile 中加入以下行:
pod 'GoogleMobileAdsMediationFyber'
在指令列中執行:
pod install --repo-update
手動整合
- 下載最新版的 DT Exchange SDK for iOS,並將下列架構連結至您的專案:
IASDKCore.framework
IASDKMRAID.framework
IASDKVideo.framework
- 前往變更記錄中的下載連結,並在專案中連結
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 的 CCPA 資源頁面和 CCPA 實作指南 。
步驟 5:新增必要程式碼
SKAdNetwork 整合
按照 DT Exchange 說明文件,將 SKAdNetwork ID 新增至專案的 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 = ()
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";
}];
*request = [ 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 | Ad Manager UI 中設定的 DT Exchange 伺服器參數遺失/無效。 |
102 | 請求的廣告大小與 DT Exchange 支援的橫幅廣告大小不符。 |
103 | 廣告物件已有人使用,因此無法顯示廣告。 |
104 | 廣告尚未準備就緒,因此無法顯示 DT Exchange 廣告。 |
105 | DT Exchange SDK 傳回初始化錯誤。 |
DT Exchange iOS 中介服務適配器變更記錄
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 以上版本。
- 將
Info.plist
包含在DTExchangeAdapter.xcframework
內的架構中。
建構及測試環境:
- 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 版。