# 与 Appsflyer 集成

> 通过集成 Appsflyer 作为移动端成效衡量合作伙伴，与 Tapjoy Offerwall 共享用户参与度和广告系列数据。

本指南将说明如何在 Appsflyer 后台中设置新的 Offerwall 广告系列。

如需其他相关指导，请参阅 Appsflyer 文档中的 [Tapjoy 设置指南](https://support.appsflyer.com/hc/en-us/articles/207033956-Tapjoy-campaign-configuration)。

## Tapjoy 广告系列配置##tapjoy-campaign-configuration

### 合作伙伴激活##partner-activation

1. 从侧面菜单中，选择 **Collaborate（协作）**> **Partner Marketplace（合作伙伴市场）**。
2. 搜索并选择 **Tapjoy**。
3. 在 Tapjoy 配置文件页面上，选择 **Set Up Integration**。
4. 您将被引导至集成设置页面。在 Integration（集成）选项卡中，开启 **Activate Partner（激活合作伙伴）**。

![在 AppsFlyer 后台中激活 Tapjoy 为合作伙伴。](/api/media?file=/grow/media/images/AF_activate_partner.png)

> **Note:**
>
> 不要使用 \*\*Activate partner（激活合作伙伴）\*\*来暂停或关闭广告系列归因。禁用合作伙伴集成可能会对投放中的广告系列造成不可逆转的损害。

### Integration（集成）选项卡（安装）##integration-tab-(install)

1. **First Time Installers**

   1.开启 **Activate Partner（激活合作伙伴）**。
   2.在 **app\_id** 字段下输入 Tapjoy 生成的字符串。
   3.关闭 \*\*Install view-through attribution（安装查看归因）\*\*选项。
   4.在 Default Postback（默认回传）部分下的 Install（安装）旁边，选择 `All media sources, including organic`（所有媒体源，包括自然流量）。

   ![AppsFlyer 控制面板显示所有媒体源。](/api/media?file=/grow/media/images/AF_all_media_sources.png)

2. **Existing Users**

   1.开启 **In-app events postback（应用内事件回传）**。
   2.选择 **添加事件**。
   3.在 \*\*Appsflyer event（Appsflyer 事件）\*\*下，搜索或添加 `af_app_opened`。
   4.使用步骤 2.2 在 **app\_id** 字段中输入的由 Tapjoy 生成的字符串。
   5.在 \*\*for users from（适用于以下来源的用户）\*\*下拉选单中，选择 `All media sources, including organic`（所有媒体源，包括自然流量）。
   6.选择 **Save Integration**，或转到步骤 3 的 Integration（集成）选项卡：（事件）以添加更多安装后事件。

   ![AppsFlyer 后台中 Tapjoy 生成的跟踪链接。](/api/media?file=/grow/media/images/AF_tapjoy_generated.png)

#### 关于安装的动态抑制要求##dynamic-suppression-requirements-for-install

为了遵守我们的动态抑制政策并确保最佳性能，从 2022 年 4 月 1 日起需要以下配置：

* **首次安装者**：从未在设备上安装或启动过该应用的用户。重新安装不算作新的安装。
* **现有用户**：以前任何时间在设备上安装并启动过该应用的用户，包括卸载该应用后重新安装的用户。

### Integration（集成）选项卡（事件）##integration-tab-(events)

1. **Single Multi-Reward CPE**

   1.向下滚动到 \*\*In-app events postback（应用内事件回传）\*\*部分。
   2.选择 **添加事件**。
   3.在 \*\*Appsflyer event（Appsflyer 事件）\*\*下，从下拉选单中选择事件。
   4.在 \*\*mapped to partner event（映射到合作伙伴事件）\*\*字段下输入由 Tapjoy 生成的 engagement\_id。
   5.重复步骤 2-4 直到配置好所有事件并指向唯一 engagement\_id。
   6.选择 **Save Integration**，或转到 Daily Rewards（每日奖励）部分以配置更多安装后事件。

   ![将 app 内事件映射到 AppsFlyer 后台中的 Tapjoy。](/api/media?file=/grow/media/images/AF_mapped_event.png)

2. **Daily Rewards CPE**

   1.向下滚动到 \*\*In-app events postback（应用内事件回传）\*\*部分。
   2.选择 **添加事件**。
   3.添加与游戏内升级相关的 SDK 事件。支持的事件名称包括自定义事件和 Appsflyer 的预定义事件，如 `af_level` 或 `af_level_achieved`。

   > **Note:**
   >
   > Appsflyer 建议集成以下与游戏内升级相关的[预定义事件](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#predefind-and-custom-events)：[af\_level](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#af_level) 表示应用内购，[af\_level\_achieved](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#level-achieved-af_level_achieved) 表示用户生成的广告收入事件。此外，还支持自定义事件。了解如何[定义事件](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#defining-an-inapp-event)以及如何使用[事件生成器](https://evgen.appsflyer.com/)。如需了解更多信息，请参阅[提示](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#tips)和[限制](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#limitations)。

   4.在 \*\*mapped to partner event（映射到合作伙伴事件）\*\*下输入由 Tapjoy 生成的 engagement\_id。
   5.在 \*\*Including（包括）\*\*下，从下拉选单中选择 `Values + No Revenue`（值 + 无收入）以确保在转化回传信息中包括关卡数据。
   6.选择 **保存集成**。

   ![AppsFlyer 后台中的每日奖励报告。](/api/media?file=/grow/media/images/AF_daily_rewards.png)

## 用于计算 ROAS 的 IAP 和广告收入配置##iap-and-ad-revenue-configuration-for-roas

### Appsflyer IAP 设置##appsflyer-iap-setup

1. 在 **In-App events postback** 部分下，选择 **Add Event**。
2. 添加您的应用内购事件。强烈建议对 IAP 事件使用 `af_purchase` 的事件名称（请参阅 Appsflyer 的 [af\_purchase](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#purchase-af_purchase) 事件）。
3. 在 \*\*mapped to partner event（映射到合作伙伴事件）\*\*下输入由 Tapjoy 生成的 engagement\_id。
4. 在 \*\*for users from（适用于以下来源的用户）\*\*列下，选择您偏好的发送选项。建议选择“*All media sources, including organic（所有媒体源，包括自然流量）*”。
5. 在 \*\*Including（包括）\*\*下，选择 `Values + Revenue`（值 + 收入）以确保在转化回传信息中包括金额。
6. 选择 **Save Integration**（保存集成）。

请参阅 Appsflyer 的预定义事件[列表](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#predefind-and-custom-events)。

![AppsFlyer 收入值配置屏幕。](/api/media?file=/grow/media/images/AF_values_revenue.png)

### Appsflyer 广告收入设置##appsflyer-ad-revenue-setup

Tapjoy 支持两种发送广告收入的方法：回传和 Data Locker。为提高数据质量，最好采用**回传方法**。

1. **Postbacks (Recommended)**

   1.在 **app内事件回传** 部分下，选择 添加 事件\*。
   2.使用事件名称 `af_ad_revenue` 添加广告收入事件。使用 [af\_ad\_revenue](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#af_revenue) 事件名称是**强制要求**。
   3.在 \*\*mapped to partner event（映射到合作伙伴事件）\*\*下输入由 Tapjoy 生成的 engagement\_id。
   4.在 \*\*for users from（适用于以下来源的用户）\*\*列下，选择您偏好的发送选项。建议选择“*All media sources, including organic（所有媒体源，包括自然流量）*”。
   5.在 \*\*Including（包括）\*\*下，选择 `Values + Revenue`（值 + 收入）以确保在转化回传信息中包括金额。
   6.选择 **保存集成**。

   > **Note:**
   >
   > 如果您是首次为应用启用广告收入数据回传，请通知您的客户经理，让客户经理为您启用此数据，使数据能够显示在 Tapjoy 后台中。否则，Tapjoy 后台中的广告收入要么不显示，要么仍然来自 Data Locker 数据（如果为此应用配置了 Data Locker）。对于每个应用，必须单独执行此操作。

   ![AppsFlyer 广告收入值配置屏幕。](/api/media?file=/grow/media/images/AF_values_ad_revenue.png)

2. **Data Locker**

   > **Note:**
   >
   > 广告主必须拥有 ROI360 高级订阅才能使用 Data Locker 来共享广告收入。

   1.从侧面菜单中，选择 **Collaborate（协作）**> Active integrations\*\*（激活的集成）\*\*。
   2.使用搜索栏查找并选择 **Tapjoy**。
   3.导航到 \*\*Permissions（权限）\*\*选项卡。
   4.开启 **Ad Network Permissions（广告网络权限）**。
   5.开启 \*\*Access ad revenue raw data (UA signals)（访问广告收入原始数据（UA 信号））\*\*权限。
   6.选择 **保存**。

   如需了解更多信息，请参阅 Appsflyer 文档中的 [UA 广告网络的广告收入信号](https://support.appsflyer.com/hc/en-us/articles/4402898251409-Ad-revenue-signals-for-UA-ad-networks#set-the-ad-revenue-report-in-data-locker)。

   ![AppsFlyer 后台中的广告收入报告。](/api/media?file=/grow/media/images/AF_ad_revenue.png)