人群包自动管理解决方案

背景

广告客户有定期创建&更新人群包的诉求，通过定向或排除不同的人群包，以满足不同的拉新促活召回等广告投放目的。但以往创建&更新人群包需要登录DMP数据管理平台进行操作。且如果客户有多个投放账号，还需要逐个账号登录上传人群包，整个过程比较繁琐。

目前腾讯Marketing API给客户提供了人群包创建、更新和授权接口，通过MKT-API，你可以实现人群包自动化更新。通过这种方式，您不再需要人工跨账号地定时更新、上传人群包，可以通过API批量定时进行人群更新，将大幅释放您的优化师人力，并显著提升人群包的管理效率。

Marketing API 解决方案

腾讯marketing API提供了两种方法进行人群包自动更新。

1.通过数据源方式进行更新

腾讯提供了按行为数据源提取DMP人群的能力。只需要定时更新人群包使用的行为数据源，就可以达到更新人群包内人群的目的。以下介绍通过行为数据源创建和更新人群包的4个步骤：

步骤一：创建用户行为数据源

使用user_action_sets/add接口，创建用户行为数据源，获得用户行为源id

步骤二：往行为数据源里回传用户行为数据

使用user_actions/add接口，往第1步中创建的用户行为源id中回传本地的行为数据（如应用激活、注册、付费、加入购物车等）。其中部分参数说明如下：

步骤三：把行为数据提取成行为人群

使用custom_audiences/add接口，创建行为人群，选择类型为type=USER_ACTION，需要填写user_action_spec。user_action_spec的参数说明如下，具体的字段逻辑可对照 DMP数据管理平台-我的人群-创建人群-网站用户行为/移动应用用户行为-创建人群页面 来理解。

步骤四：定期更新数据

同第2步的操作步骤，通过SDK/API/JS均可以自动化往数据源里自动同步数据，这部分增量数据会在5分钟以内会根据行为人群规则自动同步至第3步所创建的行为人群中。
至此，您已经可以通过更新行为源的数据，达到更新人群包的人群数据目的。

2.通过人群包文件进行更新

腾讯也提供了按人群包文件创建人群包的能力，您可以通过更新人群包文件达到更新人群包人群的目的。

步骤一：设置目标人群包所需的标签/数据，并定时更新打包

您可以在本地实现人群监控，并结合人群行为，建立自有的人群标签。例如游戏A的已激活用户、近3日/7日未上线用户······建立标签后，您可以设置定时任务每日或者每周获取人群设备信息（QQ号、GDTopenid、手机号、IDFA、IMEI、OAID），并打包成该标签的人群包设备信息文件，准备上传给腾讯。

步骤二：调用腾讯MKT-API的接口上传人群包文件，创建人群包

创建人群包时，您需要使用custom_audiences/add接口，选择类型为type=CUSTOMER_FILE，获得人群id。再用custom_audience_files/add接口，往人群id中上传本地初始全量人群包设备信息文件。

您可以随时通过custom_audiences/get接口，获取status了解人群包的处理状态：
① 创建客户人群，但未上传过人群文件之前，status为待处理（pending）状态
② 创建客户人群，上传人群文件之后，status转为处理中（PROCESSING），处理完成后转为成功可用（SUCCESS）
③ 处理中（PROCESSING）的客户人群不可以创建广告

步骤三：调用腾讯MKT-API的接口上传人群包文件，更新人群包

更新人群包时，您可以使用custom_audience_files/add 接口，往人群id中上传本地增量人群包设备信息文件。更新的人群文件会在24小时内生效，生效后线上广告会自动应用。

您可以随时通过custom_audiences/get接口，获取status了解人群包的处理状态：
① 更新客户人群，上传人群文件之后，status转为处理中（PROCESSING），处理完成后转为成功可用（SUCCESS）
② 处理中（PROCESSING）的客户人群不可以创建广告