本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 使用 中介服務 包括刊登序列和出價整合內容涵蓋如何將 Pangle 加到 廣告單元的中介服務設定,以及如何整合 Pangle SDK 插入 Android 應用程式。
支援的整合項目和廣告格式
Pangle 的中介服務轉接程式具備下列功能:
整合 | |
---|---|
出價 | |
瀑布 | 1 |
格式 | |
應用程式開啟頁面廣告 | 2 |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
插頁式獎勵廣告 | |
原生 |
2 出價整合: 這個格式仍在 Beta 版封閉測試階段
需求條件
- Android API 級別 21 以上
最新版 Google Mobile Ads SDK
完成中介服務 入門指南
步驟 1:在 Pangle UI 中進行設定
新增應用程式
前往「Applications」分頁,然後按一下「Add App」按鈕。
選取您要建立應用程式的「作業系統」,並填寫表單的其餘部分。然後按一下「提交」。
記下應用程式的應用程式 ID。
建立廣告刊登位置
應用程式建立完成後,按一下「新增」按鈕建立廣告刊登位置。
出價
選取「廣告格式」和「廣告刊登位置名稱」,然後選取「應用程式內出價」做為定價類型。填寫表單的其他部分,然後按一下「Submit」。
建立廣告刊登位置後,請記下廣告刊登位置 ID。
瀑布
選取「廣告格式」和「廣告刊登位置名稱」,以及「全球千次曝光出價」做為「定價類型」。填寫表單的其他部分,然後按一下「Submit」。
建立廣告刊登位置後,請記下廣告刊登位置 ID。
開啟測試模式
按照 Pangle 的「如何新增測試廣告」指南中的操作說明啟用 Pangle 測試廣告。
步驟 2:在使用者介面中設定 Pangle 需求 Ad Manager
登入 Ad Manager 帳戶。
將 Pangle 新增至公司
出價
整合出價時不需要執行這個步驟。
瀑布
依序前往「Admin」 >「Companies」,然後按一下「All Company」分頁中的「新增公司」按鈕。選取「廣告聯播網」。
選取「Pangle」做為「廣告聯播網」,然後輸入不重複的名稱並啟用「中介服務」。
您不必輸入使用者名稱或密碼。完成後,按一下「Save」(儲存)。
啟用安全信號共用
出價
依序前往「管理」 >「通用設定」。前往「Ad Exchange 帳戶設定」分頁,然後開啟「安全信號共用」。按一下「儲存」。
瀑布
刊登序列整合不需要這個步驟。
設定 Pangle 出價
出價
依序前往「廣告放送」 >「出價方」,然後按一下「SDK 出價」分頁下方的「新增出價方」。
選取「Pangle」做為出價方。
開啟「將這個出價方的信號程式庫新增至允許的信號清單」,以及「允許與這個出價方共用信號」。然後按一下「Continue」。
點按「繼續」。
按一下「完成」。
瀑布
刊登序列整合不需要這個步驟。
設定廣告單元對應
出價
依序前往「廣告放送」 >「出價方」,然後在「SDK 出價」分頁下方,選取Pangle 的公司。
前往「廣告單元對應」分頁,然後按一下「新增廣告單元對應」。
選擇「特定廣告單元」。選取廣告單元和格式、「行動應用程式」做為「廣告空間類型」,以及您的行動應用程式。接著,輸入上一節中取得的App ID and Ad Placement ID 。最後按一下「儲存」。
瀑布
依序前往「廣告放送」 >「收益群組」,然後按一下「新增收益群組」按鈕。選取您的行動應用程式。
向下捲動,然後按一下「新增收益夥伴」。
在上一節選取您為 Pangle建立的公司。選擇「Mobile SDK 中介服務」做為「整合類型」,「平台」選擇「Android」,「平台」則選擇「有效」。
輸入上一節取得的 App ID and Ad Placement ID,以及預設千次曝光出價值。按一下「Save」(儲存)。
步驟 3:匯入 Pangle SDK 和轉接程式
整合 Android Studio (建議做法)
在專案層級的 settings.gradle.kts
檔案中新增以下內容
存放區:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
}
接著,在應用程式層級的 build.gradle.kts
檔案中新增以下內容
實作依附元件和設定使用最新版本的
Pangle SDK 和轉接程式:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:pangle:6.1.0.7.0")
}
手動整合
下載最新版本的 適用於 Android 的 Pangle SDK 然後,從下載的封存資料夾擷取以下的
open_ad_sdk.aar
然後加入專案中前往 Pangle 轉換器構件 複製到 Google 的 Maven 存放區選取最新版本,下載 Pangle 轉接程式的
.aar
檔案,並將其新增至專案中。
步驟 4:新增必要的程式碼
ProGuard 模糊處理
如果您使用 ProGuard 模糊處理 Android 程式碼,請按照 Pangle 說明文件 確保 Pangle SDK 程式碼並未經過模糊處理。
步驟 5:測試實作成果
啟用測試廣告
請務必為Ad Manager 註冊測試裝置,並在 Pangle 使用者介面中啟用測試模式。
驗證測試廣告
如要確認您正在接收來自Pangle的測試廣告,請使用 Pangle (Bidding) and Pangle (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。
選擇性步驟
原生廣告
廣告顯示
Pangle 轉接程式會傳回原生廣告
NativeAd
如需儲存大量結構化物件
建議使用 Cloud Bigtable會填入以下項目
欄位
的
NativeAd
。
欄位 | 一律由 Pangle 轉接器納入素材資源 |
---|---|
廣告標題 | |
圖片 | 1 |
內文 | |
圖示 | |
行動號召 | |
星級評等 | |
商店 | |
價格 | |
廣告主 |
1 Pangle 轉接器未
可讓使用者直接存取原生廣告的主要圖片素材資源。相反地
轉接程式會填入
MediaView
包含影片或圖片
錯誤代碼
如果轉接程式無法接收來自 Pangle 的廣告,您可以查看
判斷錯誤的原因
ResponseInfo.getAdapterResponses()
加入以下類別:
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
以下是 Pangle 轉接器擲回的代碼和隨附訊息 如果發生以下情形,則代表廣告無法載入:
錯誤代碼 | 網域 | 原因 |
---|---|---|
101 | com.google.ads.mediation.pangle | 伺服器參數無效 (例如缺少應用程式 ID 或刊登位置 ID)。 |
102 | com.google.ads.mediation.pangle | 要求的廣告大小與支援 Pangle 的橫幅廣告大小不符。 |
103 | com.google.ads.mediation.pangle | 出價回應遺失或無效。 |
-1-60000 | com.pangle.ads | Pangle SDK 傳回錯誤。詳情請參閱 Pangle 的說明文件。 |
Pangle Android 中介服務轉接程式變更記錄
6.1.0.7.0 版
- 已驗證與 Pangle SDK 6.1.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.2.0 版。
- Pangle SDK 6.1.0.7 版。
6.1.0.6.0 版
- 已驗證與 Pangle SDK 6.1.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.2.0 版。
- Pangle SDK 6.1.0.6 版。
6.0.0.8.0 版
- 已驗證與 Pangle SDK 6.0.0.8 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.1.0 版。
- Pangle SDK 6.0.0.8 版。
6.0.0.7.0 版
- 已驗證與 Pangle SDK 6.0.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.1.0 版。
- Pangle SDK 6.0.0.7 版。
6.0.0.5.0 版
- 已驗證與 Pangle SDK 6.0.0.5 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.1.0 版。
- Pangle SDK 6.0.0.5 版。
6.0.0.4.0 版
- 已驗證與 Pangle SDK 6.0.0.4 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.1.0 版。
- Pangle SDK 6.0.0.4 版。
6.0.0.3.0 版
- 已驗證與 Pangle SDK 6.0.0.3 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.1.0 版。
- Pangle SDK 6.0.0.3 版。
5.9.0.6.0 版
- 已驗證與 Pangle SDK 5.9.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.1.0 版。
- Pangle SDK 5.9.0.6 版。
5.9.0.5.0 版
- 已驗證與 Pangle SDK 5.9.0.5 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.1.0 版。
- Pangle SDK 5.9.0.5 版。
5.9.0.4.0 版
- 已驗證與 Pangle SDK 5.9.0.4 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.0.0 版。
- Pangle SDK 5.9.0.4 版。
5.9.0.2.0 版
- 已驗證與 Pangle SDK 5.9.0.2 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.0.0 版。
- Pangle SDK 5.9.0.2 版。
5.8.1.0.0 版
- 已驗證與 Pangle SDK 5.8.1.0 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.0.0 版。
- Pangle SDK 5.8.1.0 版。
5.8.0.9.0 版
- 已驗證與 Pangle SDK 5.8.0.9 版的相容性。
- 將 Google Mobile Ads SDK 最低需求更新至 23.0.0 版。
建構及測試工具:
- Google Mobile Ads SDK 23.0.0 版。
- Pangle SDK 5.8.0.9 版。
5.8.0.7.0 版
- 已驗證與 Pangle SDK 5.8.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.6.0 版。
- Pangle SDK 5.8.0.7 版。
5.8.0.6.0 版
- 已驗證與 Pangle SDK 5.8.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.6.0 版。
- Pangle SDK 5.8.0.6 版。
5.7.0.3.0 版
- 已驗證與 Pangle SDK 5.7.0.3 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.6.0 版。
- Pangle SDK 5.7.0.3 版。
5.7.0.2.0 版
- 已驗證與 Pangle SDK 5.7.0.2 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.6.0 版。
- Pangle SDK 5.7.0.2 版。
5.7.0.1.0 版
- 已驗證與 Pangle SDK 5.7.0.1 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.6.0 版。
- Pangle SDK 5.7.0.1 版。
5.6.0.3.0 版
- 已驗證與 Pangle SDK 5.6.0.3 版相容性。
- 將 Google Mobile Ads SDK 最低需求更新至 22.6.0 版。
建構及測試工具:
- Google Mobile Ads SDK 22.6.0 版。
- Pangle SDK 5.6.0.3 版。
5.5.0.9.0 版
- 將 Google Mobile Ads SDK 最低需求更新至 22.5.0 版。
- 已驗證與 Pangle SDK 5.5.0.9 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.5.0 版。
- Pangle SDK 5.5.0.9 版。
5.5.0.8.0 版
- 已驗證與 Pangle SDK 5.5.0.8 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.3.0 版。
- Pangle SDK 5.5.0.8 版。
5.5.0.7.0 版
- 已驗證與 Pangle SDK 5.5.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.3.0 版。
- Pangle SDK 5.5.0.7 版。
5.5.0.6.0 版
- 這個版本不支援出價應用程式開啟頁面廣告格式,因為這個轉接程式版本已還原為依附於 Google Mobile Ads SDK 22.3.0 版。
- 已驗證與 Pangle SDK 5.5.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.3.0 版。
- Pangle SDK 5.5.0.6 版。
5.5.0.4.0 版
- 新增應用程式開啟頁面廣告格式的出價支援。
- 為出價廣告新增浮水印支援功能。
- 將 Google Mobile Ads SDK 最低需求更新至 22.4.0 版。
- 已驗證與 Pangle SDK 5.5.0.4 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.4.0 版。
- Pangle SDK 5.5.0.4 版。
5.4.1.1.0 版
- 修正轉接程式初始化失敗的問題。
- 已驗證 Pangle SDK 5.4.1.1 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.3.0 版。
- Pangle SDK 5.4.1.1 版。
5.4.0.9.0 版
- 已驗證與 Pangle SDK 5.4.0.9 版的相容性。
- 將 Google Mobile Ads SDK 最低需求更新至 22.3.0 版。
建構及測試工具:
- Google Mobile Ads SDK 22.3.0 版。
- Pangle SDK 5.4.0.9 版。
5.4.0.8.0 版
- 已驗證與 Pangle SDK 5.4.0.8 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.2.0 版。
- Pangle SDK 5.4.0.8 版。
5.3.0.6.0 版
- 已驗證與 Pangle SDK 5.3.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.2.0 版。
- Pangle SDK 5.3.0.6 版。
5.3.0.5.0 版
- 已驗證與 Pangle SDK 5.3.0.5 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.2.0 版。
- Pangle SDK 5.3.0.5 版。
5.3.0.4.0 版
- 已驗證與 Pangle SDK 5.3.0.4 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.2.0 版。
- Pangle SDK 5.3.0.4 版。
5.2.0.7.0 版
- 已驗證與 Pangle SDK 5.2.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.1.0 版。
- Pangle SDK 5.2.0.7 版。
5.2.0.6.0 版
- 已驗證與 Pangle SDK 5.2.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.1.0 版。
- Pangle SDK 5.2.0.6 版。
5.2.0.5.0 版
- 已驗證與 Pangle SDK 5.2.0.5 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.1.0 版。
- Pangle SDK 5.2.0.5 版。
5.2.0.3.0 版
- 新增應用程式開啟頁面廣告、橫幅廣告 (包括 MREC)、插頁式廣告和刊登序列支援功能 獎勵廣告和原生廣告格式
- 已驗證與 Pangle SDK 5.2.0.3 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.0.0 版。
- Pangle SDK 5.2.0.3 版。
5.1.0.9.0 版
- 已驗證與 Pangle SDK 5.1.0.9 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.0.0 版。
- Pangle SDK 5.1.0.9 版。
5.1.0.8.0 版
- 已驗證與 Pangle SDK 5.1.0.8 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 22.0.0 版。
- Pangle SDK 5.1.0.8 版。
5.1.0.6.0 版
- 已更新轉接程式,以便使用新的
VersionInfo
類別。 - 將 Google Mobile Ads SDK 最低需求更新至 22.0.0 版。
建構及測試工具:
- Google Mobile Ads SDK 22.0.0 版。
- Pangle SDK 5.1.0.6 版。
5.0.1.1.0 版
- 已驗證與 Pangle SDK 5.0.1.1 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.5.0 版。
- Pangle SDK 5.0.1.1 版。
5.0.1.0.0 版
- 已驗證與 Pangle SDK 5.0.1.0 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.5.0 版。
- Pangle SDK 5.0.1.0 版。
5.0.0.9.0 版
- 已驗證與 Pangle SDK 5.0.0.9 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.5.0 版。
- Pangle SDK 5.0.0.9 版。
5.0.0.8.0 版
- 已驗證與 Pangle SDK 5.0.0.8 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.5.0 版。
- Pangle SDK 5.0.0.8 版。
5.0.0.7.0 版
- 已驗證與 Pangle SDK 5.0.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.5.0 版。
- Pangle SDK 5.0.0.7 版。
5.0.0.6.0 版
- 已驗證與 Pangle SDK 5.0.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.5.0 版。
- Pangle SDK 5.0.0.6 版。
版本 4.9.0.9.0
- 已驗證 Pangle SDK 4.9.0.9 版相容性。
- 將 Google Mobile Ads SDK 最低要求版本更新為 21.5.0。
建構及測試工具:
- Google Mobile Ads SDK 21.5.0 版。
- Pangle SDK 4.9.0.9 版。
版本 4.9.0.8.0
- 已驗證 Pangle SDK 4.9.0.8 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.4.0 版。
- Pangle SDK 4.9.0.8 版。
版本 4.9.0.7.0
- 已驗證與 Pangle SDK 4.9.0.7 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.4.0 版。
- Pangle SDK 4.9.0.7 版。
版本 4.9.0.6.0
- 已驗證與 Pangle SDK 4.9.0.6 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.4.0 版。
- Pangle SDK 4.9.0.6 版。
版本 4.8.1.0.0
- 已驗證 Pangle SDK 4.8.1.0 版相容性。
- 將 Google Mobile Ads SDK 最低需求版本更新為 21.4.0。
建構及測試工具:
- Google Mobile Ads SDK 21.4.0 版。
- Pangle SDK 4.8.1.0 版。
版本 4.8.0.9.0
- 已驗證與 Pangle SDK 4.8.0.9 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.3.0 版。
- Pangle SDK 4.8.0.9 版。
版本 4.8.0.8.0
- 已驗證 Pangle SDK 4.8.0.8 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.3.0 版。
- Pangle SDK 4.8.0.8 版。
版本 4.8.0.7.0
- 已驗證與 Pangle SDK 4.8.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.3.0 版。
- Pangle SDK 4.8.0.7 版。
版本 4.8.0.6.0
- 已驗證與 Pangle SDK 4.8.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.3.0 版。
- Pangle SDK 4.8.0.6 版。
版本 4.7.0.7.0
- 已驗證與 Pangle SDK 4.7.0.7 版相容性。
- 將 Google Mobile Ads SDK 最低需求更新至 21.3.0 版。
建構及測試工具:
- Google Mobile Ads SDK 21.3.0 版。
- Pangle SDK 4.7.0.7 版。
版本 4.7.0.6.0
- 已驗證與 Pangle SDK 4.7.0.6 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.2.0 版。
- Pangle SDK 4.7.0.6 版。
版本 4.7.0.5.0
- 已驗證與 Pangle SDK 4.7.0.5 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.2.0 版。
- Pangle SDK 4.7.0.5 版。
版本 4.7.0.3.0
- 已驗證與 Pangle SDK 4.7.0.3 版相容性。
- 轉接程式現在會嘗試在載入廣告前初始化 Pangle SDK。
建構及測試工具:
- Google Mobile Ads SDK 21.2.0 版。
- Pangle SDK 4.7.0.3 版。
版本 4.6.0.9.0
- 已驗證與 Pangle SDK 4.6.0.9 版相容性。
- 將 Google Mobile Ads SDK 最低需求更新至 21.2.0 版。
建構及測試工具:
- Google Mobile Ads SDK 21.2.0 版。
- Pangle SDK 4.6.0.9 版。
版本 4.5.0.6.1
- 新增原生廣告格式的出價支援。
- 將 Google Mobile Ads SDK 最低需求更新至 21.1.0 版。
建構及測試工具:
- Google Mobile Ads SDK 21.1.0 版。
- Pangle SDK 4.5.0.6 版。
版本 4.5.0.6.0
- 已驗證 Pangle SDK 4.5.0.6 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.0.0 版。
- Pangle SDK 4.5.0.6 版。
4.5.0.5.0 版
- 已驗證 Pangle SDK 4.5.0.5 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.0.0 版。
- Pangle SDK 4.5.0.5 版。
版本 4.5.0.4.0
- 已驗證 Pangle SDK 4.5.0.4 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 21.0.0 版。
- Pangle SDK 4.5.0.4 版。
4.5.0.3.0 版
- 已驗證 Pangle SDK 4.5.0.3 版相容性。
- 已將
compileSdkVersion
和targetSdkVersion
更新至 API 31。 - 將 Google Mobile Ads SDK 最低需求更新至 21.0.0 版。
- 將 Android API 級別最低需求更新為 19。
建構及測試工具:
- Google Mobile Ads SDK 21.0.0 版。
- Pangle SDK 4.5.0.3 版。
4.3.0.9.0 版
- 已驗證與 Pangle SDK 4.3.0.9 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 20.6.0 版。
- Pangle SDK 4.3.0.9 版。
版本 4.3.0.8.0
- 已驗證 Pangle SDK 4.3.0.8 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 20.6.0 版。
- Pangle SDK 4.3.0.8 版。
版本 4.3.0.7.0
- 已驗證與 Pangle SDK 4.3.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 20.6.0 版。
- Pangle SDK 4.3.0.7 版。
版本 4.3.0.6.0
- 已驗證與 Pangle SDK 4.3.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 20.6.0 版。
- Pangle SDK 4.3.0.6 版。
4.3.0.4.0 版
- 已驗證 Pangle SDK 4.3.0.4 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 20.6.0 版。
- Pangle SDK 4.3.0.4 版。
4.2.5.3.0 版
- 初始版本!
- 新增橫幅廣告 (包括 MREC)、插頁式廣告和獎勵廣告格式的出價支援功能。
建構及測試工具:
- Google Mobile Ads SDK 20.6.0 版。
- Pangle SDK 4.2.5.3 版。