设置 Tapjoy
Tapjoy 是一家已与 Adjust 集成的广告渠道。我们的集成允许 Tapjoy 通过自动回传接收归因和应用内事件数据。
在本文中了解如何为您的应用设置 Tapjoy 监测,这包括激活集成、创建推广活动链接、以及选择 Adjust 可以与 Tapjoy 分享的数据。
操作前须知
要求
- Adjust 中的管理员、编辑员或自定义编辑员权限。
- Adjust SDK v4.0.0 或更新版本,以便将 SDK 参数映射至 Tapjoy 参数。按照以下指南使用此功能。
iOS | 安卓 | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
凭证
APP ID
- 如需帮助查找凭证,请联系您的 Tapjoy 代表。
在 Campaign Lab 中选择 Tapjoy 和应用
- 找到 Campaign Lab ,选择 合作伙伴 。
- 选择 新合作伙伴 > Tapjoy 。选择 下一步 进入下一界面。
- 在 应用选择 界面选择要创建链接的应用,启用集成来与 Tapjoy 分享数据。
- 选择 下一步 。
启用数据分享
启用数据分享以激活与 Tapjoy 的集成。要启用数据分享:
- 输入您的 APP ID。
启用与 Tapjoy 的数据分享后,Adjust 会默认自动向 Tapjoy 发送以下数据:
- 安装
- 会话
- 事件
- 被拒安装
设置数据分享
如果您的多平台应用启用了多个平台的数据分享,那么可以:
- 通过选择 使用平台特定设置 来在平台层级区分数据共享设置。
- 通过选择 使用全局设置 来为多个平台应用相同的数据共享设置。
在 哪些数据会默认分享? 部分, 查看 Adjust 默认与 Tapjoy 分享的活动。
- 安装
- 会话
- 事件
- 被拒安装
发送额外数据
选择您想通过回传与 Tapjoy 分享的数据量和数据类型。Tapjoy 可能会使用此信息来优化表现。
- 在 您想分享哪些数据来源? 部分,选择与 Tapjoy 分享数据的归因来源:
- 来自所有归因渠道的数据
- 仅限归因至 Tapjoy 的数据
会话
由于会话数量过大,Adjust 不会自动发送会话回传。启用会话分享后,Tapjoy 将接收应用的会话活动数据。
应用内收入 (来自应用内购买)
通过应用内收入分享,Tapjoy 可以接收收入金额以及您的收入事件数据。您需要映射能产生收入的事件,才能分享该数据。
映射事件
将您想分享的事件映射到 Tapjoy 可以接收的值。未映射事件的数据不会被发送至 Tapjoy。
映射单个事件
如果您的应用为多平台应用,则可以选择按平台与 Tapjoy 分享不同事件。这有助于您:
- 通过设定单个事件来管理不同平台的推广活动策略。
- 按平台自定义数据分享。
在 映射事件 中,按照以下步骤选择要直接发送至 Tapjoy 的应用内事件。
选择 映射事件 。
在 Adjust 事件 列表中,选择要与 Tapjoy 分享的 Adjust 事件。
在 合作伙伴事件 下,您需要选择与 Adjust 事件对应的 Tapjoy 事件。
对于单平台应用和仅针对一个平台启用了数据共享的多平台应用,您只能针对一个平台映射事件。对于针对多个平台启用了数据共享的多平台应用,您可以:
- 选择 使用平台特定映射 来在平台层级映射单独事件或不针对某些平台映射事件。
- 选择 使用全局映射 来为所有平台映射相同的事件。
打开 合作伙伴 列表,选择要映射到 Adjust 事件的渠道事件,或输入自定义事件名称。
选择 确认 。
现在 Tapjoy 将接收每个关联事件的应用内事件数据。
映射全部事件
如果 Tapjoy 支持自动映射所有事件,则在 映射事件 下选择 映射全部事件 ,这能够省去映射单个事件的时间。
现在 Tapjoy 将接收所有关联事件的应用内事件数据。
映射参数
要与 Tapjoy分享自定义数据,您通常需要映射参数。
合作伙伴参数 (在 Adjust SDK 4.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点,并将其发送至 Tapjoy。借此,Tapjoy 可以接收每个已关联事件的自定义事件详情。
在向 Adjust SDK 添加新的合作伙伴参数之前,请确保现有的合作伙伴参数均不符合您的要求。
如需与 Tapjoy 分享合作伙伴参数,请遵循以下步骤。
在 Adjust SDK 中设置合作伙伴参数。
- 在操作前须知部分查看所有 SDK 开发平台链接。
在 设置数据分享 下,选择 参数 。
打开 映射参数 ,选择如何向渠道发送 SDK 中指定的合作伙伴参数。
- 选择 映射参数 。
- 在 SDK 参数 字段中输入要与渠道分享的 SDK 参数名称。
- 在 合作伙伴参数 字段中输入 SDK 参数对应的渠道参数。
如果您在 Adjust SDK 中设置了合作伙伴参数而没有在控制面板中设置参数分享,那么 Adjust 会按照 Adjust SDK 中的名称发送参数。
配置链接和设置
您可以进行以下设置:
创建链接并与 Tapjoy 分享
在 设置概览 界面,您可以检查自己的选择,也可以返回并更改以下内容:
- 所选应用
- 数据分享选项
- 链接结构参数
- 用户目的位置
- 归因设置
选择 创建链接 来创建点击 URL、展示 URL、二维码和链接识别码。创建链接还会启用数据共享及与 Tapjoy 的集成。
创建链接后,请与 Tapjoy 分享链接,以便在推广活动中放置。
合作伙伴特定设置说明
如果要向 Tapjoy 仅发送已被归因的流量,请切换相关开关。请注意,该开关适用于发送到 Tapjoy 的所有活动。
请注意,用于事件名称的 Tapjoy App ID 和 Engagement ID 必须采用以下格式:
- 8 个字符,后面加一个破折号和三组字符(每组 4 个字符,并以破折号分隔),然后以 12 个字符结尾。
- 所有字符必须为十六进制。 示例值:c8196876-64ef-4fab-bed6-c9306fe35b05
还需注意的是,如果 IDFA 为空(主要是指 IDFA 为零的 IOS LAT 用户),则 Adjust 不会向 Tapjoy 发送任何回传。
转发给 Tapjoy 的所有参数列表
Tapjoy 要求 Adjust 在回传中发送以下参数 (数据点):
占位符 | 信息 |
{adid} | Adjust 设备 ID(所有平台) |
{android_id} | 安卓 ID(仅限安卓设备) |
{click_attribution_window} | 设备匹配的归因窗口设置(小时数) |
{country} | 两字符设备国家/地区代码 |
{currency} | 从 Adjust SDK 发送的原始 ISO 4217 货币代码 |
{device_name} | 设备型号 |
{device_type} | 设备类型 |
{idfa||gps_adid} | IDFA 或 GPS ADID(如果 IDFA 为空) |
{impression_attribution_window} | 展示匹配的归因窗口设置(小时数) |
{ip_address} | 设备 IP 地址 |
{label} | 点击时发送的 Adjust “标签”参数值 |
{language} | 设备两字符语言代码 |
{mac_sha1} | 大写字母 MAC SHA-1 哈希 |
{match_type} | 归因方法 |
{mcc} | 移动设备国家/地区代码:用于识别设备国家/地区的三字符代码。与移动网络代码同时使用来识别设备运营商。 |
{mnc} | 移动网络代码:两字符代码。与移动国家/地区代码同时使用来识别设备运营商。 |
{os_name} | 设备操作系统 |
{os_version} | 操作系统版本号 |
{partner_parameters} | Adjust SDK 或 S2S 请求收集并且通过回调传输给第三方提供商的自定义合作伙伴参数 |
{revenue} | 从 Adjust SDK 发送的收入(以分计) |
{sdk_version} | Adjust SDK 版本(按应用) |
{timezone} | 设备时区 |
{tracking_limited} | 若跟踪受限,则为 1;若跟踪未受限,则为 0 |
{user_agent} | 传入的原始用户代理 |
{activity_kind} | 用户活动类型 |
{app_id} | 商店的应用 ID 或 Google Play 商店 |
{app_name} | 应用名称 |
{app_version_short} | 应用版本号 (安卓),Bundle release 版本号 (iOS) |
{app_version} | 应用版本号 (安卓),Bundle build 版本号 (iOS) |
{click_time} | 归因的点击时间戳 |
{connection_type} | 互联网连接类型 |
{cpu_type} | CPU 类型 |
{created_at} | 活动时间戳 |
{hardware_name} | 硬件名称 |
{impression_based} | 如基于展示,则参数为 1,否则为 0 |
{install_begin_time} | 应用下载开始的时间戳(仅限安卓和 Google Play 商店) |
{install_finish_time} | 应用下载完成的时间戳 |
{referral_time} | 用户登录应用商店页面的时间戳(仅限安卓和 Google Play 商店) |
{rejection_reason} | 归因被拒的原因 |