标签数据接入
1.标签介绍
标签的基本形式是用户标识+标签ID+时间(选填)
1) 人群和标签的核心区别是什么?
- a) 标签可带有时间戳
- b) 标签可有层级结构
2) 为什么传入标签而不是人群
- a) 标签比人群更细化,可增加时间戳选择,
- b) 标签具有层级结构
3) 标签是否一定要带有时间戳?
标签上传时可以没有时间戳,系统会为其标上最新的时间戳,此标签的人会被任意时间窗的人群选中。
2. API接入流程
Step 1. 创建客户标签
Step 2.向客户标签里上传文件数据
2.1 创建客户标签
广告主第一步调用创建客户标签接口需要在自己的account id账号下创建一个标签,系统返回tag_id。
在创建标签时,广告主需要提供账号id、父节点id(选填,不填时默认为0,表示该标签为根节点标签)、标签名称(同一父节点下的标签名称不能重复)、标签描述、标签编码(选填)。
其中标签编码是广告主对标签在自己系统里的编码,只能包含数字或字母或下划线,字段长度最小 1 字节,长度最大 128 字节。
标签编码与创建cutom audience用到的outer_audience_id一起做重入判断,如果创建标签时用的标签编码与已有的outer_audience_id重复,应答错误。如果创建标签时用的标签编码与已有的tag_code重复,返回已经创建的tag_id,不会创建新的同标签编码的tag。如果创建标签时用的标签编码与已有的tag_code和outer_audience_id都不重复,新创建一个tag,返回tag_id。
创建完标签后,可以调用获取客户标签接口,获取已经创建的标签信息。通过该接口,广告主可以查询自己账号下的标签,筛选条件包括父节点id、标签id、标签编码,三种筛选方式只能任选一种。应答返回筛选出来的标签列表,每个标签有标签id、父节点id、标签名称、标签描述、标签编码、用户覆盖数、创建时间等信息。
2.2 向客户标签里上传数据文件
在成功创建了一个标签后,可以调用接口向客户标签中上传数据文件,需要提供账号id、号码包用户id类型、标签id、标签人群文件,如果号码包用户id类型是WECHAT_OPENID或者MOBILE_QQ_OPENID,还需要提供open_app_id。标签人群文件,文件格式为CSV,是两列纯文本,英文逗号分隔,第一列是用户标识id(QQ号、IMEI号等),需要与接口里的号码包用户id类型一致;第二列是时间戳(选填),UNIX 时间,单位到秒,格式如 1901010111 ;支持文件压缩后的 zip 包,压缩后的 zip 包不超过 100M。
您可以通过获取标签数据文件来查询您的标签数据文件的处理状态。
3.标签更新与删除
3.1 标签更新
广告主可以通过调用标签更新接口来修改标签名称与标签描述。
3.2 标签删除
广告主可以通过调用标签删除接口来删除不需要的标签。
被删除标签必须符合以下要求:
- 1、没有绑定非删除状态的广告;
- 2、没有绑定非删除状态的定向包;
- 3、没有用于组合人群的创建;
- 4、仅支持删除叶子节点,若要删除父节点必须先删除该节点下的所有子节点。