You need to enable JavaScript to run this app.
导航

资源位预置埋点说明

最近更新时间2023.06.26 15:23:40

首次发布时间2022.07.29 14:05:13

公共属性

公共属性指的是所有资源位上报事件都会带上的属性

属性显示名属性英文名类型示例
客户IDclient_idstringgmp_banner
项目IDapp_idlong1
SDK版本sdk_version (2.1.0以下,无该字段)
gmp_sdk_version (2.1.0及以上)
string0.0.1
平台类型platform_typestringandroid
业务businessstringresource
素材位IDbanner_idstring0bc36beb

资源位类型

resource_type

int

规则型:0
个性化:1

除了上述属性外,所有通过 Finder 上报的事件还会带上 Finder 的预设属性

算法资源位依赖公共属性

算法资源位公共属性是指在算法资源位相关埋点上需要带上的公共属性,下列属性会在除加载失败事件外的其他事件中携带

属性字段 是否必填 属性类型 说明
spm string SPM(Super Position Model)全称超级位置模型,主要用于标识行为发生的位置。SPM位置编码由A/B/C/D四段构成,各分段分别代表 A:业务, B:页面, C:页面区块, D:区块内点位。段之间用$##$分隔,即A$##$B$##$C$##$D,spm各段建议传明文。某一段为空时直接传空字符串,如第二段为空, 则传“A$##$$##$C$##$D”。
1.业务:业务名称,如今日头条
2.页面:如首页、发现页-推荐等
3.页面区块:如广告位、猜你喜欢
4.区块内点位:在区块内的具体位置
trans_data string 服务端透传数据,用于追踪数据链路,对应服务端下发的 trans_data 字段
gmp_trans_data string GMP 服务端透传数据,对应服务端下发的 gmp_trans_data 字段
context_item_id string 相关推荐id,对应请求时算法资源位传入的 context_item_id 字段
context_item_type string 相关推荐类型,对应请求时算法资源位传入的 context_item_type 字段
resource_id string 算法回流资源位 id,由服务端下发,对应服务端下发的 resource_id 字段
ab_sdk_version string 服务端透传数据,对应服务端下发的 ab_sdk_version 字段
自定义字段 自定义 客户端自定义字段,如果 org\_id(机构 id)等
预设事件
事件显示名 事件英文名 事件属性 触发时机
属性显示名 属性英文名 属性类型 属性示例
资源位数据拉取成功 resource_load_success 公共属性 资源位拉取成功时调用
帧位id item_id string {1,2,3}
素材id content_id string {1,2,3}
资源位数据拉取失败 resource_load_failed 公共属性 资源位拉取失败时调用
1. 请求异常(code != 200)
2. 资源位id为空
3. 资源位素材为空
4. 本地网络异常
5. json序列化错误
6. 资源位不存在
7. 不支持的资源位类型
帧位id item_id long 1
素材id content_id long 1
资源位展示成功 resource_show_success 公共属性 资源位曝光时调用,其中根据接入方式不同可分为:
1. SDK渲染:SDK渲染下素材每次从100%不可见到100%可见时都会上报一次
2. 自渲染:自渲染下曝光逻辑由客户自行决定,调用SDK提供的接口上报即可
帧位id item_id long 1
素材id content_id long 1
资源位展示失败 resource_show_fail 公共属性 资源位曝光失败时调用,其中根据接入方式不同可分为:
1. SDK渲染:SDK渲染下当图片素材的图片加载失败时会上报该事件
2. 自渲染:自渲染下曝光失败的逻辑由客户自行决定,调用SDK提供的接口上报即可
帧位id item_id long 1
素材id content_id long 1
错误信息 error_message string 图片加载失败
素材点击 resource_item_click 公共属性 资源位素材被点击时调用,其中根据接入方式不同可分为:
1. SDK渲染:SDK渲染下点击事件会由SDK在点击时上报
2. 自渲染:自渲染下点击事件由接入方自行上报,调用SDK提供的接口上报即可
帧位id item_id long 1
素材id content_id long 1
错误信息 error_message string 跳转url为空
是否跳转url is_click_url bool true
停留时长 resource_stay_duration 公共属性 上报用户的资源位停留时长,其中根据接入方式不同可分为:
1. SDK渲染:SDK渲染下会上报素材从100%可见到100%不可见之间的停留时长
2. 自渲染:自渲染下停留时长的逻辑由客户自行决定,调用SDK提供的接口上报即可
帧位id item_id long 1
素材id content_id long 1
停留时间(单位ms) resource_stay_duration long 图片加载失败