# 集成最佳实践

> 请正确配置您的集成，确保与广告系列共享所需数据。

当您将所需的移动端成效衡量合作伙伴 (MMP) 与 Unity 用户获取广告系列集成时，请确保正确配置集成。您必须遵循这些最佳实践，确保广告系列获取所需数据。未正确发送数据会对广告系列的表现产生负面影响。

在完成集成设置时，请按照这些最佳实践操作，确保正确配置数据共享设置：

## 从所有来源共享安装数据##share-install-data-from-all-sources

当您与 Unity 共享安装数据时，请确保包含整个用户群的数据，包括归因、未归因和自然安装。如需了解每种归因类型的定义，请参阅[归因基础知识](/user-acquisition/data-sharing/attribution/campaign-attribution-fundamentals.md#attribution-types)。

每个 MMP 对此设置都有独特的术语。以下示例展示了在支持的 MMP 后台中如何从所有来源共享数据：

1. **Adjust**

   ### 在 Adjust 中从所有来源共享数据

   使用以下步骤在 Adjust 后台中共享所有来源的数据：

   1.转到 \*\*Campaign Lab（广告系列实验室）\*\*选项卡 > \*\*Partners（合作伙伴）\*\*页面。
   2.在 \*\*What sources of data do you want to share（您希望共享哪些数据来源）\*\*选项中，选择 **Data from all attribution sources（所有归因来源的数据）**。

2. **AppsFlyer**

   ### 在 AppsFlyer 中从所有来源共享数据

   使用以下步骤在 AppsFlyer 后台中共享所有来源的数据：

   1.转到 \*\*Integration（集成）\*\*选项卡 > \*\*Default postbacks（默认回传）\*\*部分。
   2.在 \*\*for users from（用户来源）\*\*下拉选单中，选择 **All media sources, include organic（所有媒体来源，包括自然流量）**。

3. **Singular**

   ### 在 Singular 中从所有来源共享数据

   使用以下步骤在 Singular 后台中共享所有来源的数据：

   1.转到 \*\*Attribution Postbacks & Settings（归因回传及设置）\*\*选项卡 > \*\*Attribution Postbacks（归因回传）\*\*表格。
   2.启用 \*\*Send All（发送全部）\*\*复选框。

4. **Tenjin**

   ### 在 Tenjin 中从所有来源共享数据

   使用以下步骤，在 Tenjin 后台中共享所有来源的数据：

   1.转到应用的 \*\*Callbacks（回调）\*\*选项卡。
   2.在 \*\*User filter（用户筛选器）\*\*下拉菜单中，选择 **all users（所有用户）**。

## 正确映射安装后事件##map-post-install-events-correctly

当您将[安装后事件数据](/user-acquisition/data-sharing/post-install-event-data-sharing.md)分享至您的广告系列时，请确保正确映射安装后事件。正确映射意味着您需要将 Unity 事件名称与正确的 MMP 事件名称对应。

> **Warning:**
>
> 如果您使用除 Singular 以外的其他 MMP，请勿将广告收入事件与应用内购 (IAP) 事件合并。
>
> 如果您的 MMP 帐户支持广告收入数据共享，请将该数据作为专门的广告收入事件发送。将广告收入作为其他事件类型发送，可能会导致广告系列优化失效。
>
> 请参考针对合作伙伴的[集成指南](./integration-guides.md)，获取详细映射说明。

请参考以下示例，它们展示了正确映射的事件名称：

1. **Adjust**

   ### Adjust 事件映射

   在 Adjust 集成的 \*\*Map events to share with Unity Ads（映射事件以与 Unity 共享）\*\*部分中，按如下方式映射您的安装后事件：

   > **Important:**
   >
   > 如果您的 Adjust 帐户支持广告收入数据共享，请将该数据作为专门的 `ad_revenue` 事件发送。
   >
   > 否则，请勿发送广告收入事件。将广告收入事件映射为其他事件类型（如 `purchase`），可能导致广告系列优化失效。

   | 应用内购 (IAP) | `purchase`       | `purchase`               |
   | ---------- | ---------------- | ------------------------ |
   | 完成重要步骤     | `level_complete` | `{milestone_event_name}` |
   | 会话         | `session`        | `session`                |

2. **AppsFlyer**

   ### AppsFlyer 事件映射

   在 AppsFlyer 集成设置的 \*\*In-app event postbacks（应用内事件回传）\*\*表中，按如下方式映射您的安装后事件：

   > **Important:**
   >
   > 如果您的 AppsFlyer 帐户支持广告收入数据共享，请在 \*\*Ad revenue（广告收入）\*\*选项卡中启用 \*\*Get ad revenue data（获取广告收入数据）\*\*开关。
   >
   > 否则，请勿发送广告收入事件。将广告收入事件映射为其他事件类型（如 `af_purchase`），可能导致广告系列优化失效。

   | 应用内购 (IAP) | `purchase`       | `af_purchase`            |
   | ---------- | ---------------- | ------------------------ |
   | 完成重要步骤     | `level_complete` | `{milestone_event_name}` |
   | 会话         | `session`        | `af_session`             |

3. **Singular**

   ### Singular 事件映射

   在 Singular 集成设置的 \*\*Revenue Events Postbacks（收入事件回传）\*\*和 \*\*Events Postbacks（事件回传）\*\*表中按如下方式映射您的安装后事件：

   > **Important:**
   >
   > Singular 是唯一支持同时发送广告收入事件和应用内购事件的 MMP。若要通过 Singular 发送广告收入事件，请确保在 \*\*Revenue Events Postbacks（收入事件回传）\*\*下拉菜单中选择 **Send all ad monetization events（发送全部广告变现事件）**，并在 \*\*SDK Event Name（SDK 事件名称）\*\*下拉菜单中选择 **`__REVENUE__*`**。

   | 应用内购 (IAP) | `purchase`       | * `_iap_`
   * `{custom_purchase_event_name}` |
   | ---------- | ---------------- | ------------------------------------------ |
   | 广告收入       | `ad_revenue`     | `__REVENUE__*`                             |
   | 完成重要步骤     | `level_complete` | `{milestone_event_name}`                   |
   | 会话         | `session`        | `_SESSION_`                                |

4. **Tenjin**

   ### Tenjin 事件映射

   在 Tenjin 集成设置的 \*\*Channel Callbacks（通道回调）\*\*页面中，按如下方式激活您的安装后事件：

   > **Important:**
   >
   > 如果您的 Tenjin 帐户支持广告收入数据共享，请将此数据作为专门的**广告收入展示**事件发送。
   >
   > 否则，请勿发送广告收入事件。将广告收入映射为其他事件类型，例如**应用内购**，可能会导致广告系列优化功能失效。

   | 应用内购 (IAP) | `purchase`   | `In-app Purchase`       |
   | ---------- | ------------ | ----------------------- |
   | 广告收入       | `ad_revenue` | `Ad Revenue Impression` |
   | 会话         | `session`    | `Unity ads app open`    |

## 共享购买与收入事件的值与收入##share-both-values-and-revenue-for-purchase-and-revenue-events

当您将购买或广告收入事件数据共享给 Unity 时，请确保为每个事件都同时共享值与收入。完整共享这些数据可以提升 Unity 的用户获取模型，并有助于优化广告系列表现。

您的 MMP 可能会对这些设置使用不同的术语。请参考以下示例：

1. **AppsFlyer**

   ### 与 AppsFlyer 共享值与收入

   若要为安装后事件中同时共享值与收入，请在 AppsFlyer 后台中按照以下步骤操作：

   1.转到 \*\*Integration（集成）\*\*选项卡 > \*\*In-app event postbacks（应用内事件回传）\*\*部分。
   2.在每个事件的 \*\*including（包含）\*\*下拉菜单中，选择 **Values & revenue（值与收入）**。

2. **Singular**

   ### 与 Singular 共享值与收入

   若要为安装后事件中同时共享值与收入，请在 Singular 后台中按照以下步骤操作：

   1.转到集成设置的 \*\*In app Events Postback（应用内事件回传）\*\*选项卡。
   2.为每一行勾选 \*\*Include Revenue（包含收入）\*\*复选框。

## 将回传窗口设置为生命周期##set-postback-windows-to-lifetime

如果您的 MMP 支持生命周期作为回传窗口，请务必将窗口设置为生命周期。否则，请将您的回传窗口设置为最大长度。将回传窗口设置为“生命周期”可以让您的广告系列从应用的整个安装历史中学习，有助于提升广告系列的表现。

您的 MMP 可能会对回传窗口设置使用不同的术语。请参考以下示例：

1. **AppsFlyer**

   ### 为 AppsFlyer 将回传窗口设置为生命周期

   若要在 AppsFlyer 中将回传窗口设置为生命周期，请前往集成设置的 \*\*In-app event settings（应用内事件设置）\*\*部分，并将 \*\*In-app event postback window（应用内事件回传窗口）\*\*设置为 **lifetime（生命周期）**。

2. **Singular**

   ### 使用 Singular 将回传窗口设置为生命周期

   若要在 Singular 中将回传窗口设置为生命周期，请按照以下步骤操作：

   1.转到集成设置的 \*\*In app Events Postback（应用内事件回传）\*\*选项卡。
   2.在 \*\*Postback Window Starting Point（回传窗口起始点）\*\*列，为每个事件选择 **Unlimited（无限）**。
   3.如果您拥有 Singular [Enterprise](https://support.singular.net/hc/en-us/articles/115000483946-Partner-Configuration-and-Postbacks-FAQ-and-Troubleshooting#in_app_event_postbacks) 帐户，请将 \*\*Postback Window (days)（回传窗口（天））\*\*设置为 **Unlimited（无限）**。否则，将窗口设置为 `30` 天。