本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 使用 從 Pangle 投放廣告 AdMob 中介服務, 包括刊登序列和出價整合內容涵蓋如何將 Pangle 加到 廣告單元的中介服務設定,以及如何整合 Pangle SDK 插入 iOS 應用程式。
支援的整合項目和廣告格式
Pangle 的中介服務轉接程式具備下列功能:
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
應用程式開啟頁面廣告 | 1 |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
插頁式獎勵廣告 | |
原生 |
需求條件
- iOS 部署目標為 10.0 以上版本
最新版 Google Mobile Ads SDK
完成中介服務 入門指南
步驟 1:在 Pangle UI 中進行設定
步驟 2:在使用者介面中設定 Pangle 需求 AdMob
調整廣告單元中介服務設定
您需要將 Pangle 新增至廣告單元的中介服務設定。
首先,請登入 AdMob 帳戶。接著,前往「中介服務」分頁。如果您想修改現有的中介服務群組,請按一下中介服務群組的名稱加以編輯,然後跳到「新增為廣告來源」一節。 Pangle
如要建立新的中介服務群組,請選取「建立中介服務群組」。
輸入廣告格式和平台,然後按一下「繼續」。
為中介服務群組命名,然後選取要指定的地區。接著,將中介服務群組狀態設為「已啟用」,然後按一下「新增廣告單元」。
將這個中介服務群組與一或多個現有AdMob 廣告單元建立關聯。接著點選「完成」。
您現在應該會看到已填入所選廣告單元的廣告單元資訊卡:
新增 Pangle 做為廣告來源
出價
在「廣告來源」部分的「出價」資訊卡下方,選取「新增」 廣告來源。然後選取 Pangle。
按一下「如何簽署合作夥伴協議」,然後設定出價 合作夥伴 Pangle。
按一下「確認與」同意,然後按一下繼續。
如果您已經有 Pangle的對應關係, 即可選取否則,請按一下「新增對應」。
接著,輸入 App ID and Ad Placement ID 如上一節所述。接著點選「完成」。
瀑布
在「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.2.0.5.0 版
- 已驗證與 Pangle SDK 6.2.0.5 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 11.8.0 版。
- Pangle SDK 6.2.0.5 版。
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 版。