发送转化
当发生销售或注册时，您的服务器随访问一起发送；之后可以更改其状态，例如退款时。
调用
POST https://<your workspace address>/track/conversions
x-api-key: your API key
Content-Type: application/json
{
"hit": "h1.…",
"conversionTypeCode": "sale",
"externalId": "order-1042",
"amount": { "value": 49.90 },
"currency": "EUR"
}
| 字段 | |
|---|---|
hit |
来自 hitctrl Cookie（或服务器端访问）的签名访问。 |
conversionTypeCode |
必填。转化类型的代码，例如 sale。 |
externalId |
您的订单或交易 ID。相同的 ID 只计一次，因此重试是安全的。 |
amount.value、currency |
销售金额；百分比佣金需要它。其他货币按当天汇率换算。 |
exchangeRate |
您自己的、到工作区货币的汇率（如果工作区接受）。 |
couponCodes |
使用的优惠券代码；优惠券的合作伙伴先于访问获得该销售。 |
externalClientId |
您注册的客户；销售计入该客户访问对应的合作伙伴。 |
country |
买家的国家（两个字母）；销售按它而不是访问的国家定价。 |
customParams.advS1–advS5 |
您自己的值；佣金组和反欺诈规则可以使用它们。 |
status |
approved、pending 或 test；省略时使用优惠目标设定的状态。 |
hit、couponCodes 或 externalClientId 三者必须有其一。该调用也可以作为 GET 使用，把相同的值放在地址中。
之后更改状态
POST https://<your workspace address>/track/conversions/status
{ "externalId": "order-1042", "status": "refunded" }
status 为 approved、pending、rejected 或 refunded。如果一个订单有多种类型的转化，请添加 conversionTypeCode。
高峰负载
发送请求头 Prefer: respond-async：会立即返回 202，转化稍后记录。
这解答了你的问题吗？
已于 2026年10月18日 与应用核对