將 MyTarget 與中介服務整合

本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 使用 中介服務 則涵蓋刊登序列整合功能說明如何將 myTarget 加到廣告單元 中介服務設定，以及如何將 myTarget SDK 和轉接程式整合至 Android 應用程式。

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

myTarget 的中介服務轉接程式具有下列功能：

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

需求條件

  • Android API 級別 21 以上

  • 最新版 Google Mobile Ads SDK

  • 完成中介服務 入門指南

步驟 1：在 myTarget UI 中進行設定

步驟 2：在使用者介面中設定 myTarget 需求 Ad Manager

新增 Mail.ru 至 GDPR 和美國州級法規廣告合作夥伴名單

請按照 GDPR 設定 和 美國州級法規設定 ，在 Ad Manager UI 和美國州級法規廣告合作夥伴清單中新增 Mail.ru。

步驟 3：匯入 myTarget SDK 和轉接程式

在應用程式層級的 build.gradle.kts 檔案中新增以下實作項目 依附元件和設定使用最新版 myTarget SDK 和轉接器：

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:mytarget:5.22.1.0")
}

手動整合

步驟 4：在 myTarget SDK 中導入隱私權設定

根據 Google 歐盟地區使用者同意聲明 Google 政策，您必須確保使用者有揭露特定揭露事項。 只有當歐洲經濟區 (EEA) 使用者提供同意聲明，以及 如何使用裝置 ID 和個人資料這項政策反映了 歐盟電子通訊隱私指令和一般資料保護規定 法規 (GDPR)。徵求同意時，您必須指明每個廣告聯播網 中介服務鏈中可能收集、接收或使用個人資料，並 提供各個網路用量的相關資訊。Google 目前無法 將使用者的同意聲明選項自動傳送到這類聯播網。

在 SDK 版本中 5.1.0, myTarget 加入了使用者同意聲明 API，以符合隱私權規定。 以下範例程式碼說明如何將這項同意聲明資訊傳遞至 myTarget 將機器學習工作流程自動化如果您選擇呼叫此方法，建議於 透過 Google Mobile Ads SDK 請求廣告。

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

此外，如果使用者已知屬於年齡限制類別，您可以 使用以下程式碼將這項同意聲明資訊傳送至 myTarget SDK。

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserAgeRestricted(true)

查看 myTarget 的 隱私權和 GDPR 指南 ，以及在方法中提供的值。

美國州級隱私權法律

美國州級隱私權法律 規定使用者必須提供 即可選擇停用「銷售」功能代表「個人資訊」(如同法律定義 該條款中，透過顯眼的「請勿銷售我的個人」 資訊」請點選「銷售」裝置上的「銷售」連結以及派對首頁 美國州級隱私權 法規遵循指南可讓您 受限的資料處理 此設定不適用於每則廣告，但 Google 無法將這項設定套用至每則廣告 中介服務鏈中的聯播網因此，你必須找出每個廣告聯播網。 可參與個人銷售的 並遵循各自的指南 確保符合法規。

在 SDK 版本中 5.9.0, myTarget 加入了使用者同意聲明 API，以符合隱私權規定。 以下範例程式碼說明如何將這項同意聲明資訊傳遞至 myTarget 將機器學習工作流程自動化如果您選擇呼叫此方法，建議於 透過 Google Mobile Ads SDK 請求廣告。

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

請與 myTarget 支援團隊聯絡，取得以下支援： 以及該方法中可以提供的值。

步驟 5：新增必要的程式碼

myTarget 整合不需要額外的程式碼。

步驟 6：測試實作成果

啟用測試廣告

請務必為Ad Manager 註冊測試裝置，並在 myTarget 使用者介面中啟用測試模式。

驗證測試廣告

如要確認您正在接收來自myTarget的測試廣告，請使用 myTarget (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。

選擇性步驟

使用原生廣告

廣告顯示

myTarget 轉接程式會將原生廣告傳回 NativeAd 如需儲存大量結構化物件 建議使用 Cloud Bigtable會填入以下項目 欄位 的 NativeAd。

欄位 由 myTarget 轉接器填入
廣告標題 一律
圖片 一律
內文 一律
應用程式圖示 一律
行動號召 一律
星級評等 未保證
商店 未保證
價格 未保證
標誌 未保證
廣告主 一律

myTarget SDK 一律會傳回 mediaView 寬度和高度的 0，因此 myTarget 轉接程式一律為以下項目傳回 0： getAspectRatio()。 myTarget SDK 會在日後推出的版本中修正這個問題。

曝光和點擊追蹤

Google Mobile Ads SDK 使用 myTarget SDK 的回呼來取得曝光， 因此兩個來源的報表應該會符合 以免出現差異

錯誤代碼

如果轉接程式無法從 myTarget 接收廣告，您可以查看 判斷錯誤的原因 ResponseInfo.getAdapterResponses() 加入以下類別：

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

以下是 myTarget 轉接器擲回的代碼和相應訊息 廣告無法載入時：

錯誤代碼 原因
100 myTarget SDK 傳回錯誤。
101 缺少在使用者介面中設定的 myTarget 伺服器參數 Ad Manager 或參數無效。
102 要求的廣告大小與 myTarget 支援的橫幅廣告大小不符。
103 廣告請求不是統一原生廣告請求。
104 從 myTarget 載入的原生廣告與請求的原生廣告不同。
105 從 myTarget 載入的原生廣告缺少某些必要素材資源 (例如圖片或圖示)。

myTarget Android 中介服務轉接程式變更記錄

5.22.1.0 版

  • 已將 Gradle JVM 的堆積大小上限從 512 MB 提高至 1 GB。
  • 已驗證與 myTarget SDK 5.22.1 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 23.2.0 版。
  • MyTarget SDK 5.22.1 版。

版本 5.21.1.0

  • 已驗證與 myTarget SDK 5.21.1 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 23.2.0 版。
  • MyTarget SDK 5.21.1 版。

5.21.0.0 版

  • 已驗證與 myTarget SDK 5.21.0 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 23.0.0 版。
  • MyTarget SDK 5.21.0 版。

5.20.1.0 版

  • 將 Google Mobile Ads SDK 最低要求版本更新為 23.0.0。
  • 已驗證與 myTarget SDK 5.20.1 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 23.0.0 版。
  • MyTarget SDK 5.20.1 版。

5.20.0.0 版

  • 已驗證與 myTarget SDK 5.20.0 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 22.5.0 版。
  • MyTarget SDK 5.20.0 版。

5.19.0.0 版

  • 已驗證與 myTarget SDK 5.19.0 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 22.3.0 版。
  • MyTarget SDK 5.19.0 版。

5.18.0.0 版

  • 已驗證與 myTarget SDK 5.18.0 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 22.2.0 版。
  • MyTarget SDK 5.18.0 版。

5.17.0.0 版

  • 已驗證與 myTarget SDK 5.17.0 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 22.2.0 版。
  • MyTarget SDK 5.17.0 版。

5.16.5.0 版

  • 已驗證與 myTarget SDK 5.16.5 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 22.0.0 版。
  • MyTarget SDK 5.16.5 版。

5.16.4.1 版

  • 已更新轉接程式，以便使用新的 VersionInfo 類別。
  • 將 Google Mobile Ads SDK 最低需求更新至 22.0.0 版。

建構及測試工具：

  • Google Mobile Ads SDK 22.0.0 版。
  • MyTarget SDK 5.16.4 版。

5.16.4.0 版

  • 已驗證與 myTarget SDK 5.16.4 版的相容性。
  • 將 Google Mobile Ads SDK 最低要求版本更新為 21.5.0。

建構及測試工具：

  • Google Mobile Ads SDK 21.5.0 版。
  • MyTarget SDK 5.16.4 版。

5.16.3.0 版

  • 已驗證與 myTarget SDK 5.16.3 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 21.4.0。

建構及測試工具：

  • Google Mobile Ads SDK 21.4.0 版。
  • MyTarget SDK 5.16.3 版。

5.16.2.0 版

  • 已驗證與 myTarget SDK 5.16.2 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 21.3.0 版。
  • MyTarget SDK 5.16.2 版。

5.16.1.0 版

  • 已驗證與 myTarget SDK 5.16.1 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 21.3.0 版。
  • MyTarget SDK 5.16.1 版。

5.16.0.0 版

  • 已驗證與 myTarget SDK 5.16.0 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 21.3.0 版。
  • MyTarget SDK 5.16.0 版。

5.15.5.0 版

  • 已驗證與 myTarget SDK 5.15.5 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求更新至 21.3.0 版。

建構及測試工具：

  • Google Mobile Ads SDK 21.3.0 版。
  • MyTarget SDK 5.15.5 版。

5.15.4.0 版

  • 已驗證與 myTarget SDK 5.15.4 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求更新至 21.1.0 版。

建構及測試工具：

  • Google Mobile Ads SDK 21.1.0 版。
  • MyTarget SDK 5.15.4 版。

5.15.3.0 版

  • 已驗證與 myTarget SDK 5.15.3 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 21.0.0 版。
  • MyTarget SDK 5.15.3 版。

5.15.2.1 版

  • 將 Google Mobile Ads SDK 最低需求更新至 21.0.0 版。
  • 將 Android API 級別最低需求更新為 19。

建構及測試工具：

  • Google Mobile Ads SDK 21.0.0 版。
  • MyTarget SDK 5.15.2 版。

5.15.2.0 版

  • 已驗證與 myTarget SDK 5.15.2 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 20.6.0 版。
  • MyTarget SDK 5.15.2 版。

5.15.1.0 版

  • 已驗證與 myTarget SDK 5.15.1 版的相容性。
  • 已將 compileSdkVersion 和 targetSdkVersion 更新至 API 31。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 20.6.0。

建構及測試工具：

  • Google Mobile Ads SDK 20.6.0 版。
  • MyTarget SDK 5.15.1 版。

5.15.0.0 版

  • 已驗證與 myTarget SDK 5.15.0 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 20.5.0 版。
  • MyTarget SDK 5.15.0 版。

5.14.4.0 版

  • 已驗證與 myTarget SDK 5.14.4 版的相容性。
  • 已新增 CustomParams 的中介服務額外處理方式。
  • 修正原生廣告 MediaView 未正確登錄為可點擊素材資源的問題。
  • 將 Google Mobile Ads SDK 最低版本更新至 20.5.0。

建構及測試工具：

  • Google Mobile Ads SDK 20.5.0 版。
  • MyTarget SDK 5.14.4 版。

5.14.3.0 版

  • 已驗證與 myTarget SDK 5.14.3 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 20.4.0 版。
  • MyTarget SDK 5.14.3 版。

5.14.2.0 版

  • 已驗證與 myTarget SDK 5.14.2 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 20.4.0 版。
  • MyTarget SDK 5.14.2 版。

5.14.1.0 版

  • 已驗證與 myTarget SDK 5.14.1 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 20.4.0。

建構及測試工具：

  • Google Mobile Ads SDK 20.4.0 版。
  • MyTarget SDK 5.14.1 版。

5.13.4.0 版

  • 已驗證與 myTarget SDK 5.13.4 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 20.3.0 版。
  • MyTarget SDK 5.13.4 版。

5.13.3.0 版

  • 已驗證與 myTarget SDK 5.13.3 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 20.3.0。

建構及測試工具：

  • Google Mobile Ads SDK 20.3.0 版。
  • MyTarget SDK 5.13.3 版。

5.13.2.0 版

  • 已驗證與 myTarget SDK 5.13.2 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 20.2.0 版。
  • MyTarget SDK 5.13.2 版。

5.13.1.0 版

  • 已驗證與 myTarget SDK 5.13.1 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求更新至 20.2.0 版。

建構及測試工具：

  • Google Mobile Ads SDK 20.2.0 版。
  • MyTarget SDK 5.13.1 版。

5.13.0.0 版

  • 已驗證與 myTarget SDK 5.13.0 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 20.1.0 版。
  • MyTarget SDK 5.13.0 版。

5.12.3.0 版

  • 已驗證與 myTarget SDK 5.12.3 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 20.1.0。

建構及測試工具：

  • Google Mobile Ads SDK 20.1.0 版。
  • MyTarget SDK 5.12.3 版。

5.12.2.0 版

  • 已驗證與 myTarget SDK 5.12.2 版的相容性。
  • 將 Google Mobile Ads SDK 最低版本更新至 20.0.0。

建構及測試工具：

  • Google Mobile Ads SDK 20.0.0 版。
  • MyTarget SDK 5.12.2 版。

版本 5.11.12.0

  • 已驗證與 myTarget SDK 5.11.12 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 19.7.0 版。
  • MyTarget SDK 5.11.12 版。

版本 5.11.10.0

  • 已驗證與 myTarget SDK 5.11.10 版的相容性。
  • 新增描述性的錯誤代碼和轉接程式載入/顯示失敗的原因。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 19.7.0。

建構及測試工具：

  • Google Mobile Ads SDK 19.7.0 版。
  • MyTarget SDK 5.11.10 版。

版本 5.11.7.0

  • 已驗證與 myTarget SDK 5.11.7 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 19.6.0 版。
  • MyTarget SDK 5.11.7 版。

版本 5.11.6.0

  • 已驗證與 myTarget SDK 5.11.6 版的相容性。
  • 停止支援已淘汰的 NativeContentAd 和 NativeAppInstallAd 格式。應用程式應請求整合式原生廣告。
  • 修正橫幅廣告載入時，有時會超過請求的大小。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 19.6.0。

建構及測試工具：

  • Google Mobile Ads SDK 19.6.0 版。
  • MyTarget SDK 5.11.6 版。

版本 5.11.5.0

  • 已驗證與 myTarget SDK 5.11.5 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 19.5.0 版。
  • MyTarget SDK 5.11.5 版。

版本 5.11.4.0

  • 已驗證與 myTarget SDK 5.11.4 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 19.5.0 版。
  • MyTarget SDK 5.11.4 版。

5.11.3.0 版

  • 新增 myTarget 自動調整橫幅廣告尺寸的支援。
  • 已驗證與 myTarget SDK 5.11.3 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 19.5.0。

建構及測試工具：

  • Google Mobile Ads SDK 19.5.0 版。
  • MyTarget SDK 5.11.3 版。

5.10.0.0 版

  • 已驗證與 myTarget SDK 5.10.0 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 19.4.0。

建構及測試工具：

  • Google Mobile Ads SDK 19.4.0 版。
  • MyTarget SDK 5.10.0 版。

5.9.1.0 版

  • 已驗證與 myTarget SDK 5.9.1 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 19.2.0 版。
  • MyTarget SDK 5.9.1 版。

5.8.4.0 版

  • 已驗證與 myTarget SDK 5.8.4 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 19.2.0 版。
  • MyTarget SDK 5.8.4 版。

5.8.3.0 版

  • 已驗證與 myTarget SDK 5.8.3 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 19.2.0。

建構及測試工具：

  • Google Mobile Ads SDK 19.2.0 版。
  • MyTarget SDK 5.8.3 版。

5.8.2.0 版

  • 已驗證與 myTarget SDK 5.8.2 版的相容性。
  • 更新轉接程式，以便支援內嵌自動調整橫幅廣告請求。

建構及測試工具：

  • Google Mobile Ads SDK 19.1.0 版。
  • MyTarget SDK 5.8.2 版。

5.8.1.0 版

  • 已驗證與 myTarget SDK 5.8.1 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 19.1.0 版。
  • MyTarget SDK 5.8.1 版。

5.8.0.0 版

  • 已驗證與 myTarget SDK 5.8.0 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 19.1.0 版。
  • MyTarget SDK 5.8.0 版。

5.7.1.0 版

  • 已驗證與 myTarget SDK 5.7.1 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 19.1.0 版。
  • MyTarget SDK 5.7.1 版。

5.7.0.0 版

  • 已驗證與 myTarget SDK 5.7.0 版的相容性。
  • 將 Google Mobile Ads SDK 最低要求版本更新為 19.1.0。

建構及測試工具：

  • Google Mobile Ads SDK 19.1.0 版。
  • MyTarget SDK 5.7.0 版。

5.6.3.0 版

  • 已驗證與 myTarget SDK 5.6.3 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 19.0.1 版。
  • MyTarget SDK 5.6.3 版。

5.6.2.0 版

  • 已驗證與 myTarget SDK 5.6.2 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 19.0.1。

建構及測試工具：

  • Google Mobile Ads SDK 19.0.1 版。
  • MyTarget SDK 5.6.2 版。

5.6.1.0 版

  • 已驗證與 myTarget SDK 5.6.1 版的相容性。

建構及測試工具：

  • Google Mobile Ads SDK 19.0.0 版。
  • MyTarget SDK 5.6.1 版。

5.6.0.0 版

  • 已驗證與 myTarget SDK 5.6.0 版的相容性。
  • 將 Google Mobile Ads SDK 最低要求版本更新為 19.0.0。
  • 將 Android API 級別最低需求更新為 16。

建構及測試工具：

  • Google Mobile Ads SDK 19.0.0 版。
  • MyTarget SDK 5.6.0 版。

5.5.5.0 版

  • 已驗證與 myTarget SDK 5.5.5 版的相容性。
  • 將 Google Mobile Ads SDK 最低需求版本更新為 18.3.0。

建構及測試工具：

  • Google Mobile Ads SDK 18.3.0 版。
  • MyTarget SDK 5.5.5 版。

5.4.6.0 版

  • 已驗證與 myTarget SDK 5.4.6 版的相容性。
  • 將 Google Mobile Ads SDK 最低要求版本更新為 18.2.0。

5.4.5.0 版

  • 已驗證與 myTarget SDK 5.4.5 版的相容性。
  • 將 Google Mobile Ads SDK 最低版本更新至 18.1.0。

5.4.0.0 版

  • 已驗證與 myTarget SDK 5.4.0 版的相容性。

5.3.9.1 版

  • 新增彈性橫幅廣告大小的支援功能。

5.3.9.0 版

  • 已驗證與 myTarget SDK 5.3.9 版的相容性。
  • 更新轉接程式，以支援新的開放式 Beta 版 獎勵 API。
  • 將 Google Mobile Ads SDK 最低需求更新至 17.2.0 版。

5.3.6.0 版

  • 已驗證與 myTarget SDK 5.3.6 版的相容性。

5.2.5.0 版

  • 已驗證與 myTarget SDK 5.2.5 版的相容性。
  • 修正轉接程式使用自訂大小時無法請求橫幅廣告的錯誤。

5.2.2.0 版

  • 已驗證與 myTarget SDK 5.2.2 版的相容性。

5.2.1.0 版

  • 已驗證與 myTarget SDK 5.2.1 版的相容性。

5.2.0.0 版

  • 已驗證與 myTarget SDK 5.2.0 版的相容性。

5.1.4.0 版

  • 已驗證與 myTarget SDK 5.1.4 版的相容性。

5.1.3.0 版

  • 已驗證與 myTarget SDK 5.1.3 版的相容性。

5.1.2.0 版

  • 已驗證與 myTarget SDK 5.1.2 版的相容性。

5.1.1.0 版

  • 已驗證與 myTarget SDK 5.1.1 版的相容性。

5.1.0.1 版

  • 更新轉接程式，以便使用統一原生廣告轉接程式 API。

5.1.0.0 版

  • 已驗證與 myTarget SDK 5.1.0 版的相容性。

5.0.4.0 版

  • 已驗證與 myTarget SDK 5.0.4 版的相容性。

5.0.2.1 版

  • 更新轉接程式，使其與 Google Mobile Ads SDK 15.0.0 版相容。

5.0.2.0 版

  • 已驗證與 myTarget SDK 5.0.2 版的相容性。

5.0.0.0 版

  • 已驗證與 myTarget SDK 5.0.0 版的相容性。
  • 更新轉接器，使其與 myTarget SDK 5.0.0 和 Android 相容 Studio 3.1 版

版本 4.7.2.0

  • 已驗證與 myTarget SDK 4.7.2 版的相容性。

版本 4.7.1.0

  • 已驗證與 myTarget SDK 4.7.1 版的相容性。
  • 新增 MediaView 內影片和輪轉廣告的支援功能。

版本 4.6.28.0

  • 更新了 Android Studio 3.0 版的轉接程式專案。
  • 已驗證與 myTarget SDK 4.6.28 版的相容性。

版本 4.6.27.0

  • 第一版！
  • 新增對橫幅廣告、插頁式廣告、獎勵廣告和原生廣告的支援。