本指南將說明如何使用 Google Mobile Ads SDK,透過中介服務載入並顯示 Chartboost 的廣告,其中涵蓋刊登序列整合機制。我們會說明如何將 Chartboost 新增至廣告單元的中介服務設定,以及如何將 Chartboost SDK 和轉接程式整合至 Android 應用程式。
支援的整合項目和廣告格式
Chartboost 的 Ad Manager 中介服務轉接程式具有下列功能:
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
原生 |
需求條件
- Android API 級別 21 以上
最新版 Google Mobile Ads SDK
完成中介服務 入門指南
步驟 1:在 Chartboost UI 中進行設定
註冊 Chartboost 帳戶,然後在帳戶完成驗證後登入。接著前往「應用程式管理」分頁。
按一下「新增應用程式」按鈕即可建立應用程式。
填寫表單的其他部分,然後按一下「Add App」按鈕完成應用程式。
應用程式建立完成後,系統會將您帶往資訊主頁。請記下應用程式的應用程式 ID 和應用程式簽名。
Ad Manager 需要 Chartboost 使用者 ID 和使用者簽章來設定您的 Ad Manager 廣告單元 ID。按一下 Chartboost UI 上的「Chartboost 中介服務」,即可找到這些參數。
前往「Resources」>「API Explorer」分頁,然後記下「Authentication」區段下方的「User ID」和「User Signature」。
開啟測試模式
如要啟用應用程式的測試模式,請透過 Chartboost UI 中的「Apps management」分頁,從清單中選取應用程式,然後按一下「Edit app settings」。
您可以在應用程式設定中開啟「測試模式」。
啟用測試模式後,您可以使用先前建立的廣告單元 ID 來請求廣告,並接收 Chartboost 測試廣告。
您收到 Chartboost 測試廣告後,您的應用程式就會列入 Chartboost 的發布商應用程式審查中。如要讓 Chartboost 營利,發布商的應用程式審查結果必須通過 Chartboost。
步驟 2:在使用者介面中設定 Ad Manager 圖表需求
調整廣告單元中介服務設定
登入 Ad Manager 帳戶。
依序前往「廣告放送」>「收益群組」,然後按一下「新增收益群組」按鈕。
輸入收益群組的專屬「名稱」、將「狀態」設為「有效」、選取「廣告格式」,然後將「廣告空間類型」設為「行動應用程式」。接著在「指定目標」>「廣告空間」部分下,在「廣告空間」和「行動應用程式」下方,選取要新增中介服務的廣告單元。
接著,按一下「新增收益夥伴」按鈕。
如果您已經有Chartboost的收益夥伴,則可以選取。否則,請選取「建立新的收益夥伴」。
選取「Chartboost」做為「廣告聯播網」,然後輸入不重複的名稱並啟用「中介服務」。
開啟「自動資料收集」,然後輸入上一節中取得的User ID and User Signature 。
選取 [收益夥伴] 後,請選擇「Mobile SDK 中介服務」做為整合類型,選擇 Android 做為平台,狀態則選為「Active」。輸入上一節中取得的App ID, App Signature and Ad Location 。然後輸入「預設千次曝光出價」的值。
Chartboost 廣告位置 (已命名位置) 是簡單的名稱,代表您要在應用程式中顯示廣告的地點。Ad Manager 會將要求傳送至設定中指定的位置。傳送要求後,Chartboost 會將位置資訊新增至其使用者介面中,以便製作報表。
在 Chartboost UI 中,按一下「Advanced Settings」即可查看「基本設定」頁面中的廣告位置。詳情請參閱 Chartboost 已命名位置指南。
完成後,按一下頁面下方的「儲存」。
新增 Chartboost 至 GDPR 和美國州級法規廣告合作夥伴名單
請按照 GDPR 設定 和 美國州級法規設定 ,在 Ad Manager UI 和美國州級法規廣告合作夥伴清單中新增 Chartboost。
步驟 3:匯入 Chartboost SDK 和轉接程式
Android Studio 整合 (建議)
在專案層級的 settings.gradle.kts
檔案中,新增下列存放區:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
}
}
}
接著,在應用程式層級的 build.gradle.kts
檔案中,新增下列實作依附元件和設定。請使用最新版本的 Chartboost SDK 和轉接程式:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:chartboost:9.6.1.0")
}
手動整合
從 Maven Central 下載最新版 Chartboost SDK 的
.aar
檔案,然後將其新增至專案。前往 Google Maven 存放區上的 Chartboost Adapter 構件。選取最新版本,下載 Chartboost 轉接程式的
.aar
檔案,然後將其新增至專案。
步驟 4:在 Chartboost SDK 上實作隱私權設定
歐盟地區同意聲明和 GDPR
根據 Google 歐盟地區使用者同意授權政策,您必須向歐洲經濟區 (EEA) 的使用者揭露特定揭露事項,並向歐洲經濟區 (EEA) 的使用者取得有關裝置 ID 和個人資料使用行為的同意。本政策是配合《歐盟地區電子通訊隱私指令》和《一般資料保護規則》(GDPR) 而製定。取得同意聲明時,您必須指出中介服務鏈中每個可能收集、接收或使用個人資料的廣告聯播網,並提供各聯播網使用情形的相關資訊。Google 目前無法將使用者的同意聲明選項自動傳送至這類聯播網。
在 SDK 8.1.0 版中,Chartboost 新增了 addDataUseConsent()
方法。下列程式碼範例集資料使用同意聲明:NON_BEHAVIORAL
。如果您選擇呼叫這個方法,建議先完成這項操作,再透過 Google Mobile Ads SDK 請求廣告。
Java
DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);
Kotlin
val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)
詳情請參閱 Chartboost 的 GDPR 文章和其 Android 隱私權方法 ,以及每種方法可提供的值。
美國州級隱私權法律
美國州級隱私權法律 規定,使用者必須有權選擇拒絕「販售」自己的「個人資訊」(相關條款定義了這些條款),並在「販售」方首頁上提供醒目的「請勿銷售我的個人資訊」連結。美國各州隱私權法律法規遵循指南可讓您為 Google 廣告放送啟用受限的資料處理模式,但 Google 無法將這項設定套用至中介服務鏈中的每個廣告聯播網。因此,您必須在中介服務鏈中逐一指明可能銷售個人資訊的廣告聯播網,並按照各聯播網的指示確保遵守規定。
在 SDK 8.1.0 版中,Chartboost 新增了 addDataUseConsent()
方法。下列程式碼範例集資料使用同意聲明:OPT_IN_SALE
。如果您選擇呼叫這個方法,建議先完成這項操作,再透過 Google Mobile Ads SDK 請求廣告。
Java
DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);
Kotlin
val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)
詳情請參閱 Chartboost 的 CCPA 文章和當中的 Android 隱私權方法 ,以及每種方法可提供的值。
步驟 5:新增必要程式碼
修改 AndroidManifest
其他元素
請在 AndroidManifest.xml
檔案中,為每個會顯示 Chartboost 廣告並支援不同螢幕方向的活動加入下列屬性:
android:configChanges="keyboardHidden|orientation|screenSize"
生命週期事件
根據 Chartboost 的建議,將下列程式碼加入所有會顯示 Chartboost 廣告的活動生命週期事件。
Java
import com.chartboost.sdk.Chartboost;
// ...
@Override
public void onBackPressed() {
// If an interstitial is on screen, close it.
if (Chartboost.onBackPressed()) {
return;
} else {
super.onBackPressed();
}
}
Kotlin
import com.chartboost.sdk.Chartboost
// ...
@Override
fun onBackPressed() {
// If an interstitial is on screen, close it.
if (Chartboost.onBackPressed())
return
else
super.onBackPressed()
}
步驟 6:測試導入狀態
啟用測試廣告
請務必為Ad Manager 註冊測試裝置,並在 Chartboost 使用者介面中啟用測試模式。
驗證測試廣告
如要確認您正在接收來自Chartboost的測試廣告,請使用 Chartboost (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。
選擇性步驟
權限
為獲得最佳效能,Chartboost 建議在應用程式的 AndroidManifest.xml
檔案中加入下列選用權限:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
錯誤代碼
如果轉接程式無法從 Chartboost 接收廣告,您可以在下列類別中使用
ResponseInfo.getAdapterResponse()
,查看廣告回應的基礎錯誤:
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
以下是廣告無法載入時,Chartboost 轉接程式擲回的程式碼和隨附的訊息:
錯誤代碼 | 原因 |
---|---|
0-99 | Chartboost SDK 傳回錯誤。詳情請參閱 Chartboost 的說明文件。 |
101 | 要求的廣告大小與 Chartboost 支援的橫幅廣告大小不符。 |
102 | Chartboost 每個地區一次只能載入 1 則廣告。 |
103 | 使用者介面中設定的 Chartboost 伺服器參數缺少或無效。 Ad Manager |
104 | Chartboost 插頁式廣告或獎勵廣告目前無法顯示。 |
101 | 使用者介面中設定的 Chartboost 伺服器參數缺少或無效。 Ad Manager |
102 | Chartboost SDK 傳回初始化錯誤。 |
103 | 顯示時未快取 Chartboost 廣告。 |
104 | 要求的廣告大小與 Chartboost 支援的橫幅廣告大小不符。 |
105 | 裝置的 OS 版本低於 Chartboost SDK 支援的最低 OS 版本。 |
200-299 | Chartboost SDK 快取錯誤。詳情請參閱程式碼。 |
300-399 | Chartboost SDK 顯示錯誤。詳情請參閱程式碼。 |
400-499 | Chartboost SDK 點擊錯誤。詳情請參閱程式碼。 |
Chartboost Android 中介服務轉接程式變更記錄
9.6.1.0 版
- 已驗證與 Chartboost SDK 9.6.1 版本的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.6.0 版。
- Chartboost SDK 9.6.1.
9.6.0.0 版
- 已驗證與 Chartboost SDK 9.6.0 版本的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.5.0 版。
- Chartboost SDK 9.6.0.
9.5.0.0 版
- 已驗證與 Chartboost SDK 9.5.0 版本的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.3.0 版。
- Chartboost SDK 9.5.0.
9.4.1.0 版
- 已驗證與 Chartboost SDK 9.4.1 版本的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.2.0 版。
- Chartboost SDK 9.4.1.
9.4.0.0 版
- 已驗證與 Chartboost SDK 9.4.0 版本的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.1.0 版。
- Chartboost SDK 9.4.0.
9.3.1.0 版
- 已驗證與 Chartboost SDK 9.3.1 版本的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.1.0 版。
- Chartboost SDK 9.3.1.
9.3.0.0 版
- 經驗證與 Chartboost SDK 9.3.0 版相容。
建構及測試工具:
- Google Mobile Ads SDK 22.0.0 版。
- Chartboost SDK 9.3.0.
9.2.1.1 版
- 已更新轉接器以使用新的
VersionInfo
類別。 - 將 Google Mobile Ads SDK 的最低版本更新為 22.0.0。
建構及測試工具:
- Google Mobile Ads SDK 22.0.0 版。
- Chartboost SDK 9.2.1.
9.2.1.0 版
- 經驗證與 Chartboost SDK 9.2.1 的相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.5.0 版。
- Chartboost SDK 9.2.1.
9.2.0.0 版
- 經驗證與 Chartboost SDK 9.2.0 的相容性。
- 將 Google Mobile Ads SDK 的最低版本更新為 21.5.0。
建構及測試工具:
- Google Mobile Ads SDK 21.5.0 版。
- Chartboost SDK 9.2.0.
9.1.1.0 版
- 新增
ChartboostMediationAdapter.setAppParams(String, String)
方法做為選用方式,針對要用於初始化 Chartboost SDK 的應用程式 ID 和應用程式簽名進行硬式編碼。 - 經驗證與 Chartboost SDK 9.1.1 的相容性。
- 將 Google Mobile Ads SDK 的最低版本更新為 21.3.0。
建構及測試工具:
- Google Mobile Ads SDK 21.3.0 版。
- Chartboost SDK 9.1.1.
8.4.3.1 版
- 將 Google Mobile Ads SDK 的最低版本更新為 21.0.0。
- 將最低 Android API 級別更新為 19。
建構及測試工具:
- Google Mobile Ads SDK 21.0.0 版。
- Chartboost SDK 8.4.3.
8.4.3.0 版
- 已驗證與 Chartboost SDK 8.4.3 的相容性。
建構及測試工具:
- Google Mobile Ads SDK 20.6.0 版。
- Chartboost SDK 8.4.3.
8.4.2.0 版
- 已驗證與 Chartboost SDK 8.4.2 的相容性。
- 將
compileSdkVersion
和targetSdkVersion
更新為 API 31。 - 將 Google Mobile Ads SDK 的最低版本更新為 20.6.0。
建構及測試工具:
- Google Mobile Ads SDK 20.6.0 版。
- Chartboost SDK 8.4.2.
8.4.1.0 版
- 經驗證與 Chartboost SDK 8.4.1 的相容性。
- 將 Google Mobile Ads SDK 的最低版本更新為 20.6.0。
建構及測試工具:
- Google Mobile Ads SDK 20.6.0 版。
- Chartboost SDK 8.4.1.
8.3.1.0 版
- 經驗證與 Chartboost SDK 8.3.1 的相容性。
- 已更新轉接程式以使用新的
AdError
API。
建構及測試工具:
- Google Mobile Ads SDK 20.5.0 版。
- Chartboost SDK 8.3.1.
8.3.0.0 版
- 經驗證與 Chartboost SDK 8.3.0 的相容性。
- 將 Google Mobile Ads SDK 的最低版本更新為 20.5.0。
建構及測試工具:
- Google Mobile Ads SDK 20.5.0 版。
- Chartboost SDK 8.3.0.
8.2.1.0 版
- 經驗證與 Chartboost SDK 8.2.1 的相容性。
- 將 Google Mobile Ads SDK 的最低版本更新為 20.1.0。
建構及測試工具:
- Google Mobile Ads SDK 20.1.0 版。
- Chartboost SDK 8.2.1.
8.2.0.1 版
- 將 Google Mobile Ads SDK 的最低版本更新為 20.0.0。
建構及測試工具:
- Google Mobile Ads SDK 20.0.0 版。
- Chartboost SDK 8.2.0.
8.2.0.0 版
- 經驗證與 Chartboost SDK 8.2.0 的相容性。
- 將 Google Mobile Ads SDK 的最低版本更新為 19.5.0。
建構及測試工具:
- Google Mobile Ads SDK 19.5.0 版。
- Chartboost SDK 8.2.0.
8.1.0.0 版
- 經驗證與 Chartboost SDK 8.1.0 的相容性。
建構及測試工具:
- Google Mobile Ads SDK 19.2.0 版。
- Chartboost SDK 8.1.0.
8.0.3.2 版
- 新增描述性的錯誤代碼,以及轉接程式載入/顯示失敗的原因。
- 將 Google Mobile Ads SDK 的最低版本更新為 19.2.0。
建構及測試工具:
- Google Mobile Ads SDK 19.2.0 版。
- Chartboost SDK 8.0.3.
8.0.3.1 版
- 新增對 Chartboost 橫幅廣告的支援。
建構及測試工具:
- Google Mobile Ads SDK 19.1.0 版。
- Chartboost SDK 8.0.3.
8.0.3.0 版
- 經驗證與 Chartboost SDK 8.0.3 的相容性。
- 將 Google Mobile Ads SDK 的最低版本更新為 19.1.0。
建構及測試工具:
- Google Mobile Ads SDK 19.1.0 版。
- Chartboost SDK 8.0.3.
8.0.2.0 版
- 經驗證與 Chartboost SDK 8.0.2 的相容性。
- 將 Google Mobile Ads SDK 的最低版本更新為 19.0.1。
建構及測試工具:
- Google Mobile Ads SDK 19.0.1 版。
- Chartboost SDK 8.0.2.
8.0.1.0 版
- 經驗證與 Chartboost SDK 8.0.1 的相容性。
- 需要 Chartboost SDK 8.0.1 以上版本。
- 載入廣告時不再需要活動內容。
建構及測試工具:
- Google Mobile Ads SDK 18.3.0 版。
- Chartboost SDK 8.0.1.
7.5.0.1 版
- 修正 Chartboost 轉接程式無法叫用廣告事件的錯誤。
- 將 Google Mobile Ads SDK 的最低版本更新為 18.3.0。
建構及測試工具:
- Google Mobile Ads SDK 18.3.0 版。
- Chartboost SDK 7.5.0.
7.5.0.0 版
- 經驗證與 Chartboost SDK 7.5.0 的相容性。
- 遷移轉接程式以使用 AndroidX 依附元件。
- 將 Google Mobile Ads SDK 的最低版本更新為 18.1.1。
7.3.1.1 版
- 更新轉接程式以支援新的開放式 Beta 版獎勵 API。
- 將 Google Mobile Ads SDK 的最低版本更新為 17.2.0。
7.3.1.0 版
- 經驗證與 Chartboost SDK 7.3.1 的相容性。
7.3.0.0 版
- 經驗證與 Chartboost SDK 7.3.0 的相容性。
7.2.1.0 版
- 經驗證與 Chartboost SDK 7.2.1 的相容性。
7.2.0.1 版
- 更新轉接程式以叫用
onRewardedVideoComplete()
廣告事件。
7.2.0.0 版
- 經驗證與 Chartboost SDK 7.2.0 的相容性。
7.1.0.0 版
- 經驗證與 Chartboost SDK 7.1.0 的相容性。
7.0.1.0 版
- 經驗證與 Chartboost SDK 7.0.1 的相容性。
- 開始支援新的 Chartboost 錯誤代碼。
- 更新 Android Studio 3.0 的 Adapter 專案
7.0.0.0 版
- 更新轉接程式,使其與 Chartboost SDK 7.0.0 相容。
6.6.3.0 版
- 經驗證與 Chartboost SDK 6.6.3 的相容性。
6.6.2.0 版
- 經驗證與 Chartboost SDK 6.6.2 的相容性。
6.6.1.0 版
- 經驗證與 Chartboost SDK 6.6.1 的相容性。
6.6.0.0 版
- 已將版本命名系統變更為 [Chartboost SDK version].[adapter 修補程式版本]。
- 現在,您可以在 build.gradle 檔案的依附元件標記中加入以下內容,將轉接程式新增為編譯依附元件:
compile 'com.google.ads.mediation:chartboost:6.6.0.0'
- 改為以 AAR 而非 jar 檔案形式發布轉接程式 (如需其他操作說明,請參閱 README)。
1.1.0 版本
- 已從 Chartboost extras 移除 Chartboost 廣告位置。您現在為中介服務設定 Chartboost 時,可以在 AdMob 控制台指定廣告位置。
1.0.0 版本
- 原始版本。支援獎勵型影片廣告和插頁式廣告。