# Meta Audience Network 集成

> 使用 LevelPlay 的聚合平台将 Meta Audience Network 作为广告网络集成到 React 本地 app程序中。

> **Important:**
>
> 以下文档涉及非 Unity 开发、拥有或运营的产品或服务（“第三方产品”）。
> 这些信息可能已过时或不完整，仅为方便您参考才提供。
> 您对任何第三方产品的使用均受产品自身条款的约束。
> Unity 对这些产品不提供任何担保，也不对因使用这些产品而造成的任何损害或损失负责，包括与第三方供应商提供的内容、广告或材料有关的问题。

## 先决条件##prerequisites

确保将奖励广告服务、插页式广告服务或横幅广告服务正确集成到应用程序中。请参阅以下指定的于平台的指南以了解集成说明：

**Rewarded ads integration:**

* [Unity](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md.md)
* [Android](/grow/levelplay/sdk/android/rewarded-ads-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/rewarded-ads-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/rewarded-ads-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/rewarded-ads-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/rewarded-ads-integration.md.md)

**Interstitial integration:**

* [Unity](/grow/levelplay/sdk/unity/interstitial-integration.md.md)
* [Android](/grow/levelplay/sdk/android/interstitial-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/interstitial-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/interstitial-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/interstitial-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/interstitial-integration.md.md)

**Banner integration:**

* [Unity](/grow/levelplay/sdk/unity/banner-integration.md.md)
* [Android](/grow/levelplay/sdk/android/banner-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/banner-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/banner-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/banner-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/banner-integration.md.md)

## 步骤 1.创建 Meta 帐户

* **首次设置**

  * 转到 [Meta for Developers](https://developers.facebook.com/) 并使用 Meta 帐户注册。
  * 按照该过程并设置应用程序名称。
  * 选择 **Register**（注册）。

  ![Meta for Developers 主页](/api/media?file=/grow/media/images/Screen-Shot-2021-12-02-at-12.52.06.png)

* **注册用户**

  * 登录 Meta 帐户。
  * 在右侧栏中，选择 **My Apps**。

  ![My Apps 菜单](/api/media?file=/grow/media/images/my-apps-1024x478.png)

* 选择您的app

  ![选择 app](/api/media?file=/grow/media/images/choose-app-1024x237.png)

## 步骤 2.创建业务

企业是顶级实体，您可以通过该实体在 Meta 上管理业务，包括 Meta 广告和推广受众网络 Monetization。要创建业务，请访问 [Monetization Manager](https://business.facebook.com/pub/home?helpref=help)

## 步骤 3.创建属性

Monetization Manager 中的属性是具有相同品牌的一组商品。如果针对不同操作系统、平台或设备有不同的产品，则可以将它们分组到属性中，以便在 Monetization Manager 中进行合并报告和管理。

1. 转到 [Monetization Manager](https://business.facebook.com/pub/home?helpref=help)

2. 选择业务或创建新业务

3. 选择 **Create Property**（创建属性）

   ![Create Property 按钮](/api/media?file=/grow/media/images/create-properties--1024x192.png)

4. 根据要添加到其中的应用程序或网站的品牌为您的属性命名

5. 选择 **Create Property**（创建属性）

   ![Create Property 对话框](/api/media?file=/grow/media/images/create-property-2-1024x667.png)

## 步骤 4.选择平台和显示格式

平台是您可以使用受众网络变现的各种类型的产品和表面。

创建属性后，下一步是添加要变现的平台。

![平台选择](/api/media?file=/grow/media/images/platforms.png)

## 步骤 5。创建广告空间

Ad Spaces 可帮助您组织广告位，准确反映用户在 app 中看到广告时的行为。要创建广告放置/位置，您需要首先创建一个广告空间。每个平台最多可以创建 4 个广告位。

1. 转到 [Monetization Manager](https://business.facebook.com/pub/home)。

2. 使用属性名称或属性 ID 在搜索栏中搜索属性，然后选择要为其创建广告位的属性旁边的 **Manage Property**。

3. 选择要创建广告空间的平台。如果要使用的平台不存在，请选择 **Add Platforms**（位于右上角）以创建该平台。

   ![创建广告空间按钮](/api/media?file=/grow/media/images/create-ad-spece-.png)

4. 添加视频以及广告触发时间的描述。选择 **Create Ad Space**（创建广告空间）。

   ![创建广告空间表单](/api/media?file=/grow/media/images/create-ad-space-2-945x1024.png)

5. 创建广告位后，可以通过单击编辑图标并**创建放置/**位置来**创建广告位**。

   ![创建放置/位置选项](/api/media?file=/grow/media/images/create-placement-.png)

## 步骤 6。创建广告放置/位置

受众网络提供不同类型的广告单位。app 或移动端网站中的每个广告单元都使用唯一的放置/位置 ID 进行标识。

1. 转到 [Monetization Manager](https://business.facebook.com/pub/home/?source=help)。

2. 查找并选择要为其创建广告放置/位置的属性。选择右侧的 **Manage Property**（管理属性）。

3. 向下滚动到 **Placements** 部分，然后选择 **Create placement/位置**。您还可以通过单击编辑图标来**创建广告放置**位置，并按上述步骤 5.5 所述\*\*创建放置/\*\*位置。

   ![在 Placements 部分中创建放置/位置按钮](/api/media?file=/grow/media/images/7-1024x224.png)

4. 输入放置/位置名称，选择 **Ad Space**，选择 Ad **Display format**，然后添加可选描述。

   ![创建放置/位置表单](/api/media?file=/grow/media/images/8.png)

5. 选择要如何优化广告放置/位置。优化决定了我们针对 app 或网站上的每个展示量运行广告竞价的方式。

   ![优化选项](/api/media?file=/grow/media/images/9.png)

6. 选择 **Create放置/位置** 以完成。

> **Note:**
>
> 一个广告放置/位置只能由一个广告空间使用，并且需要与广告空间匹配同一平台。

### 向 app 添加广告位

1. 转到 [Monetization Manager](https://business.facebook.com/pub/home)。

2. 选择 **Managed 属性**

3. 选择 **Ad Spaces**，然后向下滚动到 **Placements**，或过滤以查找所需的放置/位置

4. 在 **放置/位置 ID** 列中选择 **Get Code**

   ![获取放置/位置 ID 列中的代码按钮](/api/media?file=/grow/media/images/9-1-1024x328.png)

5. 复制放置/位置 ID，直到下划线 (\_)。稍后在 LevelPlay 上的 app ID 参数中需要用到此属性

   ![放置/位置 ID 中的 app ID](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-18.49.13.png)

6. 复制整个放置/位置 ID。稍后在 LevelPlay 上的放置/位置 ID 参数中需要用到此属性

   ![完整放置/位置 ID](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-20.02.56.png)

> **Note:**
>
> 在添加付款信息并将其发送审查之前，您的 app 将无法接收受众网络广告服务。

## 步骤 7。**在 LevelPlay 平台上激活 Meta Audience Network**

完成以下步骤可在 LevelPlay 上将 Meta Audience Network 激活为聚合网络。您需要在 app 级别添加 app ID 参数，并在实例级别添加放置/位置 ID。

* 登录 LevelPlay 帐户，然后选择“**Monetize**”>“**Setup**”>“**SDK Networks**”。

* 选择 **Manage Networks**（管理网络）

  ![Manage Networks 按钮](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-20.06.35.png)

* 从可用广告网络列表中选择 Meta Audience Network（Meta 受众网络）

* 选择 **Login with Facebook**

  ![使用 Facebook 按钮登录](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-20.49.21.png)

* 使用您批准的 Meta 开发者帐户登录

> **Note:**
>
> 要访问应用程序报告 API，请确保已登录用户已连接到 Meta 业务设置中的所有应用程序（如本文末尾所述）。

* 启用读取受众网络见解

> **Note:**
>
> 批准权限后，您的 LevelPlay 帐户将被授权调用 Meta Audience Network Reporting API。

* 选择要从 Meta Audience Network 运行插页式、奖励式或横幅广告服务的app

  ![为 Meta Audience Network 选择 app](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-19.26.13.png)

* 从 Ad Networks 的设置列表中选择 Meta Audience Network，选择 **Define** 图标，然后在相关字段中插入 **app** **ID** 和 **放置/位置 ID**。请参阅[步骤 6](/grow/levelplay/sdk/adobe/networks/guides/meta-audience-network.md.md)。

  ![配置 app ID 和放置/位置 ID](/api/media?file=/grow/media/images/Screenshot-2025-06-25-at-16.10.59.png)

选择 **Save**，然后会在 Mediation Dashboard（聚合后台）上看到 Meta Audience Network（元受众网络）已**激活**。

![Meta Audience Network 激活状态](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-19.26.37.png)

> **Note:**
>
> 要访问应用程序报告 API，请确保 app/property（只需要一个）已连接到登录用户。连接 app/property 是在 Meta for Developers 平台上完成的。每当向聚合平台添加新应用程序时，都需要此步骤。

### 将属性连接到登录的用户

1. 转到**业务设置**
2. 在侧面菜单中选择 **Users**（用户），然后选择 **People（人**）
3. 搜索要链接到相关属性的用户
4. 选择这**3个点**，然后**添加资源**
5. 在弹出窗口中，选择 **Properties**（属性）
6. 选择要链接的所有资源
7. 在 **Full Control** 下切换 **Manage Property**，然后选择 **Save Changes**

   ![业务设置中的Manage Property开关](/api/media?file=/grow/media/images/meta.png)

只要您的 Meta 开发者帐户保持激活状态，并且至少有 1 个应用程序产生展示，就无需在平台上执行任何其他操作

如果由于会话超时或任何其他原因要求您再次日志，请执行以下步骤：

* 从 SDK Networks 页面中，从可用广告网络列表中选择 **Meta Audience Network**

* 选择 **重置登录**

  ![重置登录按钮](/api/media?file=/grow/media/images/Screen-Shot-2022-08-10-at-10.59.37.png)

* 重复上述登录过程

* 确保使用已核准的 Meta 开发者帐户登录

## 步骤 8。将 Meta Audience Network 适配器添加到构建中##step-8.-add-the-meta-audience-network-adapter-to-your-build

使用适用于 [Android](/grow/levelplay/sdk/android/networks/guides/meta-audience-network.md.md) 和 [iOS](/grow/levelplay/sdk/ios/networks/guides/meta-audience-network.md.md) 的原生适配器继续集成。

## 步骤 9。Meta 其他设置##step-9.-meta-additional-settings

使用以下选项时，在初始化 LevelPlay SDK **之前**调用 `LevelPlay.setMetaData`。

### CacheFlag 配置##cacheflag-configuration

LevelPlay 允许您报告从 Meta 适配器版本 4.3.15+ 开始的插页式广告服务的 Meta CacheFlag 值。

使用“Meta\_IS\_CacheFlag”设置，在 init 之前定义 CacheFlag 以设置单个值：

```js
从“Unity-levelplay-mediation”导入 { LevelPlay }

LevelPlay.setMetaData('Meta_IS_CacheFlag', ['IMAGE'])
```

支持的值包括：**图标**、**图像**、**NONE**、**VIDEO** 或 **All** 以应用所有值。可在[此处](https://developers.facebook.com/docs/audience-network/reference/android/com/facebook/ads/cacheflag.html/?version=v6.8.0)找到有关 Meta CacheFlag 值的更多信息。

### CCPA 支持##ccpa-support

如果使用 Meta 适配器 4.3.18+ (Android)/4.3.17+ (iOS)，请确保遵循 Meta Audience Network 的说明，如[此处](https://developers.facebook.com/docs/marketing-apis/data-processing-options#audience-network-sdk)所述。请注意，应在初始化 LevelPlay Mediation 之前设置 FAN **Limited Data Use** 标志。

#### iOS 14+ 支持##ios-14+-support

如果使用 Meta 适配器 4.3.20+ 并针对 iOS 14+ 进行构建，风扇要求您设置 **setAdvertiserTrackingEnabled** 标志。这允许您通知 Meta 是否使用这些数据来投放个性化广告服务。如果标志设置为 false，FAN 将无法提供个性化广告服务。

请注意，应在初始化 LevelPlay Mediation 之前设置 setAdvertiserTrackingEnabled 标志。LevelPlay setMetaData API 不支持此标志；请根据需要在原生 iOS 项目或通过 Meta SDK 实现现此标志。了解有关为受众网络[启用广告跟踪](https://developers.facebook.com/docs/audience-network/guides/advertising-tracking-enabled/)的更多信息。

此外，请遵循 iOS 14 的 Meta Audience Network 说明，如[以下](https://developers.facebook.com/blog/post/2020/10/29/preparing-our-partners-ios-14-latest-guidance-on-skadnetwork/)所述。

### COPPA 和混合受众支持##coppa-and-mixed-audience-support

LevelPlay 支持从 Meta Adapter 版本 4.3.35+ (Android) / 4.3.34+ (iOS) 开始报告 Meta Mixed Audience 标志。

当面向混合受众时，此标志应设置为“true”。

有关详细说明、使用限制和更多信息，请参阅[此处](https://developers.facebook.com/docs/audience-network/optimization/best-practices/coppa)的 Meta 官方文档。

```js
从“Unity-levelplay-mediation”导入 { LevelPlay }

LevelPlay.setMetaData('META_Mixed_Audience', ['true'])
```

## 验证广告网络集成##verify-your-ad-network-integration

验证您的广告网络与我们的 [Integration Helper](/grow/levelplay/sdk/react/integration-helper.md) 集成。LevelPlay SDK 提供了一个工具，可确保已成功集成我们的 SDK 以及任何其他网络适配器。

在开发版中，在初始化 LevelPlay SDK 之前，通过调用以下方法启用适配器调试日志：

```js
从“Unity-levelplay-mediation”导入 { LevelPlay }

LevelPlay.setAdaptersDebug(true)
```

> **Note:**
>
> SDK 6.5.2 及更高版本支持适配器调试日志。在发布 app 之前，请删除此调用。

如果使用 Meta Audience Network 的服务器到服务器回调并利用 [DynamicUserID](/grow/levelplay/sdk/android/rewarded-ads-integration.md.md) 参数来验证 AdRewarded 事件，则会看到此参数反映在其服务器端回调中。此外，还可以在 LevelPlay 服务器到服务器的回调中看到此参数。

现在，您可以通过 Unity LevelPlay Mediation 平台提供元受众网络广告服务。

## 后续步骤

要通过 Unity LevelPlay 利用其他广告网络，请集成适配器并按照我们的集成指南进行操作。

**Platform adapters:**

* [Unity](/grow/levelplay/sdk/unity/mediation-networks.md.md)
* [Android](/grow/levelplay/sdk/android/mediation-networks.md.md)
* [iOS](/grow/levelplay/sdk/ios/mediation-networks.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/mediation-networks.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/mediation-networks.md.md)
* [原生反应](/grow/levelplay/sdk/react/mediation-networks.md.md)