整合 DT Exchange 與中介服務

本指南將說明如何使用 Google Mobile Ads SDK,使用 AdMob 中介服務、涵蓋刊登序列整合) 來載入及顯示 DT Exchange 的廣告。本篇文章將說明如何將 DT Exchange 新增至廣告單元的中介服務設定,以及如何將 DT Exchange SDK 和轉接程式整合至 iOS 應用程式。

支援的整合項目和廣告格式

DT Exchange 的中介服務轉接程式具備下列功能:

整合
出價
瀑布
格式
橫幅廣告
插頁式
已獲得獎勵
原生

需求條件

  • iOS 部署目標為 12.0 以上版本
  • 最新版 Google Mobile Ads SDK

  • 完成中介服務入門指南

步驟 1:在 DT Exchange UI 中進行設定

新增應用程式和廣告刊登位置

註冊登入 DT Exchange 控制台。

按一下「Add App」按鈕新增應用程式。

管理應用程式

選取平台、填妥表單的其餘部分,然後按一下「新增刊登位置」

在「為刊登位置命名」欄位中,輸入新刊登位置的名稱,然後從下拉式選單中選取所需的「刊登位置類型」。最後按一下「Save 刊登位置」

設定

應用程式 ID 和刊登位置 ID

將滑鼠遊標懸停在左側導覽列上,開啟左側導覽列。然後按一下左選單中的「應用程式」

選單

在「應用程式管理」頁面中,記下應用程式旁邊的應用程式 ID

應用程式 ID

選取所需應用程式,前往「刊登位置」分頁,然後按一下「刊登位置名稱」旁的複製圖示。記下刊登位置 ID

刊登位置 ID

發布商 ID、用戶端金鑰和用戶端密鑰

按一下左選單中的使用者名稱,然後選取「使用者個人資料」

使用者個人資料選單

請記下「發布商 ID」、「消費者金鑰」和「消費者密鑰」,因為下一個步驟會用到這些資訊。

使用者個人資料

步驟 2:在 AdMob UI 中設定 DT Exchange 需求

調整廣告單元中介服務設定

您需要將 DT Exchange 新增至廣告單元的中介服務設定。

首先,請登入 AdMob 帳戶。接著,前往「中介服務」分頁。如果您想修改現有的中介服務群組,請按一下中介服務群組的名稱加以編輯,然後跳到「新增為廣告來源」一節。 DT Exchange

如要建立新的中介服務群組,請選取「建立中介服務群組」

輸入廣告格式和平台,然後按一下「繼續」

為中介服務群組命名,然後選取要指定的地區。接著,將中介服務群組狀態設為「已啟用」,然後按一下「新增廣告單元」

將這個中介服務群組與一或多個現有AdMob 廣告單元建立關聯。接著點選「完成」

您現在應該會看到已填入所選廣告單元的廣告單元資訊卡:

新增 DT Exchange 做為廣告來源

在「Ad Source」部分的「Waterfall」資訊卡下方,選取「Add Ad Source」。然後選取 DT Exchange

選取「DT Exchange」並啟用「最佳化工具」切換鈕。輸入上一節取得的 Publisher ID, Consumer Secret and Consumer Key,即可設定DT Exchange的廣告來源最佳化功能。 接著為DT Exchange 輸入有效千次曝光出價值,然後按一下「繼續」

如果 DT Exchange已有對應關係,可以選取該對應關係。否則請按一下「新增對應」

接著,輸入上一節取得的 Application ID and Placement ID。接著點選「完成」

將 DT Exchange (Fyber Monetization) 新增至 GDPR 和美國州級法規廣告合作夥伴清單

按照 GDPR 設定美國州級法規設定中的步驟,在 AdMob UI 的 GDPR 和美國州級法規廣告合作夥伴名單中加入 DT Exchange (Fyber 營利)

步驟 3:匯入 DT Exchange SDK 和轉接程式

在專案的 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 中導入隱私權設定

根據 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 識別碼新增至專案的 Info.plist 檔案。

步驟 6:測試導入作業

選擇性步驟

網路專屬參數

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 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 以上版本。
  • 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 版。