设置 KARTE
KARTE 是一家已与 Adjust 集成的数据分析合作伙伴。我们的集成允许 KARTE 通过自动回传接收 Adjust 监测的数据。您可以使用合作伙伴的工具进行数据分析并获取洞见。
在本文中了解如何为您的应用设置 KARTE 监测，其中包括激活集成，以及选择 Adjust 可以与 KARTE 分享的数据。
操作前须知
要求
- Adjust 中的管理员、编辑员或自定义编辑员权限。
- Adjust SDK v4.0.0 或更新版本，以便将 SDK 参数映射至 KARTE 参数。按照以下指南使用此功能。
iOS | 安卓 | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
凭证
API KEY
- 如需帮助查找凭证，请联系您的 KARTE 代表。
在 Campaign Lab 中选择 KARTE 和应用
- 找到 Campaign Lab ，选择 合作伙伴 。
- 选择 新合作伙伴 > KARTE 。选择 下一步 进入下一界面。
- 在 应用选择 界面选择要创建链接的应用，启用集成来与 KARTE 分享数据。
- 选择 下一步 。
启用数据分享
启用数据分享以激活与 KARTE 的集成。要启用数据分享：
- 输入您的 API KEY。
启用与 KARTE 的数据分享后，Adjust 会默认自动向 KARTE 发送以下数据：
- 安装
- 重装
- 重装再归因
- 再归因
- 事件
设置数据分享
如果您的多平台应用启用了多个平台的数据分享，那么可以：
- 通过选择 使用平台特定设置 来在平台层级区分数据共享设置。
- 通过选择 使用全局设置 来为多个平台应用相同的数据共享设置。
在 哪些数据会默认分享？ 部分, 查看 Adjust 默认与 KARTE 分享的活动：
- 安装
- 重装
- 重装再归因
- 再归因
- 事件
发送额外数据
选择您想通过回传与 KARTE 分享的数据量和数据类型。KARTE 可能会使用此信息来优化表现。
要发送额外数据，您可以查看并自定义以下选项：
卸载与重装
通过共享卸载或重装数据，KARTE 可以接收 Adjust 监测的所有应用卸载和/或重装数据。
对于 iOS 应用，记录到的卸载和/或重装可能会偏低。要获取更多信息，请参考卸载和重装监测。
应用内收入 (来自应用内购买)
通过应用内收入分享，KARTE 可以接收收入金额以及您的收入事件数据。您需要映射能产生收入的事件，才能分享该数据。
映射事件
将您想分享的事件映射到 KARTE 可以接收的值。未映射事件的数据不会被发送至 KARTE。
映射单个事件
如果您的应用为多平台应用，则可以选择按平台与 KARTE 分享不同事件。这有助于您：
- 通过设定单个事件来管理不同平台的推广活动策略。
- 按平台自定义数据分享。
在 映射事件 中，按照以下步骤选择要直接发送至 KARTE 的应用内事件。
选择 映射事件 。
在 Adjust 事件 列表中，选择要与 KARTE 分享的 Adjust 事件。
在 合作伙伴事件 下，您需要选择与 Adjust 事件对应的 KARTE 事件。
对于单平台应用和仅针对一个平台启用了数据共享的多平台应用，您只能针对一个平台映射事件。对于针对多个平台启用了数据共享的多平台应用，您可以：
- 选择 使用平台特定映射 来在平台层级映射单独事件或不针对某些平台映射事件。
- 选择 使用全局映射 来为所有平台映射相同的事件。
打开 合作伙伴 列表，选择要映射到 Adjust 事件的渠道事件，或输入自定义事件名称。
选择 确认 。
现在 KARTE 将接收每个关联事件的应用内事件数据。
映射全部事件
如果 KARTE 支持自动映射所有事件，则在 映射事件 下选择 映射全部事件 ，这能够省去映射单个事件的时间。
现在 KARTE 将接收所有关联事件的应用内事件数据。
映射参数
要与 KARTE分享自定义数据，您通常需要映射参数。
合作伙伴参数 (在 Adjust SDK 4.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点，并将其发送至 KARTE。借此，KARTE 可以接收每个已关联事件的自定义事件详情。
在向 Adjust SDK 添加新的合作伙伴参数之前，请确保现有的合作伙伴参数均不符合您的要求。
如需与 KARTE 分享合作伙伴参数，请遵循以下步骤。
在 Adjust SDK 中设置合作伙伴参数。
- 在操作前须知部分查看所有 SDK 开发平台链接。
在 设置数据分享 下，选择 参数 。
打开 映射参数 ，选择如何向渠道发送 SDK 中指定的合作伙伴参数。
- 选择 映射参数 。
- 在 SDK 参数 字段中输入要与渠道分享的 SDK 参数名称。
- 在 合作伙伴参数 字段中输入 SDK 参数对应的渠道参数。
如果您在 Adjust SDK 中设置了合作伙伴参数而没有在控制面板中设置参数分享，那么 Adjust 会按照 Adjust SDK 中的名称发送参数。
为您的应用启用 KARTE
在 设置概览 界面，您可以检查自己的选择，也可以返回并更改以下内容：
- 所选应用
- 数据分享选项
选择 启用合作伙伴 ，为您的应用启用 KARTE 。数据分析合作伙伴不使用推广活动链接。启用合作伙伴后，我们的集成会通过自动回传发送归因和应用内事件数据。
合作伙伴特定设置说明
预定义参数
Karte 允许您发送一组预定义参数。如果将这些参数中的任一参数附加到您的 Adjust SDK 中的事件中，该参数将会转发至 Karte。有关附加合作伙伴参数的更多信息，请参阅您正在使用的单个或多个 SDK 的相应 SDK 说明文件。以下是 Karte 可以接受的已定义参数的列表：
参数键 > 值
- visitor_id> 向 Karte 发送回传时为强制参数。
如需发送事件回传给 Karte，您必须在 Adjust SDK 中将 visitor_id 设置为会话和事件合作伙伴参数。在 Adjust 控制面板中启用 参数转发 功能。
要了解详情，请同时参考Karte 支持页面（日文）。
转发给 KARTE 的所有参数列表
KARTE 要求 Adjust 在回传中发送以下参数 (数据点)：
| 占位符 | 信息 |
{adid} | Adjust 设备 ID（所有平台） |
{android_id} | 安卓 ID（仅限安卓设备） |
{api_level} | API 层级（仅限安卓） |
{city} | 设备所在城市 |
{click_attribution_window} | 设备匹配的归因窗口设置（小时数） |
{cost_amount} | 用户交互的成本（仅用于广告支出跟踪） |
{cost_currency} | 成本数据的 ISO 4217 货币代码（仅用于广告支出跟踪） |
{cost_type} | 推广活动定价模型（仅用于广告支出跟踪） |
{country_subdivision} | 设备的国家/地区细分（例如：州） |
{country} | 两字符设备国家/地区代码 |
{currency} | 从 Adjust SDK 发送的原始 ISO 4217 货币代码 |
{deeplink} | 附加到点击 URL 的深度链接 URL |
{device_name} | 设备型号 |
{device_type} | 设备类型 |
{environment} | 当前 Adjust SDK 的环境设置 |
{fire_adid} | Fire OS 广告标识符 |
{gps_adid_md5} | Google Play 商店广告 ID 的小写十六进制 MD5 哈希 |
{gps_adid} | Google Play 应用商店广告 ID |
{idfa} | 广告主 ID（仅限 iOS 设备） |
{idfv} | 供应商的大写 iOS ID |
{impression_attribution_window} | 展示匹配的归因窗口设置（小时数） |
{inactive_user_definition} | 符合再归因资格的非活跃时长（以小时数计） |
{ip_address} | 设备 IP 地址 |
{isp} | 设备互联网服务供应商 |
{language} | 设备两字符语言代码 |
{last_time_spent} | 用户上次会话时长（以秒计） |
{lifetime_session_count} | 用户整个生命周期中记录的会话数量 |
{match_type} | 归因方法 |
{nonce} | 随机小写字母数字字符串（每个回传都有唯一的字符串） |
{os_name} | 设备操作系统 |
{os_version} | 操作系统版本号 |
{partner_parameters} | Adjust SDK 或 S2S 请求收集并且通过回调传输给第三方提供商的自定义合作伙伴参数 |
{postal_code} | 设备 IP 地址的邮政编码 |
{random_user_id} | 随机用户 ID（按设备） |
{random} | 随机数（每个回传都有唯一的随机数） |
{reattribution_attribution_window} | 再归因的归因窗口设置（小时数） |
{reftag} | 随机设备参考标签 |
{reporting_cost} | 换算成您的应用报告币种且在 Adjust 控制面板中报告的用户交互成本（仅用于广告支出跟踪） |
{reporting_currency} | 控制面板报告的 ISO 4217 货币代码 |
{reporting_revenue} | Adjust 控制面板中报告的收入（精确到货币整数） |
{revenue_float} | 从 Adjust SDK 发送的收入（以货币整数计） |
{revenue} | 从 Adjust SDK 发送的收入（以分计） |
{session_count} | 当前 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_dashboard} | Adjust 控制面板中的应用名称 |
{app_version_raw} | 应用版本号 (安卓)，Bundle build 版本号 (iOS) |
{app_version_short} | 应用版本号 (安卓)，Bundle release 版本号 (iOS) |
{app_version} | 应用版本号 (安卓)，Bundle build 版本号 (iOS) |
{attribution_updated_at} | 更新归因时间戳 |
{campaign_name} | 推广活动名称，取自跟踪链接 |
{click_time} | 归因的点击时间戳 |
{connection_type} | 互联网连接类型 |
{conversion_duration} | 点击与安装或再归因之间的时间（以秒计） |
{created_at} | 活动时间戳 |
{creative_name} | 素材名称，取自跟踪链接 |
{engagement_time} | 交互时间戳 |
{impression_based} | 如基于展示，则参数为 1，否则为 0 |
{impression_time} | 归因的展示时间戳 |
{install_begin_time} | 应用下载开始的时间戳（仅限安卓和 Google Play 商店） |
{install_finish_time} | 应用下载完成的时间戳 |
{installed_at} | 安装（即，首次打开应用）时间戳 |
{is_organic} | 若为自然流量，则为 1；若为非自然流量，则为 0 |
{last_session_time} | 上次会话时间戳 |
{network_name} | 渠道名称，取自跟踪链接 |
{reattributed_at} | 再归因时间戳 |
{referral_time} | 用户登录应用商店页面的时间戳（仅限安卓和 Google Play 商店） |
{reinstalled_at} | 重装时间戳 |
{store} | 点击的目标商店 |
{time_to_reinstall} | 应用最新卸载与后续重装之间的时长（以秒为单位） |
{time_to_uninstall} | 应用安装（或最新重装）与后续卸载之间的时长（以秒为单位） |
{tracker_name} | 当前跟踪链接名称 |
{uninstalled_at} | 卸载时间戳（按上次会话时间估算） |
{google_ads_creative_id} | Google Ads 素材 ID |