将 Facebook Audience Network 与出价功能集成

本指南面向希望使用 Google 移动广告 SDK 通过出价加载和展示 Facebook Audience Network 中的发布商。其中介绍了如何将 Facebook Audience Network SDK 和适配器集成到 Unity 应用中。

支持的集成和广告格式

适用于 Facebook Audience Network 的 AdMob 中介适配器具有以下功能：

集成
出价
瀑布
格式
横幅
插页式广告
激励广告
插页式激励广告

要求

  • Unity 5.6 或更高版本
  • 最新版 Google 移动广告 SDK
  • 适用于 Facebook 2.11.0 或更高版本的 Google 移动广告中介插件
  • 在 Android 上部署
    • Android API 级别 16 或更高级别
  • 在 iOS 上部署
    • iOS 部署目标为 10.0 或更高版本
    • 最新的 Facebook Audience Network SDK 通常需要使用最新版本的 Xcode。
  • 使用 Google 移动广告 SDK 配置的有效 Unity 项目。如需了解详情，请参阅使用入门。

第 1 步：设置 Facebook Audience Network

注册并登录商家资料管理中心初始页。

点击创建新的 Business Manager 帐号，然后在必填字段中填写您的商家详情。

创建 Facebook 媒体资源

填写必要信息后，系统会提示您为应用创建媒体资源。输入您的应用所需的媒体资源名称，然后点击转至创收管理器。

接下来，选择您要用于创收的平台。

指明您的应用是否已发布，然后点击提交。

Android

iOS

系统会提示您为应用创建广告展示位置。 选择格式，填写表单，然后点击下一步。

针对所有横幅尺寸（包括 300x250）选择Banner。Facebook 在出价中不支持 Medium Rectangle 展示广告格式，但当使用 Banner 展示广告格式时，支持高度为 50、90 或 250 的灵活宽度横幅广告。

如果您计划集成插页式激励广告格式，则相应的 Facebook 格式为 Rewarded Video。

下一步简要介绍了您创建的展示位置。记下添加展示位置 ID 部分下的展示位置 ID。

第 2 步：为您的 AdMob 广告单元配置中介设置

您需要将 Facebook 添加到广告单元的中介配置中。首先，登录您的 AdMob 帐号。

Android

转到中介标签页。如果您已有要修改的中介组，请点击该中介组的名称进行修改，然后直接将 Facebook Audience Network 添加为广告来源。

要创建新的中介组，请选择创建中介组。

输入广告格式和平台，然后点击继续。

为中介组命名，然后选择要定位到的地理位置。 然后，将中介组状态设置为已启用。然后点击添加广告单元，此时会打开广告单元选择叠加层。

将此中介组与现有 AdMob 广告单元相关联。 然后，点击完成。现在，您应该会看到“广告单元”卡片中填充了您选择的广告单元。

将 Facebook Audience Network 添加为广告来源

在广告来源卡片中，选择添加广告联盟。选择 Facebook Audience Network (Bidding)。输入在上一部分中获取的展示位置 ID，然后点击完成。

最后，点击保存。

iOS

转到中介标签页。如果您已有要修改的中介组，请点击该中介组的名称进行修改，然后直接将 Facebook Audience Network 添加为广告来源。

要创建新的中介组，请选择创建中介组。

输入广告格式和平台，然后点击继续。

为中介组命名，然后选择要定位到的地理位置。 然后，将中介组状态设置为已启用。然后点击添加广告单元，此时会打开广告单元选择叠加层。

将此中介组与现有 AdMob 广告单元相关联。 然后，点击完成。

现在，您应该会看到“广告单元”卡片中填充了您选择的广告单元。

将 Facebook Audience Network 添加为广告来源

在广告来源卡片中，选择添加广告联盟。选择 Facebook Audience Network (Bidding)。输入在上一部分中获取的展示位置 ID，然后点击完成。

最后，点击保存。

使用激励广告

在激励广告单元的设置中，提供奖励金额和奖励类型的值。然后，为确保无论哪个广告联盟提供相同奖励，您都要为用户提供相同的奖励，请选中应用到中介组中的所有广告联盟复选框。

如果您未应用此设置，Facebook 适配器会默认采用值为 1 的 ""（空字符串）类型的奖励。Facebook SDK 不会为其激励广告提供特定的奖励值。

如需详细了解如何为 AdMob 广告单元设置奖励值，请参阅创建广告单元。

第 3 步：导入 Facebook Audience Network SDK 和适配器

通过变更日志中的下载链接下载适用于 Facebook 的最新版 Google 移动广告中介插件，并从 zip 文件中提取 GoogleMobileAdsFacebookMediation.unitypackage。

在 Unity 项目编辑器中，选择 Assets > Import Package > Custom Package，并找到您下载的 GoogleMobileAdsFacebookMediation.unitypackage 文件。确保选择所有文件，然后点击 Import。

然后，选择 Assets > Play Services Resolver > Android Resolver > Force Resolve。Unity Play Services Resolver 库将从头开始执行依赖项解析，并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。

第 4 步：需要其他代码

Android

Facebook 集成不需要其他代码。

iOS

SKAdNetwork 集成

Facebook 要求您将以下 SKAdNetwork 标识符添加到项目的 Info.plist 文件中：

<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) 内的用户披露与使用设备标识符和个人数据有关的信息，以及征得这些用户的同意。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。在征求用户意见时，您必须指明中介链中可能会收集、接收或使用个人数据的广告联盟，并提供各个广告联盟的使用情况信息。Google 目前无法自动将用户的意见传递给此类网络。

请参阅 Facebook 的指南，了解 GDPR 和 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 服务器参数无效（例如缺少展示位置 ID）。
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 服务器参数无效（例如缺少展示位置 ID）。
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 版。