本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 使用 中介服務 則涵蓋刊登序列整合功能說明如何將 Chartboost 加到廣告單元的 中介服務設定,以及如何整合 Chartboost SDK 和轉接程式 附加至 Android 應用程式
支援的整合項目和廣告格式
Chartboost 的中介服務轉接程式具有下列功能:
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
原生 |
需求條件
- 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:在使用者介面中設定 Chartboost 需求 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.2.0")
implementation("com.google.ads.mediation:chartboost:9.7.0.0")
}
手動整合
下載最新版本的
.aar
檔案 Chartboost SDK: 加入 Maven Central 並新增至專案。前往 Chartboost Adapter 構件 複製到 Google 的 Maven 存放區選取最新版本,下載 Chartboost 轉接程式的
.aar
檔案,並將其新增至專案中。
步驟 4:在 Chartboost SDK 中實作隱私權設定
歐盟地區使用者同意授權和 GDPR
根據 Google 歐盟地區使用者同意聲明 Google 政策,您必須確保使用者有揭露特定揭露事項。 只有當歐洲經濟區 (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 無法將這項設定套用至每則廣告 中介服務鏈中的聯播網因此,你必須找出每個廣告聯播網。 可參與個人銷售的 並遵循各自的指南 確保符合法規。
在 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.getAdapterResponses()
加入以下類別:
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
以下是 Chartboost 轉接器擲回的代碼和相關訊息 廣告無法載入時:
錯誤代碼 | 原因 |
---|---|
0-99 | Chartboost SDK 傳回錯誤。查看 Chartboost 的說明文件 ,掌握更多詳細資訊。 |
101 | 要求的廣告大小與支援的橫幅廣告大小不符。 |
102 | Chartboost 一次只能載入 1 則廣告。 |
103 | 在使用者介面中設定的 Chartboost 伺服器參數 Ad Manager 遺失或無效。 |
104 | 目前無法顯示 Chartboost 插頁式廣告或獎勵廣告。 |
101 | 在使用者介面中設定的 Chartboost 伺服器參數 Ad Manager 遺失或無效。 |
102 | Chartboost SDK 傳回初始化錯誤。 |
103 | 節目播放時不會快取該圖表。 |
104 | 要求的廣告大小與支援的橫幅廣告大小不符。 |
105 | 裝置的 OS 版本低於 Chartboost SDK 的最低支援 OS 版本。 |
200-299 | Chartboost SDK 快取錯誤。請參閱程式碼 ,掌握更多詳細資訊。 |
300-399 | Chartboost SDK 顯示錯誤。請參閱程式碼 ,掌握更多詳細資訊。 |
400-499 | Chartboost SDK 點擊錯誤。請參閱程式碼 ,掌握更多詳細資訊。 |
Chartboost Android 中介服務轉接程式變更記錄
9.7.0.0 版
- 已驗證與 Chartboost SDK 9.7.0 版的相容性。
- 將 Google Mobile Ads SDK 最低要求版本更新為 23.0.0。
建構及測試工具:
- Google Mobile Ads SDK 23.0.0 版。
- Chartboost SDK 9.7.0 版。
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 Adapter 無法叫用廣告事件的錯誤。
- 將 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 版的轉接程式專案
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 版本].[adapter 修補程式版本]。
- 您現在可以透過新增下列項目,將轉接程式新增為編譯依附元件
新增至 build.gradle 檔案的依附元件標記:
compile 'com.google.ads.mediation:chartboost:6.6.0.0'
- 移至以 AAR 形式發布轉接器,而非 jar 檔案 (如需其他說明,請參閱 README)。
1.1.0 版本
- 已從 Chartboost 額外項目中移除 Chartboost 廣告位置。廣告位置現已改稱 為中介服務設定 Chartboost 時指定的名稱。
1.0.0 版本
- 原始版本。支援獎勵式影片廣告和插頁式廣告。