事件回调

一、功能概述

适用场景

• 实时获取用户行为事件数据
• 与自有 BI/数据系统进行打通
• 基于事件数据进行二次营销或分析

二、配置步骤

1.开启事件回调开关

2.选择回调事件

3.配置回调地址

注意：请确保该地址为可公网访问的域名，且服务稳定。

4.配置回调参数（可选）

5.设置请求方式

6.设置超时与重试

三、签名生成

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()

四、回调数据结构说明

请求体格式

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

字段说明

五、接入示例

回调请求示例

curl -X POST "https://your-server.com/callback" \
  -H "Content-Type: application/json" \
  -d '{
    "app_id": "your_app_id", // 引力的appID
    "client_id": "your_client_id", // 客户ID
    "sign":"8bf4b8a9abadab70009b3f84cdd14eba",//签名
    "events": [   //事件列表
        {
            "event": "eventname", //事件名称
            "time":1779439377000, //事件发生时的毫秒时间戳
            "properties": {       //事件属性
            }
        }
    ],
   //配置的宏参数和自定义参数
    "callback_params": {
        "key1" :"value1",
        "key2" :"value2"
    }
}'

服务端响应要求