阿哈利姆与 ThinkingData 集成

本指南详细说明了如何将阿哈利姆与 ThinkingData 集成，以优化玩家分析和数据追踪流程。 通过将阿哈利姆与 ThinkingData 连接，您可以追踪玩家在游戏枢纽及其他销售渠道中的购买和退款行为，从而将阿哈利姆的交易事件与您游戏自身的分析数据关联起来。

阿哈利姆通过 ThinkingData REST API 在服务端向 ThinkingData 发送事件，因此无需任何客户端配置。

要求

• 拥有 ThinkingData 账号，并已在 TE 后台创建项目。
• 可获取项目的 APP ID。

第 1 步：在 ThinkingData 中获取项目凭据

1. 打开 ThinkingData（TE）后台，进入项目管理页面。
2. 复制目标项目的 APP ID。
3. 如果您使用 ThinkingData 私有化部署，还需在系统设置 → 数据接收地址中复制数据接收地址，并在其后追加 /sync_json 路径，例如 https://receiver.example.com/sync_json。SaaS 项目会自动使用默认的全球接收端点。

第 2 步：在阿哈利姆中配置集成

1. 访问阿哈利姆控制台 → 阿哈利姆接入 → ThinkingData。
2. 填写配置字段（参见下表）。
3. 点击安装按钮完成集成设置。

字段	说明	是否必填
App ID	ThinkingData 后台中项目的 APP ID。	是
Receiver URL	以 /sync_json 结尾的完整 ThinkingData 原始数据接收端点（适用于私有化部署）。若未指定，则默认使用全球 ThinkingData 端点（https://global-receiver-ta.thinkingdata.cn/sync_json）。	否
Purchase Event Name	购买事件的自定义事件名。默认为 purchase。	否
Refund Event Name	退款事件的自定义事件名。默认为 refund。	否
Property Prefix	添加到所有事件属性名前的前缀。例如，设置 agn_ 后属性名将变为 agn_order_id。	否
Excluded Sales Channels	所选销售渠道（Game Hub、Checkout、SDK、Checkout links）的购买事件将不会被发送用于追踪。退款事件不受此设置影响，始终发送。	否

备注

自定义事件名和属性名（含前缀）必须遵循 ThinkingData 命名规则：以字母开头，仅包含字母、数字和下划线，且长度不超过 50 个字符。保存配置时不会校验这些值，请确保带前缀的属性名（例如 <prefix>total_amount_decimal_usd）不超出限制。

第 3 步：验证集成

安装集成时不会向 ThinkingData 发送测试请求，因此错误的 App ID 或 Receiver URL 只有在发送第一个事件时才会暴露。要验证配置，请通过未列入 Excluded Sales Channels 的销售渠道完成一笔测试购买，然后检查购买事件是否已出现在您的 ThinkingData 项目中，且 #account_id 和属性（见下文）符合预期。要验证退款追踪，请对该测试订单发起退款，并确认相应的退款事件已出现。

发送至 ThinkingData 的事件

集成配置完成后，阿哈利姆会自动为玩家订单发送**购买（purchase）和退款（refund）**事件。事件的 #account_id 为玩家的阿哈利姆 Player ID，便于与您游戏中的事件进行匹配。事件的 #time 为：购买事件对应订单创建时间，退款事件对应退款时间。

每个事件包含以下属性（若配置了前缀则会应用前缀）：

属性	类型	说明
order_id	string	阿哈利姆订单 ID。
item_sku	string	订单中商品的 SKU，以逗号分隔。
amount_decimal	number	以支付货币计的订单金额。使用积分（Reward Points）或虚拟货币支付的订单为 0。
currency	string	支付货币代码。使用积分（Reward Points）或虚拟货币支付的订单为 USD。
payment_number	string、null	人类可读的支付收据编号。对于没有支付服务商收据的订单（如使用积分或虚拟货币支付的订单），该值为 null。
total_amount_decimal_usd	number、null	以美元计的订单总金额。
revenue_decimal_usd	number、null	购买事件为以美元计的客户收入；退款事件为退款导致的收入变动，以负值（或 0）发送。

需要技术支持？
联系我们的集成技术团队： [email protected]