设置 Toss

Toss 是一家已与 Adjust 集成的广告渠道。我们的集成允许 Toss 通过自动回传接收归因和应用内事件数据。

在本文中了解如何为您的应用设置 Toss 监测,这包括激活集成、创建推广活动链接、以及选择 Adjust 可以与 Toss 分享的数据。

操作前须知

要求

iOS | 安卓 | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

凭证

CVR ID

  • 如需帮助查找凭证,请联系您的 Toss 代表。

在 Campaign Lab 中选择 Toss 和应用

  1. 找到 Campaign Lab​ ,选择 合作伙伴​ 。
  2. 选择 新合作伙伴​ > Toss​ 。选择 下一步​ 进入下一界面。
  3. 应用选择​ 界面选择要创建链接的应用,启用集成来与 Toss 分享数据。
  4. 选择 下一步​ 。

启用数据分享

启用数据分享以激活与 Toss 的集成。要启用数据分享:

  1. 输入您的 CVR ID。

启用与 Toss 的数据分享后,Adjust 会默认自动向 Toss 发送以下数据:

  • 安装
  • 会话
  • 再归因
  • 事件

设置数据分享

如果您的多平台应用启用了多个平台的数据分享,那么可以:

  1. 通过选择 使用平台特定设置​ 来在平台层级区分数据共享设置。
  2. 通过选择 使用全局设置​ 来为多个平台应用相同的数据共享设置。

哪些数据会默认分享?​ 部分, 查看 Adjust 默认与 Toss 分享的活动。

  • 安装
  • 会话
  • 再归因
  • 事件

发送额外数据

选择您想通过回传与 Toss 分享的数据量和数据类型。Toss 可能会使用此信息来优化表现。

  1. 您想分享哪些数据来源?​ 部分,选择与 Toss 分享数据的归因来源:
  • 来自所有归因渠道的数据
  • 仅限归因至 Toss 的数据

会话

由于会话数量过大,Adjust 不会自动发送会话回传。启用会话分享后,Toss 将接收应用的会话活动数据。

应用内收入 (来自应用内购买)

通过应用内收入分享,Toss 可以接收收入金额以及您的收入事件数据。您需要映射能产生收入的事件,才能分享该数据。

映射事件

将您想分享的事件映射到 Toss 可以接收的值。未映射事件的数据不会被发送至 Toss。

映射单个事件

如果您的应用为多平台应用,则可以选择按平台与 Toss 分享不同事件。这有助于您:

  • 通过设定单个事件来管理不同平台的推广活动策略。
  • 按平台自定义数据分享。

映射事件​ 中,按照以下步骤选择要直接发送至 Toss 的应用内事件。

  1. 选择 映射事件​ 。

  2. Adjust 事件​ 列表中,选择要与 Toss 分享的 Adjust 事件。

  3. 合作伙伴事件​ 下,您需要选择与 Adjust 事件对应的 Toss 事件。

    1. 对于单平台应用和仅针对一个平台启用了数据共享的多平台应用,您只能针对一个平台映射事件。对于针对多个平台启用了数据共享的多平台应用,您可以:

      • 选择 使用平台特定映射​ 来在平台层级映射单独事件或不针对某些平台映射事件。
      • 选择 使用全局映射​ 来为所有平台映射相同的事件。
    2. 打开 合作伙伴​ 列表,选择要映射到 Adjust 事件的渠道事件,或输入自定义事件名称。

  4. 选择 确认​ 。

现在 Toss 将接收每个关联事件的应用内事件数据。

映射全部事件

如果 Toss 支持自动映射所有事件,则在 映射事件​ 下选择 映射全部事件​ ,这能够省去映射单个事件的时间。

现在 Toss 将接收所有关联事件的应用内事件数据。

映射参数

要与 Toss分享自定义数据,您通常需要映射参数。

合作伙伴参数 (在 Adjust SDK 4.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点,并将其发送至 Toss。借此,Toss 可以接收每个已关联事件的自定义事件详情。

在向 Adjust SDK 添加新的合作伙伴参数之前,请确保现有的合作伙伴参数均不符合您的要求。

如需与 Toss 分享合作伙伴参数,请遵循以下步骤。

  1. 在 Adjust SDK 中设置合作伙伴参数。

  2. 设置数据分享​ 下,选择 参数​ 。

  3. 打开 映射参数​ ,选择如何向渠道发送 SDK 中指定的合作伙伴参数。

    1. 选择 映射参数​ 。
    2. SDK 参数​ 字段中输入要与渠道分享的 SDK 参数名称。
    3. 合作伙伴参数​ 字段中输入 SDK 参数对应的渠道参数。
请注意:

如果您在 Adjust SDK 中设置了合作伙伴参数而没有在控制面板中设置参数分享,那么 Adjust 会按照 Adjust SDK 中的名称发送参数。

配置链接和设置

您可以进行以下设置:

创建链接并与 Toss 分享

设置概览​ 界面,您可以检查自己的选择,也可以返回并更改以下内容:

  • 所选应用
  • 数据分享选项
  • 链接结构参数
  • 用户目的位置
  • 归因设置

选择 创建链接​ 来创建点击 URL、展示 URL、二维码和链接识别码。创建链接还会启用数据共享及与 Toss 的集成。

创建链接后,请与 Toss 分享链接,以便在推广活动中放置。

转发给 Toss 的所有参数列表

Toss 要求 Adjust 在回传中发送以下参数 (数据点):

占位符信息
{adid}Adjust 设备 ID(所有平台)
{android_id_md5}小写安卓 ID 十六进制 MD5 哈希
{android_id}安卓 ID(仅限安卓设备)
{city}设备所在城市
{click_attribution_window}设备匹配的归因窗口设置(小时数)
{country_subdivision}设备的国家/地区细分(例如:州)
{country}两字符设备国家/地区代码
{currency}从 Adjust SDK 发送的原始 ISO 4217 货币代码
{deeplink}附加到点击 URL 的深度链接 URL
{device_name}设备型号
{device_type}设备类型
{environment}当前 Adjust SDK 的环境设置
{event_name}控制面板中设定的事件名称
{fire_adid}Fire OS 广告标识符
{gps_adid}Google Play 应用商店广告 ID
{idfa}广告主 ID(仅限 iOS 设备)
{idfv}供应商的大写 iOS ID
{impression_attribution_window}展示匹配的归因窗口设置(小时数)
{ip_address}设备 IP 地址
{is_reattributed}如果用户曾被推广渠道再归因至少一次,则参数为 1。如果用户从未被再归因,则参数为 0
{isp}设备互联网服务供应商
{label}点击时发送的 Adjust “标签”参数值
{language}设备两字符语言代码
{last_time_spent}用户上次会话时长(以秒计)
{lifetime_session_count}用户整个生命周期中记录的会话数量
{mac_md5}大写字母 MAC MD5 哈希
{mac_sha1}大写字母 MAC SHA-1 哈希
{match_type}归因方法
{mcc}移动设备国家/地区代码:用于识别设备国家/地区的三字符代码。与移动网络代码同时使用,用于识别设备运营商。
{mnc}移动网络代码:两字符代码。与移动国家/地区代码同时使用来识别设备运营商。
{nonce}随机小写字母数字字符串(每个回传都有唯一的字符串)
{os_name}设备操作系统
{os_version}操作系统版本号
{partner_parameters}Adjust SDK 或 S2S 请求收集并且通过回调传输给第三方提供商的自定义合作伙伴参数
{postal_code}设备 IP 地址的邮政编码
{random_user_id}随机用户 ID(按设备)
{random}随机数(每个回传都有唯一的随机数)
{reftag}随机设备参考标签
{region}设备地区代码
{reporting_currency}控制面板报告的 ISO 4217 货币代码
{reporting_revenue}Adjust 控制面板中报告的收入(精确到货币整数)
{revenue}从 Adjust SDK 发送的收入(以分计)
{sdk_version}Adjust SDK 版本(按应用)
{session_count}当前 Adjust SDK 记录的会话数量
{timezone}设备时区
{tracking_enabled}若已启用跟踪,则为 1;若未启用跟踪,则为 0
{tracking_limited}若跟踪受限,则为 1;若跟踪未受限,则为 0
{user_agent}传入的原始用户代理
{win_adid}Windows 广告标识符
{win_hwid}Windows 商店硬件 ID
{win_naid}Windows 商店网络适配器 ID
{win_udid}Windows Phone 唯一设备 ID
{activity_kind}用户活动类型
{app_id}商店应用 ID 或 Google Play 商店
{app_name}应用名称
{app_version_raw}应用版本号 (安卓),Bundle build 版本号 (iOS)
{app_version_short}应用版本号 (安卓),Bundle release 版本号 (iOS)
{app_version}应用版本号 (安卓),Bundle build 版本号 (iOS)
{campaign_name}推广活动名称,取自跟踪链接
{click_time}归因的点击时间戳
{connection_type}互联网连接类型
{conversion_duration}点击与安装或再归因之间的时间(以秒计)
{cpu_type}CPU 类型
{creative_name}素材名称,取自跟踪链接
{device_manufacturer}设备制造商名称
{engagement_time}交互时间戳
{first_tracker_name}用户首个归因来源的名称
{hardware_name}硬件名称
{impression_based}如基于展示,则参数为 1,否则为 0
{impression_time}归因的展示时间戳
{install_begin_time}应用下载开始的时间戳(仅限安卓和 Google Play 商店)
{install_finish_time}应用下载完成的时间戳
{installed_at}安装(即首次打开应用)时间戳
{is_organic}若为自然流量,则为 1;若为非自然流量,则为 0
{last_session_time}上次会话时间戳
{last_tracker_name}再归因用户的先前跟踪链接名称
{network_name}渠道名称,取自跟踪链接
{network_type}渠道类型
{reattributed_at}再归因时间戳
{referral_time}用户登录应用商店页面的时间戳(仅限安卓和 Google Play 商店)
{reinstalled_at}重装时间戳
{store}点击的目标商店
{tracker_name}当前跟踪链接名称
{oaid_md5}OAID MD5 哈希
{oaid}OAID 设备 ID
{is_s2s}1 代表服务器到服务器交互;否则为 0
{is_s2s_engagement_based}如果归因至服务器到服务器的交互,该占位符值为 1;反之为 0
{proxy_ip_address}用户代理服务器的 IP 地址
{third_party_tracking_disabled}1 代表第三方共享已禁用,0 代表未禁用