IAP Setup for ROAS

1. 简介

Tapjoy为客户提供了广告回收（ROAS）报告查询功能，客户可以通过Tapjoy Marketing API 和[Tapjoy Dashboard](https:// ltv.tapjoy.com/)来查看。计算出的 ROAS 指标考虑了广告主的广告支出，应用内购买 (IAP) 带来的收入和广告变现收入。

出于 ROAS 的目的，我们将有购买数据和美元货币代码的应用内事件视为 IAP，这意味着它将计入该广告的 ROAS。这将确保Tapjoy通过第三方广告监测合作伙伴 (MMP) 正确接收您的应用程序的 IAP 数据，以获得准确的 ROAS 指标来报告和优化您的广告，这一点至关重要。同样，您获得的用户的广告收入数据也必须通过 MMP 传递给 Tapjoy，才能包含在 ROAS 指标中。

此页面提供有关Tapjoy如何接收IAP数据和广告收入、对您的好处以及使用MMP设置IAP购买的最佳实践的信息。

2. 如何以及为何收集收入数据

Tapjoy的IAP数据的主要来源是MMP合作伙伴。 作为在MMP上配置应用程序和设置广告的一部分，您需要配置IAP事件和广告收入。 这样最佳做法如下并且您的Tapjoy客户经理可以提供帮助。 具体设置问题应与您的MMP客户经理联系。

Tapjoy的ROAS报告基于安装日期同类群组，并提供第 0、1、3 天……7、14、30、60 和 90 天的指标。 对于这些第 X 天指标中的每一个，广告支出、广告收入（来自 IAP）和 ROAS 都可以直接通过Marketing API 获得，选定的指标可以在Tapjoy dashboard报告中获得。 例如，第 3 天 ROAS 指标的计算方法是，自安装之日起 3 天内的 IAP 收入总和除以该同类群组的相关广告支出。

3. MMP相关的设置指南

使用Singular, Appsflyer和Adjust集成的客户正式支持 Tapjoy ROAS 报告。

A. Adjust

Set Up Tapjoy - Adjust Help Center

Event tracking - Adjust Help Center

1. 登录到Adjust Dashboard, 进入App主页面并选择相应的app。
2. 点击 caret 图标. 在展示的链接中点击 Set Up Your App 下的 Partner Setup.
3. 在配置的广告平台中选择 Tapjoy 并点击最右边的 caret 图标.
4. 点击 Event Linking.
5. 滚动到 Purchase/IAP event, 它是在 SDK 集成时命名的。
   • Name: 在名称字段下，请输入如下例所示的 Purchase 或 IAP。
   • Engagement_id: 在 {engagement_id} 字段下填写 Tapjoy 提供的事件ID。 **注意：有两种方法可以获得Tapjoy事件ID {engagement_id} - (1) 您的 Tapjoy 客户经理或 (2) 登录您的 Tapjoy 帐户找到。
6. 点击 OK. 完成!

B. AppsFlyer

Tapjoy campaign configuration – Appsflyer Help Center

1. 登录到Appsflyer Dashboard, 在Integrated Partners的左侧菜单中选择Tapjoy。
2. 滚动的 In-app event postback 并打开.
3. 点击 Add Event 并找到 IAP event_name. 根据AppsFlyer’s documentation, 推荐的名称为 {af_purchase}.
4. 在Parnter event identifier中填写Tapjoy提供的事件ID {engagement_id}。 **注意：有两种方法可以获得Tapjoy事件ID {engagement_id} - (1) 您的 Tapjoy 客户经理或 (2) 登录您的 Tapjoy 帐户找到。
5. 在 Sending Option 下拉列表中, 选择相应的选项。
   • Partner Only = 归因到Tapjoy的IAP数据
   • All Media Sources = 归因到Tapjoy和非Tapjoy的IAP数据
6. 在 Send Revenue, 选择 Values & Revenue. 此选择向我们发送IAP值、当前货币代码，并转换为美元，这是计算ROAS所需的。
7. 点击 Save Integration. 完成!

C. Singular

Set Up Tapjoy - Singula Help Center

General Instructions on how to set-up a Partner

SDK事件列表中包括 _ IAP _ 和 _ REVENUE_ 事件。 _ IAP _ 是应用内购买事件，名称是固定的。 _ REVENUE_n 包括:

1. 所有的应用内购买事件 (_ IAP _ + 任意定制的事件).
2. 广告收益事件由SDK上报(如果已经设置 ad revenue attribution通过SDK方法发送SDK事件).

您需要在 Attribution > Partner Configuration 页面中设置 Tapjoy，使Singular可以跟踪Tapjoy的安装和事件。

1. 登录Singular控制面板。 点击左侧的Attribution > Partner Configuration。 在文本框中搜索 Tapjoy 并从列表中选择。
2. Tapjoy 配置窗口将打开。 在下拉列表中，选择您要配置的应用程序。 **注意：每个应用程序都要单独配置。
3. 在 App-specific Configuration 下，勾选以下各项：
   • 将所有安装回传发送到 Tapjoy，无论归属合作伙伴如何
   • 在所有安装中向 Tapjoy 发送事件回传
4. 将Tapjoy生成的ID粘贴到Tapjoy App ID 下。

5. 继续向下滚动到 Event Postback，然后在下拉列表中选择以下选项之一：
   • 全部：向此合作伙伴发送有关用户在您的应用中触发的所有事件的回传，无论这些事件是否归因于此合作伙伴。
   • 仅当安装归因于 Tapjoy：当相应的安装归因于该合作伙伴时发送事件回发
6. 接下来添加_ IAP _事件名称和☑️包括收入值。
7. 单击完成。

广告收入

A. Adjust

注意：在打开应用内收入转发之前，至少关联一个收入事件。 要添加事件，请在Event Linking下进行。

1. 登录 Adjust 控制面板，导航到应用主页，然后选择相应的应用。
2. 单击插入符号图标。 将出现一个超链接选项列表。 单击设置您的应用程序下的合作伙伴设置。
3. 在配置的网络列表中找到 Tapjoy，然后单击最右侧的插入符号图标。
4. 在安装模块下，打开：
   • In-App Revenue Forwarding
   • Ad Revenue Forwarding
5. 选择您要分享的广告收入来源数据。 如果未选择任何来源，则所有来源的收入数据将默认发送到网络。

B. Appsflyer

注意：在启用“Ad revenue”标签下的“Get ad revenue data”之前，至少添加一个收入事件。 要添加事件，请在应用内事件回传下设置。

转到Configuration > Integrated partners。 选择 Tapjoy。 转到Integration并导航到Ad revenue选项卡。 打开Get ad revenue data。

在右侧，输入您的 Tapjoy API 凭据。 **注意，这些是必填字段。 Application ID: 这与在集成下的 app_id 文本框中输入的字符串相同。 Marketing API Key: 每个用户的 API 密钥都是唯一的，可以在 Tapjoy 的控制面板中的报告选项卡下找到。 点击Save Ad Revenue。

C. Singular

Onboarding Guide for Ad Revenue Attribution

您需要在 Attribution > Partner Configuration 页面中设置 Tapjoy，使Singular可以跟踪Tapjoy的安装和事件。

1. 登录Singular控制面板。点击左侧的Attribution > Partner Configuration。在文本框中搜索 Tapjoy 并从列表中选择。
2. Tapjoy 配置窗口将打开。在下拉列表中，选择您要配置的应用程序。 注意：每个应用程序都要单独配置。
3. 在 App-specific Configuration 下，勾选以下各项：
   • 将所有安装回传发送到 Tapjoy，无论归属合作伙伴如何
   • 在所有安装中向 Tapjoy 发送事件回传
4. 将 Tapjoy 生成的 ID 粘贴到 Tapjoy App ID 下。
5. 继续向下滚动到 Event Postback，然后在下拉列表中选择以下选项之一：
   • 全部：向此合作伙伴发送有关用户在您的应用中触发的所有事件的回传，无论这些事件是否归因于此合作伙伴。
   • 仅当安装归因于 Tapjoy：当相应的安装归因于该合作伙伴时发送事件回发
6. 接下来添加 _ REVENUE _ 事件名称并包括收入值。
7. 单击完成。