接口文档SDK业务专题开发者工具

标签数据接入

1.标签介绍

标签的基本形式是用户标识+标签ID+时间(选填)

1) 人群和标签的核心区别是什么?

    1. a) 标签可带有时间戳
    2. b) 标签可有层级结构

2) 为什么传入标签而不是人群

    1. a) 标签比人群更细化,可增加时间戳选择,
    2. 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、仅支持删除叶子节点,若要删除父节点必须先删除该节点下的所有子节点。