本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 使用 從 Pangle 投放廣告 AdMob 中介服務, 包括刊登序列和出價整合內容涵蓋如何將 Pangle 加到 廣告單元的中介服務設定,以及如何整合 Pangle SDK 插入 iOS 應用程式。
支援的整合項目和廣告格式
Pangle 的中介服務轉接程式具備下列功能:
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
應用程式開啟頁面廣告 | 1 |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
插頁式獎勵廣告 | |
原生 |
需求條件
- iOS 部署目標為 10.0 以上版本
最新版 Google Mobile Ads SDK
完成中介服務 入門指南
步驟 1:在 Pangle UI 中進行設定
新增應用程式
前往「Applications」分頁,然後按一下「Add App」按鈕。
選取您要建立應用程式的「作業系統」,並填寫表單的其餘部分。然後按一下「提交」。
記下應用程式的應用程式 ID。
建立廣告刊登位置
應用程式建立完成後,按一下「新增」按鈕建立廣告刊登位置。
出價
選取「廣告格式」和「廣告刊登位置名稱」,然後選取「應用程式內出價」做為定價類型。填寫表單的其他部分,然後按一下「Submit」。
建立廣告刊登位置後,請記下廣告刊登位置 ID。
瀑布
選取「廣告格式」和「廣告刊登位置名稱」,以及「全球千次曝光出價」做為「定價類型」。填寫表單的其他部分,然後按一下「Submit」。
建立廣告刊登位置後,請記下廣告刊登位置 ID。
找出 Pangle Reporting API 金鑰
出價
整合出價時不需要執行這個步驟。
瀑布
記下頁面左下角的「User ID」。
依序按一下「Integrations」 >「SDK & API」 >「Pangle Reporting API 2.0」。請記下「角色 ID」和「安全金鑰」。
開啟測試模式
按照 Pangle 的「如何新增測試廣告」指南中的操作說明啟用 Pangle 測試廣告。
步驟 2:在使用者介面中設定 Pangle 需求 AdMob
調整廣告單元中介服務設定
您需要將 Pangle 新增至廣告單元的中介服務設定。
首先,請登入 AdMob 帳戶。接著,前往「中介服務」分頁。如果您想修改現有的中介服務群組,請按一下中介服務群組的名稱加以編輯,然後跳到「新增為廣告來源」一節。 Pangle
如要建立新的中介服務群組,請選取「建立中介服務群組」。
輸入廣告格式和平台,然後按一下「繼續」。
為中介服務群組命名,然後選取要指定的地區。接著,將中介服務群組狀態設為「已啟用」,然後按一下「新增廣告單元」。
將這個中介服務群組與一或多個現有AdMob 廣告單元建立關聯。接著點選「完成」。
您現在應該會看到已填入所選廣告單元的廣告單元資訊卡:
新增 Pangle 做為廣告來源
出價
在「廣告來源」區段的「出價」資訊卡下方,選取「新增廣告來源」。然後選取 Pangle。
按一下「如何簽署合作夥伴協議」,並與Pangle建立出價合作夥伴關係。
按一下「確認並同意」,然後點選「繼續」。
如果 Pangle已有對應關係,可以選取該對應關係。否則請按一下「新增對應」。
接著,輸入上一節取得的 App ID and Ad Placement ID。接著點選「完成」。
重要事項: App ID 必須與Pangle UI 中的指定應用程式建立關聯。瀑布
在「Ad Source」部分的「Waterfall」資訊卡下方,選取「Add Ad Source」。然後選取 Pangle。
選取「Pangle」。 接著為Pangle 輸入有效千次曝光出價值,然後按一下「繼續」。如果 Pangle已有對應關係,可以選取該對應關係。否則請按一下「新增對應」。
接著,輸入上一節取得的 App ID and Ad Placement ID。接著點選「完成」。
步驟 3:匯入 Pangle SDK 和轉接程式
使用 CocoaPods (建議)
在專案的 Podfile 中新增下列程式碼:
pod 'GoogleMobileAdsMediationPangle'
從指令列執行下列指令:
pod install --repo-update
手動整合
- 下載最新版本的
適用於 iOS 的 Pangle SDK
並連結專案中所有
.framework
檔案和套件。 - 從下列位置的下載連結下載最新版 Pangle 轉接器:
變更記錄和連結
PangleAdapter.xcframework
。
步驟 4:新增必要的程式碼
SKAdNetwork 整合
遵循 Pangle 說明文件
在專案的 Info.plist
檔案中新增 SKAdNetwork ID。
步驟 5:測試實作成果
啟用測試廣告
請務必為AdMob 註冊測試裝置,並在 Pangle 使用者介面中啟用測試模式。
驗證測試廣告
如要確認您正在接收來自Pangle的測試廣告,請使用 Pangle (Bidding) and Pangle (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。
選擇性步驟
原生廣告
廣告顯示
Pangle 轉接程式會傳回原生廣告
GADNativeAd
如需儲存大量結構化物件
建議使用 Cloud Bigtable會填入以下項目
欄位
的
GADNativeAd
。
欄位 | 一律由 Pangle 轉接器納入素材資源 |
---|---|
廣告標題 | |
圖片 | 1 |
內文 | |
圖示 | |
行動號召 | |
星級評等 | |
商店 | |
價格 | |
廣告主 |
1 Pangle 轉接器未
可讓使用者直接存取原生廣告的主要圖片素材資源。相反地
轉接程式會填入
GADMediaView
包含影片或圖片
錯誤代碼
如果轉接程式無法接收來自 Pangle 的廣告,您可以查看
判斷錯誤的原因
GADResponseInfo.adNetworkInfoArray
敬上
加入以下類別:
GADMediationAdapterPangle
以下是 Pangle 轉接器擲回的代碼和隨附訊息 如果發生以下情形,則代表廣告無法載入:
錯誤代碼 | 網域 | 原因 |
---|---|---|
101 | com.google.ads.mediation.pangle | 伺服器參數無效 (例如缺少應用程式 ID 或刊登位置 ID)。 |
102 | com.google.ads.mediation.pangle | 要求的廣告大小與支援 Pangle 的橫幅廣告大小不符。 |
-1-60000 | 由 Pangle SDK 傳送 | Pangle SDK 傳回錯誤。詳情請參閱 Pangle 的說明文件。 |
Pangle iOS 中介服務轉接程式變更記錄
6.1.0.6.0 版
- 已驗證與 Pangle SDK 6.1.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 11.7.0 版。
- Pangle SDK 6.1.0.6 版。
6.1.0.5.0 版
- 已驗證與 Pangle SDK 6.1.0.5 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 11.6.0 版。
- Pangle SDK 6.1.0.5 版。
6.1.0.4.0 版
- 已驗證與 Pangle SDK 6.1.0.4 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 11.6.0 版。
- Pangle SDK 6.1.0.4 版。
6.0.0.6.0 版
- 已驗證與 Pangle SDK 6.0.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 11.6.0 版。
- Pangle SDK 6.0.0.6 版。
6.0.0.5.0 版
- 已驗證與 Pangle SDK 6.0.0.5 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 11.5.0 版。
- Pangle SDK 6.0.0.5 版。
6.0.0.4.0 版
- 已驗證與 Pangle SDK 6.0.0.4 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 11.5.0 版。
- Pangle SDK 6.0.0.4 版。
5.9.0.9.0 版
- 已驗證與 Pangle SDK 5.9.0.9 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 11.5.0 版。
- Pangle SDK 5.9.0.9 版。
5.9.0.8.0 版
- 已驗證與 Pangle SDK 5.9.0.8 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 11.4.0 版。
- Pangle SDK 5.9.0.8 版。
5.9.0.7.0 版
- 已驗證與 Pangle SDK 5.9.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 11.3.0 版。
- Pangle SDK 5.9.0.7 版。
5.8.0.8.0 版
- 已驗證與 Pangle SDK 5.8.0.8 版的相容性。
- 已更新轉接程式,以便使用新的 Pangle SDK 信號收集 API。
建構及測試工具:
- Google Mobile Ads SDK 11.2.0 版。
- Pangle SDK 5.8.0.8 版。
5.8.0.7.0 版
- 已驗證與 Pangle SDK 5.8.0.7 版的相容性。
- 現在最低版本需求為 iOS 12.0。
- 現在需要 Google Mobile Ads SDK 11.0 以上版本。
- 將
Info.plist
包含在PangleAdapter.xcframework
內的架構中。
建構及測試工具:
- Google Mobile Ads SDK 11.0.1 版。
- Pangle SDK 5.8.0.7 版。
5.7.0.7.0 版
- 已驗證與 Pangle SDK 5.7.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.14.0 版。
- Pangle SDK 5.7.0.7 版。
5.7.0.6.0 版
- 已驗證與 Pangle SDK 5.7.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.14.0 版。
- Pangle SDK 5.7.0.6 版。
5.6.0.8.0 版
- 已驗證與 Pangle SDK 5.6.0.8 版相容性。
- 以新的
GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment
屬性取代已淘汰的adConfiguration.childDirectedTreatment
屬性,重構+setCOPPA
方法。
建構及測試工具:
- Google Mobile Ads SDK 10.14.0 版。
- Pangle SDK 5.6.0.8 版。
5.5.0.9.0 版
- 已驗證與 Pangle SDK 5.5.0.9 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.13.0 版。
- Pangle SDK 5.5.0.9 版。
5.5.0.7.0 版
- 已驗證與 Pangle SDK 5.5.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.12.0 版。
- Pangle SDK 5.5.0.7 版。
5.5.0.5.0 版
- 已驗證與 Pangle SDK 5.5.0.5 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.11.0 版。
- Pangle SDK 5.5.0.5 版。
5.4.1.1.0 版
- 新增應用程式開啟頁面廣告格式的出價支援。
- 已驗證 Pangle SDK 5.4.1.1 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.10.0 版。
- Pangle SDK 5.4.1.1 版。
5.4.0.9.0 版
- 已驗證與 Pangle SDK 5.4.0.9 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.9.0 版。
- Pangle SDK 5.4.0.9 版。
5.4.0.8.0 版
- 已修正
GADPangleNetworkExtras
不符合GADAdNetworkExtras
通訊協定的問題。 - 已在插頁式廣告、獎勵和應用程式開啟頁面廣告中導入
adDidShowFail
通訊協定方法。 - 已驗證與 Pangle SDK 5.4.0.8 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.9.0 版。
- Pangle SDK 5.4.0.8 版。
5.3.1.2.0 版
- 已驗證 Pangle SDK 5.3.1.2 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.8.0 版。
- Pangle SDK 5.3.1.2 版。
5.3.1.0.0 版
- 已驗證與 Pangle SDK 5.3.1.0 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.8.0 版。
- Pangle SDK 5.3.1.0 版。
5.2.1.1.0 版
- 已驗證 Pangle SDK 5.2.1.1 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.7.0 版。
- Pangle SDK 5.2.1.1 版。
5.2.0.9.0 版
- 已驗證與 Pangle SDK 5.2.0.9 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.5.0 版。
- Pangle SDK 5.2.0.9 版。
5.2.0.8.0 版
- 已驗證與 Pangle SDK 5.2.0.8 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.5.0 版。
- Pangle SDK 5.2.0.8 版。
5.2.0.7.0 版
- 針對應用程式開啟頁面廣告、橫幅廣告 (包括 MREC)、插頁式廣告、獎勵廣告和原生廣告格式,新增刊登序列支援功能。
- 已驗證與 Pangle SDK 5.2.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.5.0 版。
- Pangle SDK 5.2.0.7 版。
5.2.0.6.0 版
- 已驗證與 Pangle SDK 5.2.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.5.0 版。
- Pangle SDK 5.2.0.6 版。
5.1.1.0.0 版
- 已驗證與 Pangle SDK 5.1.1.0 版的相容性。
- 新增對
arm64
模擬架構的支援。 - 現在需要 Google Mobile Ads SDK 10.4.0 以上版本。
建構及測試工具:
- Google Mobile Ads SDK 10.4.0 版。
- Pangle SDK 5.1.1.0 版。
5.1.0.6.0 版
- 已驗證與 Pangle SDK 5.1.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.3.0 版。
- Pangle SDK 5.1.0.6 版。
5.0.1.0.0 版
- 已驗證與 Pangle SDK 5.0.1.0 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.2.0 版。
- Pangle SDK 5.0.1.0 版。
5.0.0.8.0 版
- 已驗證與 Pangle SDK 5.0.0.8 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.2.0 版。
- Pangle SDK 5.0.0.8 版。
5.0.0.7.0 版
- 已驗證與 Pangle SDK 5.0.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.1.0 版。
- Pangle SDK 5.0.0.7 版。
5.0.0.6.0 版
- 已驗證與 Pangle SDK 5.0.0.6 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 10.1.0 版。
- Pangle SDK 5.0.0.6 版。
4.9.1.0.0 版
- 已停止支援
armv7
架構。 - 已驗證與 Pangle SDK 4.9.1.0 版相容性。
- 現在最低版本需求為 iOS 12.0 以上版本。
- 現在需要 Google Mobile Ads SDK 10.0.0 以上版本。
建構及測試工具:
- Google Mobile Ads SDK 10.0.0 版。
- Pangle SDK 4.9.1.0 版。
4.9.0.8.0 版
- 已驗證 Pangle SDK 4.9.0.8 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.14.0 版。
- Pangle SDK 4.9.0.8 版。
4.9.0.7.0 版
- 已驗證與 Pangle SDK 4.9.0.7 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.14.0 版。
- Pangle SDK 4.9.0.7 版。
4.9.0.6.0 版
- 已驗證 Pangle SDK 4.9.0.6 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.14.0 版。
- Pangle SDK 4.9.0.6 版。
4.8.1.0.0 版
- 已驗證 Pangle SDK 4.8.1.0 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.14.0 版。
- Pangle SDK 4.8.1.0 版。
4.8.0.9.0 版
- 已驗證與 Pangle SDK 4.8.0.9 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.13.0 版。
- Pangle SDK 4.8.0.9 版。
4.8.0.7.0 版
- 已驗證與 Pangle SDK 4.8.0.7 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.13.0 版。
- Pangle SDK 4.8.0.7 版。
4.8.0.6.0 版
- 已驗證與 Pangle SDK 4.8.0.6 版的相容性。
- 修正問題:載入原生廣告圖示圖片時,主執行緒遭到封鎖。
建構及測試工具:
- Google Mobile Ads SDK 9.13.0 版。
- Pangle SDK 4.8.0.6 版。
4.7.0.7.0 版
- 已驗證與 Pangle SDK 4.7.0.7 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.11.0 版。
- Pangle SDK 4.7.0.7 版。
4.7.0.6.0 版
- 已驗證與 Pangle SDK 4.7.0.6 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.11.0 版。
- Pangle SDK 4.7.0.6 版。
4.7.0.5.0 版
- 已驗證與 Pangle SDK 4.7.0.5 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.11.0 版。
- Pangle SDK 4.7.0.5 版。
4.7.0.4.0 版
- 已驗證與 Pangle SDK 4.7.0.4 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.10.0 版。
- Pangle SDK 4.7.0.4 版。
4.6.2.2.0 版
- 已將
GADMediationAdapterPangle
類別的setGDPR()
和setCCPA()
方法分別重新命名為setGDPRConsent()
和setDoNotSell
。 - 已驗證 Pangle SDK 4.6.2.2 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.10.0 版。
- Pangle SDK 4.6.2.2 版。
4.6.1.8.0 版
- 已驗證 Pangle SDK 4.6.1.8 版相容性。
- 新增原生廣告格式的出價支援。
- 更新轉接器以使用
didRewardUser
API。 - 現在需要 Google Mobile Ads SDK 9.8.0 以上版本。
建構及測試工具:
- Google Mobile Ads SDK 9.9.0 版。
- Pangle SDK 4.6.1.8 版。
4.5.2.8.0 版
- 已驗證 Pangle SDK 4.5.2.8 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.7.0 版。
- Pangle SDK 4.5.2.8 版。
4.5.2.7.0 版
- 已驗證 Pangle SDK 4.5.2.7 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.7.0 版。
- Pangle SDK 4.5.2.7 版。
4.5.2.5.0 版
- 已驗證 Pangle SDK 4.5.2.5 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.6.0 版。
- Pangle SDK 4.5.2.5 版。
4.5.2.4.0 版
- 已驗證 Pangle SDK 4.5.2.4 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.6.0 版。
- Pangle SDK 4.5.2.4 版。
4.5.2.3.0 版
- 已驗證 Pangle SDK 4.5.2.3 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.6.0 版。
- Pangle SDK 4.5.2.3 版。
4.5.1.3.0 版
- 已驗證 Pangle SDK 4.5.1.3 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.5.0 版。
- Pangle SDK 4.5.1.3 版。
4.3.1.9.0 版
- 已驗證 Pangle SDK 4.3.1.9 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.3.0 版。
- Pangle SDK 4.3.1.9 版。
4.3.0.5.0 版
- 已驗證 Pangle SDK 4.3.0.5 版相容性。
建構及測試工具:
- Google Mobile Ads SDK 9.2.0 版。
- Pangle SDK 4.3.0.5 版。
4.3.0.4.0 版
- 初始版本!
- 新增橫幅廣告 (包括 MREC)、插頁式廣告和獎勵廣告格式的出價支援功能。
建構及測試工具:
- Google Mobile Ads SDK 9.1.0 版。
- Pangle SDK 4.3.0.4 版。