You need to enable JavaScript to run this app.
导航
使用接口导入行为数据
最近更新时间:2025.12.17 00:05:00首次发布时间:2025.12.17 00:05:00
复制全文
我的收藏
有用
有用
无用
无用

使用场景

创建行为数据集后,您可以使用接口写入行为数据,适配以下场景:

  • 导入历史的行为数据:​调用写入接口导入近7天、近30天等时间的历史行为数据
  • 实时上传行为数据:​调用写入接口实时从您的系统同步用户的曝光、点击、购买、观看等即时发生的行为数据

接口调用

您可以调用Dataset write接口来进行物品实时的数据导入(接口详情见:Write - 实时导入/更新数据)。行为数据仅能增量导入:

curl -X POST 'https://aisearch.cn-beijing.volces.com/api/v1/dataset/{dataset_id}/write' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <API Key>' \
  -d '{
    "fields": [
            {
                "user_id": "user134",
                "item_id": "1235",
                "event_type": "曝光",
                "event_timestamp": 1678886400000,
                "event_scene": "home"
            },
            {
                "user_id": "user134",
                "item_id": "1235",
                "event_type": "点击",
                "event_timestamp": 1678886400300,
                "event_scene": "home"
            },
        ]
}'
  • API Key:您可以根据 鉴权机制的操作流程创建一个可用的API Key
  • dataset_id:在接口路径中指定行为数据要写入的行为数据集
  • fields:一个JSON Object列表,列表中以JSON对象的形式上传多条行为数据

每次接口调用可接收最大不超过10MB的请求体,建议将大批量数据分批次调用接口上传以避免超时或传输失败。