將 Facebook Audience Network 與出價功能整合

本指南旨在協助發布商使用 Google Mobile Ads SDK，透過出價從 Facebook Audience Network 載入及顯示廣告。 其中涵蓋如何將 Facebook Audience Network SDK 和轉接程式整合至 Unity 應用程式。

支援的整合和廣告格式

Facebook Audience Network 的 AdMob 中介服務轉接程式有下列功能：

整合
出價
瀑布
格式
橫幅
插入式檔案
已獲得獎勵
插頁式獎勵廣告

必要條件

  • Unity 5.6 以上版本
  • 最新版 Google Mobile Ads SDK
  • 適用於 Facebook 2.11.0 以上版本的 Google Mobile Ads 中介服務外掛程式
  • 在 Android 上部署
    • Android API 級別 16 或更高版本
  • 在 iOS 上部署
    • iOS 部署目標為 10.0 以上版本
    • 最新的 Facebook Audience Network SDK 通常需要最新版的 Xcode。
  • 使用 Google Mobile Ads SDK 設定的 Unity 專案。詳情請參閱開始使用。

步驟 1：設定 Facebook Audience Network

註冊並前往 Business Manager 起始網頁。

按一下 [Create a new Business Manager account] (建立新的企業管理員帳戶)，並填寫必填欄位。

建立 Facebook 資源

填寫必要資訊後，系統會提示您為應用程式建立資源。請輸入應用程式需要的屬性名稱，然後按一下 [前往營利管理工具]。

接著，選取您要用於營利的平台。

說明您的應用程式是否已上線，然後按一下 [提交]。

Android

iOS

系統會提示您為應用程式建立廣告刊登位置。 選取格式並填寫表單，然後點選 [下一步]。

針對所有橫幅大小 (包括 300x250) 選取 [Banner]。Facebook 不支援在出價中使用 Medium Rectangle 多媒體格式，但支援使用 Banner 顯示格式時，高度為 50、90 或 250 的彈性寬度橫幅。

如果您打算整合插頁式獎勵廣告格式，對應的 Facebook 格式則為 Rewarded Video。

下一個步驟是您建立的刊登位置總覽。並記下「新增刊登位置編號」部分下方的「刊登位置編號」。

步驟 2：為 AdMob 廣告單元調整中介服務設定

您必須在廣告單元的中介服務設定中加入 Facebook。首先，請登入您的 AdMob 帳戶。

Android

前往「中介服務」分頁。如果您有現成的中介服務群組，請按一下該中介服務群組的名稱加以修改，然後直接跳到「新增 Facebook Audience Network 做為廣告來源」一文。

如要建立新的中介服務群組，請選取 [建立中介服務群組]。

輸入您的廣告格式和平台，然後按一下 [繼續]。

為中介服務群組命名，然後選取要指定的地區。 接著，將中介服務群組狀態設為 [已啟用]。接著按一下 [新增廣告單元]，即可開啟廣告單元選取重疊廣告。

將此中介服務群組與您現有的 AdMob 廣告單元建立關聯。 接著按一下 [完成]。「廣告單元」資訊卡中會隨即顯示所選廣告單元

將 Facebook Audience Network 新增為廣告來源

在「廣告來源」資訊卡中，選取 [新增廣告聯播網]。選取 [Facebook Audience Network (Bid)] (Facebook 目標對象聯播網 (出價))。輸入上一節取得的刊登位置 ID，然後按一下 [完成]。

最後，按一下 [儲存]。

iOS

前往「中介服務」分頁。如果您有現成的中介服務群組，請按一下該中介服務群組的名稱加以修改，然後直接跳到「新增 Facebook Audience Network 做為廣告來源」一文。

如要建立新的中介服務群組，請選取 [建立中介服務群組]。

輸入您的廣告格式和平台，然後按一下 [繼續]。

為中介服務群組命名，然後選取要指定的地區。 接著，將中介服務群組狀態設為 [已啟用]。接著按一下 [新增廣告單元]，即可開啟廣告單元選取重疊廣告。

將此中介服務群組與您現有的 AdMob 廣告單元建立關聯。 接著按一下 [完成]。

「廣告單元」資訊卡現在應會填入 選取的廣告單元。

將 Facebook Audience Network 新增為廣告來源

在「廣告來源」資訊卡中，選取 [新增廣告聯播網]。選取 [Facebook Audience Network (Bid)] (Facebook 目標對象聯播網 (出價))。輸入上一節取得的刊登位置 ID，然後按一下 [完成]。

最後，按一下 [儲存]。

使用獎勵廣告

在獎勵廣告單元的設定中，提供獎勵金額和獎勵類型的值。然後，為了確保所放送的每個廣告聯播網都能為使用者提供相同的獎勵，請勾選 [套用到中介服務群組中的所有聯播網] 方塊。

如果您未套用這項設定，Facebook 轉接程式會預設為 "" 類型的獎勵 (空字串)，其值為 1。Facebook SDK 無法為獎勵廣告提供特定的獎勵價值。

如需為 AdMob 廣告單元設定獎勵價值的詳情，請參閱「建立廣告單元」一文。

步驟 3：匯入 Facebook Audience Network SDK 和轉接程式

從 Changelog 中的下載連結下載 Facebook 最新版 Google Mobile Ads 中介服務外掛程式，然後從 zip 檔中擷取 GoogleMobileAdsFacebookMediation.unitypackage。

在 Unity 專案編輯器中，選取 [Assets > Import Package > Custom Package]，然後找出您下載的 GoogleMobileAdsFacebookMediation.unitypackage 檔案。確認已選取所有檔案，然後按一下 [Import] (匯入)。

然後選取 [Asset > Play Services Resolver > Android Resolver > Force Resolve。Unity Play 服務解析器程式庫會從頭開始提供依附元件解析度，並將宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android 目錄中。

步驟 4：需要額外的驗證碼

Android

Facebook 整合功能不需使用額外的程式碼。

iOS

SKAdNetwork 整合

Facebook 會要求您在專案 Info.plist 檔案中加入下列 SKAdNetwork ID：

<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>v9wttpbfk9.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>n38lu8286q.skadnetwork</string>
    </dict>
</array>

已啟用廣告追蹤功能

若您是針對 iOS 14 或更新版本建立，請查看 Facebook 的指示，瞭解如何設定他們的廣告追蹤標記。

步驟 5：測試實作成果

請參閱測試目標對象聯播網導入指南，進一步瞭解如何啟用 Facebook 測試廣告。 接著，您可以使用 中介服務測試套件來確認實作是否正確。

大功告成！您現在可以透過 Facebook 和 Audience Network 進行有效的中介服務整合。

選擇性步驟

依據 Google 的《歐盟地區使用者同意授權政策》規定，您必須確保歐洲經濟區 (EEA) 的使用者取得特定裝置資訊，並在使用裝置 ID 和個人資料時取得使用者同意。本政策是配合《歐盟地區電子通訊隱私指令》和《一般資料保護規則》(GDPR) 而製定。徵求同意時，您必須找出中介服務鏈中的每個可收集、接收或使用個人資料的廣告聯播網，並提供各聯播網使用相關資訊。Google 目前無法將使用者的同意選項自動傳遞至這類網路。

如需瞭解 GDPR 和 Facebook 廣告的相關資訊，請參閱 Facebook 的指南。

將 Facebook 加進 GDPR 廣告合作夥伴名單

請按照 GDPR 設定中的步驟，將 Facebook 加進 AdMob 使用者介面中的 GDPR 廣告合作夥伴名單。

CCPA

加州消費者隱私法 (CCPA) 規定加州州居民有權選擇拒絕「販售」其「個人資訊」(如該「加州」的「個人」資訊)，CCPA 準備指南提供了為 Google 廣告放送啟用受限的資料處理的功能，但 Google 無法將這項設定套用到中介服務鏈中的每個廣告聯播網。因此，您必須確定中介服務鏈中的每個廣告聯播網都可參與個人資訊銷售，並遵守各聯播網的指引，以確保遵守 CCPA。

針對加州使用者，請查看 Facebook 的資料處理選項。

將 Facebook 加入 CCPA 廣告合作夥伴名單

請按照 CCPA 設定中的步驟，將 Facebook 加進 AdMob 使用者介面中的 CCPA 廣告合作夥伴名單。

錯誤代碼

如果轉接程式無法接收來自 Facebook Audience Network 的廣告，發布商則可使用 ResponseInfo 在以下類別，查看廣告回應中的基礎錯誤：

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

以下是廣告無法載入時，Facebook Audience Network 轉接程式所擲出的程式碼和相關訊息：

Android

錯誤代碼 原因
101 伺服器參數無效 (例如缺少刊登位置編號)。
102 要求的廣告大小與 Facebook Audience Network 支援的橫幅廣告大小不符。
103 發布商必須請求包含 Activity 內容的廣告。
104 Facebook Audience Network SDK 無法初始化。
105 發布商未要求使用統一原生廣告。
106 載入的原生廣告與物件不同。
107 使用的 Context 物件無效。
108 載入的廣告缺少必要的原生廣告素材資源。
109 無法從出價酬載建立原生廣告。
110 Facebook Audience Network SDK 無法顯示插頁式廣告/獎勵廣告。
111 建立 Facebook Audience Network AdView 物件時擲回例外狀況。
1000-9999 Facebook Audience Network 傳回 SDK 相關錯誤。如要瞭解詳情，請參閱 Facebook 的說明文件。

iOS

錯誤代碼 原因
101 伺服器參數無效 (例如缺少刊登位置編號)。
102 要求的廣告大小與 Facebook Audience Network 支援的橫幅廣告大小不符。
103 Facebook Audience Network 廣告物件無法初始化。
104 Facebook Audience Network SDK 無法顯示插頁式廣告/獎勵廣告。
105 橫幅廣告的根檢視控制器是 nil。
106 Facebook Audience Network SDK 無法初始化。
1000-9999 Facebook Audience Network 傳回 SDK 相關錯誤。如要瞭解詳情，請參閱 Facebook 的說明文件。

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

版本 3.7.0

版本 3.6.1

版本 3.6.0

版本 3.5.0

版本 3.4.0

3.3.2 版

3.3.1 版

3.3.0 版

版本 3.2.0

版本 3.1.0

版本 3.0.0

版本 2.12.0

版本 2.11.1

版本 2.11.0

版本 2.10.0

2.9.2 版

2.9.1 版

版本 2.9.0

2.8.1 版

版本 2.8.0

版本 2.7.1 (已淘汰，使用 2.8.0 以上版本)

版本 2.7.0（已淘汰，使用 2.8.0 或更高版本）

版本 2.6.1 (已淘汰，使用 2.8.0 以上版本)

2.6.0 版

版本 2.5.1

  • 支持 Facebook Android 適配器版本 5.5.0.0。
  • 支持 Facebook iOS 適配器版本 5.5.1.0。

2.5.0 版本

  • 支持 Facebook Android 適配器版本 5.5.0.0。
  • 支持 Facebook iOS 適配器版本 5.5.0.0。

2.4.1 版本

  • 支持 Facebook Android 適配器版本 5.4.1.1。
  • 支持 Facebook iOS 適配器版本 5.4.0.0。

2.4.0 版本

  • 支持 Facebook Android 適配器版本 5.4.0.0。
  • 支持 Facebook iOS 適配器版本 5.4.0.0。

2.3.2 版本

  • 支持 Facebook Android 適配器版本 5.3.1.2。
  • 支持 Facebook iOS 適配器版本 5.3.2.0。

2.3.1 版本

  • 支持 Facebook Android 適配器版本 5.3.1.0。
  • 支持 Facebook iOS 適配器版本 5.3.2.0。

2.3.0 版本

  • 支持 Facebook Android 適配器版本 5.3.0.0。
  • 支持 Facebook iOS 適配器版本 5.3.0.0。

2.2.0 版本

  • 更新外掛程式以支援新的公開 Beta 版獎勵 API。
  • 支持 Facebook Android 適配器版本 5.2.0.1。
  • 支持 Facebook iOS 適配器版本 5.2.0.1。

2.1.1 版本

  • 支持 Facebook Android 適配器版本 5.1.0.1。
  • 支持 Facebook iOS 適配器版本 5.1.0.0。

2.1.0 版本

  • 支持 Facebook Android 適配器版本 5.1.0.0。
  • 支持 Facebook iOS 適配器版本 5.1.0.0。

2.0.0 版本

  • 支持 Facebook Android 適配器版本 5.0.1.0。
  • 支持 Facebook iOS 適配器版本 5.0.1.0。

1.2.1 版本

  • 支持 Facebook Android 適配器版本 4.99.3.0。
  • 支持 Facebook iOS 適配器版本 4.99.3.0。

1.2.0 版本

  • 支持 Facebook Android 適配器版本 4.99.1.1。
  • 支持 Facebook iOS 適配器版本 4.99.2.0。

1.1.3 版本

  • 支持 Facebook Android 適配器版本 4.28.2.1。
  • 支持 Facebook iOS 適配器版本 4.28.1.2。

1.1.2 版本

  • 已修正與 Unity Ads Unity 中介服務外掛程式的可能衝突。

1.1.1 版本

  • 支持 Facebook Android 適配器版本 4.28.2.0。
  • 支持 Facebook iOS 適配器版本 4.28.1.1。

1.1.0 版本

  • 支持 Facebook Android SDK 版本 4.28.1。
  • 支持 Facebook iOS SDK 版本 4.28.1。

1.0.0 版

  • 第一版！
  • 支持 Facebook Android SDK 版本 4.27.0。
  • 支持 Facebook iOS SDK 版本 4.27.1。