將 Pangle 與中介服務整合

本指南說明如何使用 Google Mobile Ads SDK，透過中介服務載入及顯示 Pangle 廣告，涵蓋瀑布流和競價整合。本文說明如何將 Pangle 新增至廣告單元的中介服務設定，以及如何將 Pangle SDK 和轉接程式整合至 Unity 應用程式。

支援的整合功能和廣告格式

Pangle 適用的 AdMob 中介服務轉接程式具備下列功能：

需求條件

• 最新版 Google Mobile Ads SDK
• Unity 5.6 以上版本
• [出價]：如要整合出價功能支援的所有廣告格式，請使用 Pangle 適用的 Google 行動廣告中介服務外掛程式 2.4.0 以上版本 (建議使用最新版本)
• 如要在 Android 裝置上部署，請按照下列步驟操作：
  • Android API 級別 23 以上
• 如要在 iOS 裝置上部署，請按照下列步驟操作：
  • iOS 部署目標為 12.0 以上版本
• 已設定 Google Mobile Ads SDK 的正常運作 Unity 專案。詳情請參閱「開始使用」一文。
• 完成中介服務入門指南

步驟 1：在 Pangle 使用者介面中設定

註冊或登入 Pangle 帳戶。

新增應用程式

前往「應用程式」分頁，然後按一下「新增應用程式」按鈕。

選取要建立應用程式的作業系統，然後填妥表單其餘部分。然後按一下「提交」。

記下應用程式的應用程式 ID。

建立廣告刊登位置

建立應用程式後，按一下「新增」按鈕，即可建立廣告刊登位置。

找出 Pangle Reporting API 金鑰

更新 app-ads.txt

Authorized Sellers for Apps (簡稱 app-ads.txt) 是美國互動廣告協會科技實驗室 (IAB Tech Lab) 主持的一項計畫，旨在確保您的應用程式廣告空間只透過獲得您授權的管道出售。為避免廣告收益大幅減少，您必須導入 app-ads.txt 檔案。 如果您尚未設定，請為應用程式設定 app-ads.txt 檔案。

如要為 Pangle 導入 app-ads.txt，請參閱「如何將 Pangle 新增至 app-ads.txt 檔案」。

開啟測試模式

請按照 Pangle 的「如何加入測試廣告」指南操作，啟用 Pangle 測試廣告。

步驟 2：在 AdMob 使用者介面中設定 Pangle 需求

設定廣告單元的中介服務設定

將 Pangle DSP 新增至 GDPR 和美國州級法規廣告合作夥伴名單

請按照「歐洲法規設定」和「美國州級法規設定」中的步驟，在 AdMob 使用者介面中，將 Pangle DSP 新增至歐洲和美國州級法規廣告合作夥伴清單。

步驟 3：匯入 Pangle SDK 和轉接程式

openupm add com.google.ads.mobile.mediation.pangle

步驟 4：在 Pangle SDK 中導入隱私權設定

歐盟地區同意授權和 GDPR

根據 Google《歐盟地區使用者同意授權政策》，您必須確保向歐洲經濟區境內使用者揭露裝置 ID 和個人資料的使用方式，並徵得同意聲明。本政策是配合《歐盟地區電子通訊隱私指令》和《一般資料保護規則》(GDPR) 而制定。徵求同意聲明時，您必須指明中介服務鏈中可能會收集、接收或使用個人資料的每個廣告聯播網，並提供各聯播網的使用方式資訊。Google 目前無法自動將使用者的同意聲明選項傳送給這類聯播網。

Pangle 適用的 Google Mobile Ads 中介服務外掛程式包含 Pangle.SetGDPRConsent() 方法。下列程式碼範例說明如何將同意聲明資訊傳遞至 Pangle SDK。請先設定同意聲明資訊，再初始化 Google Mobile Ads SDK，確保這些資訊能正確轉送至 Pangle SDK。

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetGDPRConsent(0);

如要瞭解詳情和各方法可提供的值，請參閱 Pangle 的整合指南。

美國州級隱私權法律

美國各州隱私權法規定，使用者有權選擇拒絕「販售」其「個人資訊」(如該法案對「販售」與「個人資訊」這兩個詞的定義)，且「賣方」必須在首頁上提供顯眼的「請勿銷售我的個人資訊」連結，供使用者使用。《美國州級隱私權法律法規遵循指南》提供啟用 Google 廣告放送「受限的資料處理」模式的功能，但 Google 無法將這項設定套用至中介服務鏈中的每個廣告聯播網。因此，您必須找出中介服務鏈中可能參與銷售個人資訊的每個廣告聯播網，並遵循這些聯播網的指引，確保符合規定。

Pangle 適用的 Google Mobile Ads 中介服務外掛程式包含 Pangle.SetPAConsent() 方法。下列程式碼範例說明如何將同意聲明資訊傳遞至 Pangle SDK。請先設定同意聲明資訊，再初始化 Google Mobile Ads SDK，確保這些資訊能正確轉送至 Pangle SDK。

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetPAConsent(0);

如要瞭解詳情和各方法可提供的值，請參閱 Pangle 的整合指南。

步驟 5：新增必要程式碼

步驟 6：測試實作成果

啟用測試廣告

請務必註冊測試裝置，以便在 AdMob 中使用，並在 Pangle 使用者介面中啟用測試模式。

驗證測試廣告

如要確認您收到 Pangle 的測試廣告，請使用「Pangle (出價)」和「Pangle (刊登序列)」廣告來源，在廣告檢查器中啟用單一廣告來源測試。

錯誤代碼

如果中介服務介面卡無法從 Pangle 接收廣告，發布商可以使用以下類別下的 ResponseInfo，從廣告回應中檢查基礎錯誤：

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

GADMediationAdapterPangle

以下是廣告無法載入時，Pangle 轉接程式碼擲回的代碼和隨附訊息：

Pangle Unity 中介服務外掛程式變更記錄

5.1.1 版

• 支援 Pangle Android 轉接程式 7.2.0.6.0 版。
• 支援 Pangle iOS 轉接程式 7.2.0.5.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 10.2.0 版建構及測試。

5.1.0 版

• 支援 Pangle Android 轉接程式 7.2.0.4.0 版。
• 支援 Pangle iOS 轉接程式 7.2.0.4.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 10.2.0 版建構及測試。

5.0.0 版

• 將 SetDoNotSell() 替換為 Pangle 類別中的 SetPAConsent()。
  • 傳遞至 SetDoNotSell() 的值可能不適合 SetPAConsent()。請確認傳遞至 SetPAConsent() 的值正確無誤。 如要瞭解可為 PA 同意聲明設定的值，請參閱 https://www.pangleglobal.com/integration/android-initialize-pangle-sdk。
• 支援 Pangle Android 轉接程式 7.1.0.8.0 版。
• 支援 Pangle iOS 轉接程式 7.1.1.1.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 10.1.0 版建構及測試。

4.6.2 版

• 支援 Pangle Android 轉接程式 6.5.0.9.0 版。
• 支援 Pangle iOS 轉接程式 6.5.0.9.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 10.1.0 版建構及測試。

4.6.1 版

• 支援 Pangle Android 轉接程式 6.5.0.8.0 版。
• 支援 Pangle iOS 轉接程式 6.5.0.9.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 10.0.0 版建構及測試。

4.6.0 版

• 支援 Pangle Android 轉接程式 6.5.0.6.0 版。
• 支援 Pangle iOS 轉接程式 6.5.0.9.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 10.0.0 版建構及測試。

4.5.4 版

• 支援 Pangle Android 轉接程式 6.4.0.6.0 版。
• 支援 Pangle iOS 轉接程式 6.4.1.1.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.5.0 版建構及測試。

4.5.3 版

• 支援 Pangle Android 轉接程式 6.4.0.5.0 版。
• 支援 Pangle iOS 轉接程式 6.4.1.0.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.5.0 版建構及測試。

4.5.2 版

• 支援 Pangle Android 轉接程式 6.4.0.4.0 版。
• 支援 Pangle iOS 轉接程式 6.4.0.8.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.5.0 版建構及測試。

4.5.1 版

• 支援 Pangle Android 轉接程式 6.4.0.3.0 版。
• 支援 Pangle iOS 轉接程式 6.4.0.7.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.5.0 版建構及測試。

4.5.0 版

• 支援 Pangle Android 轉接程式 6.4.0.2.0 版。
• 支援 Pangle iOS 轉接程式 6.4.0.6.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.5.0 版建構及測試。

4.4.2 版

• 支援 Pangle Android 轉接程式 6.3.0.4.0 版。
• 支援 Pangle iOS 轉接程式 6.3.1.0.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.4.0 版建構及測試。

4.4.1 版

• 支援 Pangle Android 轉接程式 6.3.0.4.0 版。
• 支援 Pangle iOS 轉接程式 6.3.0.8.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.3.0 版建構及測試。

4.4.0 版

• 支援 Pangle Android 轉接程式 6.3.0.2.0 版。
• 支援 Pangle iOS 轉接程式 6.3.0.6.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.3.0 版建構及測試。

4.3.3 版

• 支援 Pangle Android 轉接程式 6.2.0.7.0 版。
• 支援 Pangle iOS 轉接程式 6.2.0.9.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.2.1 版建構及測試。

4.3.2 版

• 支援 Pangle Android 轉接程式 6.2.0.6.0 版。
• 支援 Pangle iOS 轉接程式 6.2.0.8.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版建構及測試。

4.3.1 版

• 支援 Pangle Android 轉接程式 6.2.0.5.0 版。
• 支援 Pangle iOS 轉接程式 6.2.0.7.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版建構及測試。

4.3.0 版

• 支援 Pangle Android 轉接程式 6.2.0.4.0 版。
• 支援 Pangle iOS 轉接程式 6.2.0.5.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版建構及測試。

4.2.1 版

• 支援 Pangle Android 轉接程式 6.1.0.7.0 版。
• 支援 Pangle iOS 轉接程式 6.1.0.6.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版建構及測試。

4.2.0 版

• DummyClient 已重新命名為 PlaceholderClient。
• 支援 Pangle Android 轉接程式 6.1.0.6.0 版。
• 支援 Pangle iOS 轉接程式 6.1.0.5.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版建構及測試。

4.1.0 版

• 支援 Pangle Android 轉接程式 6.0.0.8.0 版。
• 支援 Pangle iOS 轉接程式 6.1.0.5.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.1.1 版建構及測試。

4.0.1 版

• 支援 Pangle Android 轉接程式 6.0.0.5.0 版。
• 支援 Pangle iOS 轉接程式 6.0.0.6.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建構及測試。

4.0.0 版

• 支援 Pangle Android 轉接程式 6.0.0.5.0 版。
• 支援 Pangle iOS 轉接程式 6.0.0.5.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建構及測試。

3.0.0 版

• 支援 Pangle Android 轉接程式 6.0.0.3.0 版。
• 支援 Pangle iOS 轉接程式 5.9.0.9.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建構及測試。

2.8.1 版

• 支援 Pangle Android 轉接程式 5.9.0.6.0 版。
• 支援 Pangle iOS 轉接程式 5.9.0.8.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建構及測試。

2.8.0 版

• 支援 Pangle Android 轉接程式 5.9.0.4.0 版。
• 支援 Pangle iOS 轉接程式 5.9.0.7.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建構及測試。

2.7.0 版

• 支援 Pangle Android 轉接程式 5.9.0.2.0 版。
• 支援 Pangle iOS 轉接程式 5.8.0.8.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建構及測試。

2.6.0 版

• 支援 Pangle Android 轉接程式 5.8.0.9.0 版。
• 支援 Pangle iOS 轉接程式 5.8.0.8.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 9.0.0 版建構及測試。

2.5.0 版

• 支援 Pangle Android 轉接程式 5.7.0.1.0 版。
• 支援 Pangle iOS 轉接程式 5.7.0.7.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 8.6.0 版建構及測試。

2.4.0 版

• 支援 Pangle Android 轉接程式 5.5.0.9.0 版。
• 支援 Pangle iOS 轉接程式 5.5.0.9.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 8.6.0 版建構及測試。

2.3.0 版

• 支援 Pangle Android 轉接程式 5.3.0.6.0 版。
• 支援 Pangle iOS 轉接程式 5.3.1.2.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 8.4.1 版建構及測試。

2.2.0 版

• 支援 Pangle Android 轉接程式 5.2.0.6.0 版。
• 支援 Pangle iOS 轉接程式 5.2.0.9.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 8.3.0 版建構及測試。

2.1.0 版

• 支援 Pangle Android 轉接程式 5.1.0.9.0 版。
• 支援 Pangle iOS 轉接程式 5.1.1.0.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 8.1.0 版建構及測試。

2.0.0 版

• 已將轉接頭內容移至 GoogleMobileAds/Mediation/Pangle/。
• 重構轉接程式命名空間，以使用 GoogleMobileAds.Mediation.Pangle。
• 支援 Pangle Android 轉接程式 5.0.0.7.0 版。
• 支援 Pangle iOS 轉接程式 5.0.0.6.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 7.4.1 版建構及測試。

1.5.1 版

• 支援 Pangle Android 轉接程式 4.9.0.7.0 版。
• 支援 Pangle iOS 轉接程式 4.9.0.8.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 7.4.0 版建構及測試。

1.5.0 版

• 支援 Pangle Android 轉接程式 4.9.0.6.0 版。
• 支援 Pangle iOS 轉接程式 4.9.0.7.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 7.3.1 版建構及測試。

1.4.0 版

• 支援 Pangle Android 轉接程式 4.8.1.0.0 版。
• 支援 Pangle iOS 轉接程式 4.8.1.0.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 7.3.1 版建構及測試。

1.3.1 版

• 支援 Pangle Android 轉接程式 4.7.0.6.0 版。
• 支援 Pangle iOS 轉接程式 4.7.0.6.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 7.2.0 版建構及測試。

1.3.0 版

• Pangle 類別中的下列方法已重新命名：
  • SetGDPR() -> SetGDPRConsent()
  • SetCCPA() -> SetDoNotSell()
• 支援 Pangle Android 轉接程式 4.7.0.5.0 版。
• 支援 Pangle iOS 轉接程式 4.7.0.5.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 7.2.0 版建構及測試。

1.2.0 版

• 支援 Pangle Android 轉接程式 4.5.0.6.1 版。
• 支援 Pangle iOS 轉接程式 4.5.2.8.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 7.1.0 版建構及測試。

1.1.0 版

• 支援 Pangle Android 轉接程式 4.5.0.3.0 版。
• 支援 Pangle iOS 轉接程式 4.5.1.3.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 7.0.2 版建構及測試。

1.0.0 版

• 初始版本！
• 支援 Pangle Android 轉接程式 4.3.0.8.0 版。
• 支援 Pangle iOS 轉接程式 4.3.0.5.0 版。
• 使用 Google 行動廣告 Unity 外掛程式 7.0.0 版建構及測試。