本指南將說明如何使用 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 和美國州級法規廣告合作夥伴名單
步驟 3:匯入 myTarget SDK 和轉接程式
整合 Android Studio (建議做法)
在應用程式層級的 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")
}
手動整合
如要加入 myTarget SDK,請參閱 myTarget Android SDK 說明文件。
前往 myTarget 轉接器。 構件 複製到 Google 的 Maven 存放區選取最新版本、下載 myTarget 轉接程式的 .aar 檔案,並將該檔案加入專案。
步驟 4:在 myTarget SDK 中導入隱私權設定
歐盟地區使用者同意授權和 GDPR
根據 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
- 第一版!
- 新增對橫幅廣告、插頁式廣告、獎勵廣告和原生廣告的支援。