设置 OneSignal
OneSignal 是一家已与 Adjust 集成的数据分析合作伙伴。我们的集成允许 OneSignal 通过自动回传接收 Adjust 监测的数据。您可以使用合作伙伴的工具进行数据分析并获取洞见。
在本文中了解如何为您的应用设置 OneSignal 监测,其中包括激活集成,以及选择 Adjust 可以与 OneSignal 分享的数据。
操作前须知
要求
- Adjust 中的管理员、编辑员或自定义编辑员权限。
- Adjust SDK v4.0.0 或更新版本,以便将 SDK 参数映射至 OneSignal 参数。按照以下指南使用此功能。
iOS | 安卓 | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
凭证
OneSignal App ID
- 如需帮助查找凭证,请联系您的 OneSignal 代表。
在 Campaign Lab 中选择 OneSignal 和应用
- 找到 Campaign Lab ,选择 合作伙伴 。
- 选择 新合作伙伴 > OneSignal 。选择 下一步 进入下一界面。
- 在 应用选择 界面选择要创建链接的应用,启用集成来与 OneSignal 分享数据。
- 选择 下一步 。
启用数据分享
启用数据分享以激活与 OneSignal 的集成。要启用数据分享:
- 输入您的 OneSignal App ID。
启用与 OneSignal 的数据分享后,Adjust 会默认自动向 OneSignal 发送以下数据:
- 安装
- 会话
设置数据分享
如果您的多平台应用启用了多个平台的数据分享,那么可以:
- 通过选择 使用平台特定设置 来在平台层级区分数据共享设置。
- 通过选择 使用全局设置 来为多个平台应用相同的数据共享设置。
在 哪些数据会默认分享? 部分, 查看 Adjust 默认与 OneSignal 分享的活动:
- 安装
- 会话
发送额外数据
选择您想通过回传与 OneSignal 分享的数据量和数据类型。OneSignal 可能会使用此信息来优化表现。
要发送额外数据,您可以查看并自定义以下选项:
会话
由于会话数量过大,Adjust 不会自动发送会话回传。启用会话分享后,OneSignal 将接收应用的会话活动数据。
应用内收入 (来自应用内购买)
通过应用内收入分享,OneSignal 可以接收收入金额以及您的收入事件数据。您需要映射能产生收入的事件,才能分享该数据。
映射事件
将您想分享的事件映射到 OneSignal 可以接收的值。未映射事件的数据不会被发送至 OneSignal。
映射单个事件
如果您的应用为多平台应用,则可以选择按平台与 OneSignal 分享不同事件。这有助于您:
- 通过设定单个事件来管理不同平台的推广活动策略。
- 按平台自定义数据分享。
在 映射事件 中,按照以下步骤选择要直接发送至 OneSignal 的应用内事件。
选择 映射事件 。
在 Adjust 事件 列表中,选择要与 OneSignal 分享的 Adjust 事件。
在 合作伙伴事件 下,您需要选择与 Adjust 事件对应的 OneSignal 事件。
对于单平台应用和仅针对一个平台启用了数据共享的多平台应用,您只能针对一个平台映射事件。对于针对多个平台启用了数据共享的多平台应用,您可以:
- 选择 使用平台特定映射 来在平台层级映射单独事件或不针对某些平台映射事件。
- 选择 使用全局映射 来为所有平台映射相同的事件。
打开 合作伙伴 列表,选择要映射到 Adjust 事件的渠道事件,或输入自定义事件名称。
选择 确认 。
现在 OneSignal 将接收每个关联事件的应用内事件数据。
映射全部事件
如果 OneSignal 支持自动映射所有事件,则在 映射事件 下选择 映射全部事件 ,这能够省去映射单个事件的时间。
现在 OneSignal 将接收所有关联事件的应用内事件数据。
映射参数
要与 OneSignal分享自定义数据,您通常需要映射参数。
合作伙伴参数 (在 Adjust SDK 4.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点,并将其发送至 OneSignal。借此,OneSignal 可以接收每个已关联事件的自定义事件详情。
在向 Adjust SDK 添加新的合作伙伴参数之前,请确保现有的合作伙伴参数均不符合您的要求。
如需与 OneSignal 分享合作伙伴参数,请遵循以下步骤。
在 Adjust SDK 中设置合作伙伴参数。
- 在操作前须知部分查看所有 SDK 开发平台链接。
在 设置数据分享 下,选择 参数 。
打开 映射参数 ,选择如何向渠道发送 SDK 中指定的合作伙伴参数。
- 选择 映射参数 。
- 在 SDK 参数 字段中输入要与渠道分享的 SDK 参数名称。
- 在 合作伙伴参数 字段中输入 SDK 参数对应的渠道参数。
如果您在 Adjust SDK 中设置了合作伙伴参数而没有在控制面板中设置参数分享,那么 Adjust 会按照 Adjust SDK 中的名称发送参数。
为您的应用启用 OneSignal
在 设置概览 界面,您可以检查自己的选择,也可以返回并更改以下内容:
- 所选应用
- 数据分享选项
选择 启用合作伙伴 ,为您的应用启用 OneSignal 。数据分析合作伙伴不使用推广活动链接。启用合作伙伴后,我们的集成会通过自动回传发送归因和应用内事件数据。
合作伙伴特定设置说明
To ensure Adjust callbacks are correctly sent to OneSignal, complete the following two steps:
Step 1: Enable Parameter Forwarding
In your Adjust dashboard, enable Parameter Forwarding under Data Sharing settings.
Step 2: Pass ' onesignal_customer_id ' partner parameter
OneSignal requires you to pass your OneSignal's customer id as custom partner parameters in your Adjust SDK implementation. The key name of the partner parameter is ' onesignal_customer_id '.
You can learn more about partner parameters here and here .
转发给 OneSignal 的所有参数列表
OneSignal 要求 Adjust 在回传中发送以下参数 (数据点):
| Placeholder | Information |
{currency} | Original ISO 4217 currency code sent from Adjust SDK |
{event_name} | Event name, as set in the Dashboard |
{partner_parameters} | Custom partner parameters collected by the Adjust SDK or S2S request and transmitted to third party providers via postbacks |
{revenue_float} | Revenue, as sent from Adjust SDK, in whole currency units |
{campaign_name} | Campaign name, as taken from the tracker |
{network_name} | Network name, as taken from the tracker |