本指南說明如何使用 Google Mobile Ads SDK，透過中介服務載入及顯示 Moloco 的廣告，包括出價整合。主要內容如下： 1. 如何將 Moloco 新增至廣告單元的中介服務設定； 2. 如何將 Moloco SDK 和轉接程式整合至 Android 應用程式。
支援的整合功能和廣告格式
Moloco 中介服務轉接程式具備下列功能：
| 整合 | |
|---|---|
| 出價 | |
| 瀑布 | |
| 格式 | |
| 開啟應用程式 | |
| 橫幅廣告 | |
| 插頁式 | |
| 已獲得獎勵 | |
| 插頁式獎勵廣告 | |
| 原生 | |
需求條件
Android API 級別 23 以上版本
3.8.0.0 以上版本的 Moloco 轉接程式
最新版 Google Mobile Ads SDK
完成中介服務入門指南。
步驟 1：在 Moloco 使用者介面設定
登入 Moloco Publisher Portal。
依序前往「總覽」 >「應用程式」分頁，然後點選「新增應用程式」按鈕，建立新應用程式。
選取應用程式的「OS」和「Privacy Settings」，填寫表單的其餘項目，然後按一下「Create」。
建立應用程式後，請在「Apps」分頁中選取該應用程式，接著查看詳細資料，並記下「App Key」(應用程式金鑰)。
依序前往「Overview」 >「Ad Units」分頁，從下拉式選單選取應用程式，然後按一下「New Ad Unit」。
在「Auction method」部分，選取「In-app bidding」，然後填寫表單的其餘項目。然後按一下「建立」。
前往「廣告單元」分頁，找到新建立的廣告單元，查看詳細資料。記下「Ad Units ID」(廣告單元 ID)。
步驟 2：在 Ad Manager 使用者介面中設定 Moloco 需求
登入 Ad Manager 帳戶。
啟用安全信號共用
依序前往「管理」 >「通用設定」。前往「Ad Exchange 帳戶設定」分頁，查看並開啟「安全信號共用」。按一下「儲存」。
透過出價要求共用安全信號
依序前往「廣告空間」 >「安全信號」。在「安全信號」下方，搜尋「Moloco Ads SDK」，然後開啟「啟用應用程式整合」。
按一下 [儲存]。
允許 SDK 出價共用安全信號
依序前往「廣告放送」 >「需求管道設定」。在「預設設定」分頁中，為「SDK 出價」開啟「允許安全信號共用」。
按一下 [儲存]。
設定 Moloco 出價
依序前往「廣告放送」 >「出價方」，然後按一下「前往 SDK 出價」。
按一下「新增出價方」。
選取「Moloco Ads」做為出價方。
按一下「繼續」，即可為這個出價方啟用 SDK 出價。
按一下 [完成]。
設定廣告單元對應
依序前往「廣告放送」 >「出價方」，然後按一下「前往 SDK 出價」。
選取 Moloco Ads SDK 的公司。
前往「廣告單元對應」分頁，然後按一下「新增廣告單元對應」。
選擇「特定廣告單元」。選取廣告單元和格式，並將「廣告空間類型」設為「行動應用程式」。接著選取「行動應用程式」，然後輸入在上一個部分取得的「應用程式金鑰」和「廣告單元 ID」。
最後按一下「儲存」。
將 Moloco Ads 新增至符合歐洲和美國州級法規的廣告合作夥伴名單
請按照「歐洲法規設定」和「美國州級法規設定」中的步驟，在 Ad Manager 使用者介面，將 Moloco Ads 新增至歐洲和美國州級法規廣告合作夥伴名單。
步驟 3：匯入 Moloco SDK 和轉接程式
整合 Android Studio (建議)
在應用程式層級的 build.gradle.kts 檔案中，新增下列導入依附元件和設定。請使用最新版 Moloco SDK 和轉接程式：
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.google.ads.mediation:moloco:3.12.1.0")
}
步驟 4：在 Moloco SDK 導入隱私權設定
歐盟地區同意授權和 GDPR
為遵守《Google 歐盟地區使用者同意聲明政策》，您必須向歐洲經濟區、英國和瑞士的使用者揭露特定資訊，並在法律有相關規定時，取得他們對使用 Cookie 或其他本機儲存空間的同意聲明，以及對收集、分享及使用個人資料進行廣告個人化的同意聲明。本政策是配合《歐盟地區電子通訊隱私指令》和《一般資料保護規則》(GDPR) 而制定。您有責任確認中介服務鏈中的每個廣告來源，皆已採用同意聲明機制。Google 無法將使用者的同意聲明選項自動傳遞至這類聯播網。
Moloco SDK 包含 isUserConsent 標記，可將同意聲明資訊傳遞至 Moloco SDK。
下列程式碼範例說明如何將同意聲明資訊傳遞至 Moloco SDK。如果選擇設定這些標記，建議先設定，再透過 Google Mobile Ads SDK 請求廣告。
Kotlin
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isUserConsent = true)
MolocoPrivacy.setPrivacy(privacySettings)
Java
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
/* isUserConsent */ true,
/* isAgeRestrictedUser */ false,
/* isDoNotSell */ false);
MolocoPrivacy.setPrivacy(privacySettings);
詳情請參閱 Moloco SDK Android 說明文件。
美國州級隱私權法律
美國各州隱私權法 規定，使用者有權選擇拒絕「販售」其「個人資訊」(如該法案對「販售」與「個人資訊」這兩個詞的定義)，且「賣方」必須在首頁上提供顯眼的「不要販售我的個人資訊」連結，供使用者使用。根據美國州級隱私權法律的法規遵循指南，您可以對 Google 廣告放送作業啟用「受限的資料處理」模式，但 Google 無法將這項設定套用至中介服務鏈的每個廣告聯播網。因此，如果中介服務鏈中有任何廣告聯播網可能銷售個人資訊，請務必個別找出這些聯播網，並遵循各自適用的指引，確保符合相關法規。
Moloco SDK 包含 isDoNotSell 標記，可將同意聲明資訊傳遞至 Moloco SDK。
下列程式碼範例說明如何將同意聲明資訊傳遞至 Moloco SDK。如果選擇設定這些標記，建議先設定，再透過 Google Mobile Ads SDK 請求廣告。
Kotlin
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)
Java
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
/* isUserConsent */ false,
/* isAgeRestrictedUser */ false,
/* isDoNotSell */ true);
MolocoPrivacy.setPrivacy(privacySettings);
詳情請參閱 Moloco SDK Android 說明文件。
步驟 5：測試導入成果
啟用測試廣告
請務必為 Ad Manager 註冊測試裝置。
驗證測試廣告
如要確認您是否收到 Moloco Ads SDK 的測試廣告，請使用「Moloco (出價)」廣告來源，在廣告檢查器中啟用單一廣告來源測試。
錯誤代碼
如果轉接程式無法從 Moloco 接收廣告，您可以使用下列類別中的 ResponseInfo.getAdapterResponses()，檢查廣告回應的潛在錯誤：
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
以下是廣告無法載入時，Moloco 轉接程式擲回的代碼與對應訊息：
| 錯誤代碼 | 網域 | 原因 |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | 缺少 Moloco 應用程式金鑰，或是金鑰無效。 |
| 102 | com.google.ads.mediation.moloco | 缺少 Moloco 廣告單元 ID，或是 ID 無效。 |
| 103 | com.google.ads.mediation.moloco | 傳回的 Moloco 廣告物件為空值。 |
| -1 至 5000 | com.moloco.sdk | Moloco SDK 傳回錯誤。詳情請參閱 Moloco 的說明文件。 |
獎勵廣告伺服器端驗證
如果驗證伺服器端驗證回呼，Moloco 的廣告來源 ID 會是 8267622065755668722。
Moloco Android 中介服務轉接程式變更記錄
4.0.0.0 版 (開發中)
3.12.1.0 版
- 驗證與 Moloco SDK 3.12.1 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 24.5.0 版。
- Moloco SDK 3.12.1 版。
3.12.0.0 版
- 驗證與 Moloco SDK 3.12.0 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 24.4.0 版。
- Moloco SDK 3.12.0 版。
3.11.0.0 版
- 驗證與 Moloco SDK 3.11.0 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 24.4.0 版。
- Moloco SDK 3.11.0 版。
3.10.0.0 版
- 驗證與 Moloco SDK 3.10.0 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 24.3.0 版。
- Moloco SDK 3.10.0 版。
3.9.0.0 版
- 驗證與 Moloco SDK 3.9.0 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 24.2.0 版。
- Moloco SDK 3.9.0 版。
3.8.0.1 版
- 新增支援中矩形橫幅廣告大小。
建構及測試時使用的版本：
- Google Mobile Ads SDK 24.1.0 版。
- Moloco SDK 3.8.0 版。
3.8.0.0 版
- 新增原生廣告格式的出價支援。
- 驗證與 Moloco SDK 3.8.0 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 24.1.0 版。
- Moloco SDK 3.8.0 版。
3.7.2.0 版
- 驗證與 Moloco SDK 3.7.2 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 24.0.0 版。
- Moloco SDK 3.7.2 版。
3.7.1.0 版
- Android 的 API 最低需求級別更新為 23。
- Google Mobile Ads SDK 最低需求版本更新為 24.0.0。
- 驗證與 Moloco SDK 3.7.1 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 24.0.0 版。
- Moloco SDK 3.7.1 版。
3.7.0.0 版
- 驗證與 Moloco SDK 3.7.0 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 23.6.0 版。
- Moloco SDK 3.7.0 版。
3.6.1.0 版
- 驗證與 Moloco SDK 3.6.1 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 23.6.0 版。
- Moloco SDK 3.6.1 版。
3.6.0.0 版
- 驗證與 Moloco SDK 3.6.0 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 23.6.0 版。
- Moloco SDK 3.6.0 版。
3.5.0.0 版
- 第 1 版。
- 新增對橫幅、插頁式和獎勵廣告格式的出價支援。
- 驗證與 Moloco SDK 3.5.0 版的相容性。
建構及測試時使用的版本：
- Google Mobile Ads SDK 23.6.0 版。
- Moloco SDK 3.5.0 版。