归因 · 事件回调 · Gravity Engine

import json
import hashlib
def get_sign(params: dict , access_token: str) -> str:
    """
    @param params: 请求体参数
    @param access_token: 引力 App 的 access_token（该参数在应用管理界面可以获取）
    """
    param_list = []
    for k, v in params.items():
        if k == "sign":
            continue
        param_list.append(f"{k}={json.dumps(v,sort_keys=True)}")
    param_list.sort()
    sb = "&".join(param_list) + access_token
    current_str = sb.replace("\"", "").replace(" ", "")
    return hashlib.md5(current_str.encode("utf-8")).hexdigest()

四、回调数据结构说明

当事件触发后，引力服务端会以 POST 方式向你配置的回调地址发送以下 JSON 格式数据：

请求体格式

{
    "app_id": "your_app_id",
    "client_id": "your_client_id",
    "sign": "8bf4b8a9abadab70009b3f84cdd14eba",
    "events": [
        {
            "event": "eventname",
            "time": 1779439377000,
            "properties": {}
        }
    ],
    "callback_params": {
        "key1": "value1",
        "key2": "value2"
    }
}

字段说明

字段	类型	说明
`app_id`	string	引力平台分配的应用 ID
`client_id`	string	客户唯一标识 ID
`sign`	string	签名，生成规则参考上方的签名生成
`events`	array	事件列表，可同时包含多个事件
`events[].event`	string	事件名称（如 `$UserAttribution`、`$PayEvent`）
`events[].time`	number	事件发生时的毫秒级时间戳（Unix timestamp）
`events[].properties`	object	事件的事件属性，根据事件类型动态变化
`callback_params`	object	你在配置界面添加的宏参数和自定义参数

五、接入示例

回调请求示例

curl -X POST 'https://your-server.com/callback' \
-H 'Content-Type: application/json' \
-d '{
  "app_id": "your_app_id",
  "client_id": "your_client_id",
  "sign": "8bf4b8a9abadab70009b3f84cdd14eba",
  "events": [
    {
      "event": "eventname",
      "time": 1779439377000,
      "properties": {}
    }
  ],
  "callback_params": {
    "key1": "value1",
    "key2": "value2"
  }
}'

服务端响应要求

您的服务端收到回调后，应在超时时间内返回 HTTP 200 状态码，且响应结果为 JSON 格式 {"code":0}，表示回调成功。若返回非 200 状态码、响应结果不是 JSON 格式，或请求超时，系统将按照配置的重试次数进行重试。

事件回调

本页内容