设置 Ibotta
Ibotta 是一家已与 Adjust 集成的广告渠道。我们的集成允许 Ibotta 通过自动回传接收归因和应用内事件数据。
在本文中了解如何为您的应用设置 Ibotta 监测，这包括激活集成、创建推广活动链接、以及选择 Adjust 可以与 Ibotta 分享的数据。
操作前须知
要求
- Adjust 中的管理员、编辑员或自定义编辑员权限。
- Adjust SDK v4.0.0 或更新版本，以便将 SDK 参数映射至 Ibotta 参数。按照以下指南使用此功能。
iOS | 安卓 | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
凭证
PARTNER ID
- 如需帮助查找凭证，请联系您的 Ibotta 代表。
在 Campaign Lab 中选择 Ibotta 和应用
- 找到 Campaign Lab ，选择 合作伙伴 。
- 选择 新合作伙伴 > Ibotta 。选择 下一步 进入下一界面。
- 在 应用选择 界面选择要创建链接的应用，启用集成来与 Ibotta 分享数据。
- 选择 下一步 。
启用数据分享
启用数据分享以激活与 Ibotta 的集成。要启用数据分享：
- 输入您的 PARTNER ID。
启用与 Ibotta 的数据分享后，Adjust 会默认自动向 Ibotta 发送以下数据：
- 安装
- 会话
- 事件
设置数据分享
如果您的多平台应用启用了多个平台的数据分享，那么可以：
- 通过选择 使用平台特定设置 来在平台层级区分数据共享设置。
- 通过选择 使用全局设置 来为多个平台应用相同的数据共享设置。
在 哪些数据会默认分享？ 部分, 查看 Adjust 默认与 Ibotta 分享的活动。
- 安装
- 会话
- 事件
发送额外数据
选择您想通过回传与 Ibotta 分享的数据量和数据类型。Ibotta 可能会使用此信息来优化表现。
- 在 您想分享哪些数据来源？ 部分，选择与 Ibotta 分享数据的归因来源：
- 来自所有归因渠道的数据
- 仅限归因至 Ibotta 的数据
会话
由于会话数量过大，Adjust 不会自动发送会话回传。启用会话分享后，Ibotta 将接收应用的会话活动数据。
应用内收入 (来自应用内购买)
通过应用内收入分享，Ibotta 可以接收收入金额以及您的收入事件数据。您需要映射能产生收入的事件，才能分享该数据。
映射事件
将您想分享的事件映射到 Ibotta 可以接收的值。未映射事件的数据不会被发送至 Ibotta。
映射单个事件
如果您的应用为多平台应用，则可以选择按平台与 Ibotta 分享不同事件。这有助于您：
- 通过设定单个事件来管理不同平台的推广活动策略。
- 按平台自定义数据分享。
在 映射事件 中，按照以下步骤选择要直接发送至 Ibotta 的应用内事件。
选择 映射事件 。
在 Adjust 事件 列表中，选择要与 Ibotta 分享的 Adjust 事件。
在 合作伙伴事件 下，您需要选择与 Adjust 事件对应的 Ibotta 事件。
对于单平台应用和仅针对一个平台启用了数据共享的多平台应用，您只能针对一个平台映射事件。对于针对多个平台启用了数据共享的多平台应用，您可以：
- 选择 使用平台特定映射 来在平台层级映射单独事件或不针对某些平台映射事件。
- 选择 使用全局映射 来为所有平台映射相同的事件。
打开 合作伙伴 列表，选择要映射到 Adjust 事件的渠道事件，或输入自定义事件名称。
选择 确认 。
现在 Ibotta 将接收每个关联事件的应用内事件数据。
映射全部事件
如果 Ibotta 支持自动映射所有事件，则在 映射事件 下选择 映射全部事件 ，这能够省去映射单个事件的时间。
现在 Ibotta 将接收所有关联事件的应用内事件数据。
映射参数
要与 Ibotta分享自定义数据，您通常需要映射参数。
合作伙伴参数 (在 Adjust SDK 4.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点，并将其发送至 Ibotta。借此，Ibotta 可以接收每个已关联事件的自定义事件详情。
在向 Adjust SDK 添加新的合作伙伴参数之前，请确保现有的合作伙伴参数均不符合您的要求。
如需与 Ibotta 分享合作伙伴参数，请遵循以下步骤。
在 Adjust SDK 中设置合作伙伴参数。
- 在操作前须知部分查看所有 SDK 开发平台链接。
在 设置数据分享 下，选择 参数 。
打开 映射参数 ，选择如何向渠道发送 SDK 中指定的合作伙伴参数。
- 选择 映射参数 。
- 在 SDK 参数 字段中输入要与渠道分享的 SDK 参数名称。
- 在 合作伙伴参数 字段中输入 SDK 参数对应的渠道参数。
如果您在 Adjust SDK 中设置了合作伙伴参数而没有在控制面板中设置参数分享，那么 Adjust 会按照 Adjust SDK 中的名称发送参数。
配置链接和设置
您可以进行以下设置：
创建链接并与 Ibotta 分享
在 设置概览 界面，您可以检查自己的选择，也可以返回并更改以下内容：
- 所选应用
- 数据分享选项
- 链接结构参数
- 用户目的位置
- 归因设置
选择 创建链接 来创建点击 URL、展示 URL、二维码和链接识别码。创建链接还会启用数据共享及与 Ibotta 的集成。
创建链接后，请与 Ibotta 分享链接，以便在推广活动中放置。
合作伙伴特定设置说明
Ibotta 允许您发送一组预定义参数。如果将其中任一参数附加到您的 Adjust SDK 事件中，该参数将会被转发至 Ibotta。有关附加合作伙伴参数的更多信息，请参阅您正在使用的单个或多个 SDK 的相应 SDK 说明文件。以下是 Ibotta 可以接受的已定义参数的列表：
参数键 > 值
- productId > 用户访问或购买的产品 ID。“查看”、“添加至购物车”、“购买”和零售应用涉及的所有其他事件必须使用此 ID。非零售应用的事件跟踪可能需要使用不同的唯一 ID。
转发给 Ibotta 的所有参数列表
Ibotta 要求 Adjust 在回传中发送以下参数 (数据点)：
| 占位符 | 信息 |
{adid} | Adjust 设备 ID（所有平台） |
{android_id} | 安卓 ID（仅限安卓设备） |
{api_level} | API 层级（仅限安卓） |
{city} | 设备所在城市 |
{country} | 两字符设备国家/地区代码 |
{currency} | 从 Adjust SDK 发送的原始 ISO 4217 货币代码 |
{deeplink} | 附加到点击 URL 的深度链接 URL |
{device_name} | 设备型号 |
{device_type} | 设备类型 |
{environment} | 当前 Adjust SDK 的环境设置 |
{gps_adid} | Google Play 应用商店广告 ID |
{idfa} | 广告主 ID（仅限 iOS 设备） |
{ip_address} | 设备 IP 地址 |
{isp} | 设备互联网服务供应商 |
{language} | 设备两字符语言代码 |
{lifetime_session_count} | 用户整个生命周期中记录的会话数量 |
{match_type} | 归因方法 |
{nonce} | 随机小写字母数字字符串（每个回传都有唯一的字符串） |
{os_name} | 设备操作系统 |
{os_version} | 操作系统版本号 |
{partner_parameters} | Adjust SDK 或 S2S 请求收集并且通过回调传输给第三方提供商的自定义合作伙伴参数 |
{postal_code} | 设备 IP 地址的邮政编码 |
{random_user_id} | 随机用户 ID（按设备） |
{random} | 随机数（每个回传都有唯一的随机数） |
{reftag} | 随机设备参考标签 |
{revenue_float} | 从 Adjust SDK 发送的收入（以货币整数计） |
{sdk_version} | Adjust SDK 版本（按应用） |
{time_spent} | 用户当前会话时长（以秒计） |
{timezone} | 设备时区 |
{tracking_enabled} | 若已启用跟踪，则为 1；若未启用跟踪，则为 0 |
{tracking_limited} | 若跟踪受限，则为 1；若跟踪未受限，则为 0 |
{user_agent} | 传入的原始用户代理 |
{activity_kind} | 用户活动类型 |
{adgroup_name} | 广告组名称，取自跟踪链接 |
{app_id} | 商店的应用 ID 或 Google Play 商店 |
{app_name} | 应用名称 |
{app_version_raw} | 应用版本号 (安卓)，Bundle build 版本号 (iOS) |
{campaign_name} | 推广活动名称，取自跟踪链接 |
{connection_type} | 互联网连接类型 |
{conversion_duration} | 点击与安装或再归因之间的时间（以秒计） |
{created_at} | 活动时间戳 |
{creative_name} | 素材名称，取自跟踪链接 |
{engagement_time} | 交互时间戳 |
{impression_based} | 如基于展示，则参数为 1，否则为 0 |
{installed_at} | 安装（即，首次打开应用）时间戳 |
{is_organic} | 若为自然流量，则为 1；若为非自然流量，则为 0 |
{store} | 点击的目标商店 |
{tracker_name} | 当前跟踪链接名称 |