tencent cloud

文档反馈

匿名日志采集

最后更新时间:2024-01-20 17:14:28
    CLS 日志服务支持通过 Web Tracking 采集 HTML,H5,小程序,IOS 和 Android 等客户端的日志。

    使用场景

    匿名写入适用于采集各种浏览器,小程序,IOS/Android App 的用户信息。
    用户使用的浏览器、操作系统、分辨率等信息。
    用户浏览行为记录(例如:用户在网站上的点击行为、购买行为等信息)。
    用户在 App 中的停留时间、是否活跃等信息。

    操作步骤

    步骤1:开通匿名写入

    注意:
    使用匿名写入则表示目标投递日志主题打开互联网匿名写入权限,没有经过有效鉴权,可能产生脏数据。
    1. 登录 日志服务 控制台。
    2. 在左侧导航栏中,单击日志主题,在日志主题管理页中,单击创建日志主题,或找到已有日志主题并单击编辑,即可创建/编辑日志主题。
    3. 在日志主题创建或编辑弹窗中,找到匿名写入配置项, 并开启开关,即可开启匿名写入。

    步骤2:上传日志

    开通匿名写入后,您可以通过以下方法上传日志到日志主题中。

    方法1:通过浏览器 JavaScript SDK 上传日志

    详细信息您可参见 通过浏览器 JavaScript SDK 上传日志

    方法2:通过小程序 JavaScript SDK上传日志

    详细信息您可参见 通过小程序 JavaScript SDK 上传日志

    方法3:通过 HTTP GET 请求上传日志。

    参见如下命令上传日志,请根据实际值替换参数。
    curl --request GET 'http://{host}/track?topic_id={topic_id}&key1=val1&key2=val2'
    参数
    是否必填
    说明
    ${host}
    日志服务所在地域的 Endpoint。更多信息,请参见 可用地域
    ${topic_id}
    topic id
    key1=val1&key2=val2
    您要上传到日志服务的键值对(Key-Value),支持设置多个键值对。请确保长度小于16KB

    方法4:通过 HTML img 标签上传日志

    注意:
    Notice: track.gif 除了上传自定义的参数外,还会将 HTTP 头中的 UserAgent 也作为日志中的字段。
    <img src='http://${host}/track.gif?topic_id={topic_id}&key1=val1&key2=val2'/>

    方法5:通过 HTTP POST 请求上传日志

    如果请求的数据量比较大,可以使用 POST 方法上传数据。
    接口说明
    适用于在网页或者客户端采集日志的场景。
    使用 Web Tracking 采集日志时,单个请求只能写入一条日志。
    针对日志量较大的场景,可以调用 PutWebTracking 接口将多条日志合并为一次请求。
    该接口不支持同时写入多个Topic 的日志数据。
    请求头
    该接口使用公共请求头,无特殊请求头,详情可参见 公共请求参数 文档。
    请求语法
    POST http://${host}/tracklog?topic_id=${topic_id} HTTP/1.1
    参数
    是否必填
    说明
    ${host}
    日志服务所在地域的 Endpoint。更多信息,请参见 可用地域
    ${topic_id}
    topic id
    示例
    POST /tracklog?topic_id={topic_id} HTTP/1.1
    Host:ap-guangzhou.cls.tencentcs.com
    Content-Type:application/json
    {
    "logs": [{
    "contents": {
    "key1": "value1",
    "key2": "value2"
    },
    "time": 123456789
    }],
    "source": "127.0.0.1"
    }
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持