分群推送到腾讯广告

本文介绍如何将神策「分群」中的人群包推送到腾讯广告。按本手册操作，您可自行完成腾讯广告的授权与推送连接配置。

适用版本：SA 3.0.5 及以上版本。

前置说明：使用该功能前，请联系神策工作人员开通「人群包推送-国内平台 Licence」，并安装对应平台插件。完成插件配置后，即可在分群页面创建推送任务，选择 腾讯广告 作为目标渠道，进行人群包推送。

一、接入前准备（请确认）

在配置之前，请确认以下事项均已完成：

1. 已开通「人群包推送-国内平台」 Licence；

2. 已在神策后台安装腾讯广告插件；

3. 拥有一个可「创建应用」的开放平台账号，且拥有一个可登录腾讯广告的账号（QQ），且该账号已开通广告投放权限；

4. 选择「应用类型」及「授权流程」（见下文：私有应用自授权或三方应用 OAuth 授权）。

 

二、选择对接方式，进行授权配置

腾讯广告可以创建「私有应用」和「三方应用」两种类型的开发者应用，根据实际情况选择其一即可：

应用类型	授权类型	适合谁	特点
私有应用	自授权	适用于大多数客户（含普通广告主、代理商）	在神策抽屉手动填写 App ID、App Secret、Token、广告账号 ID
三方应用	OAuth授权	需具备「技术服务商」资质、或「已申请且通过腾讯审批」可创建三方应用	在神策抽屉填写 App ID、App Secret；首次在三方应用配置回调地址；OAuth 跳转授权后自动获取 Token，广告账号系统自动拉取，手动勾选即可

 

2.1 私有应用的自授权流程（推荐）

适用于大多数客户（普通广告主、代理商）。

在神策配置腾讯广告人群推送前，需在腾讯广告开发者平台创建私有应用，获取 Access Token 与 Refresh Token，用于后续调用腾讯广告人群管理相关接口。

前置条件

1. 已是开发者，且在腾讯广告开发者平台创建 私有应用。

   1. 若尚未注册为开发者，请参考腾讯官方文档《如何注册成为开发者？》完成注册。

   2. 若尚未创建应用，请参考腾讯官方文档《如何创建应用并申请权限？》完成应用创建及权限申请。

2. 已确认需授权的广告账号范围。

3. 神策后台具备「数据管理 > 数据源管理」操作权限。

 

操作步骤

Steo 1：在腾讯广告侧获取令牌步骤说明

1. 登录 腾讯广告开发者平台，进入目标应用（应用类型为私有应用）详情页。

2. 复制并妥善保存 应用 ID、client_secret。

3. 在「权限情况」配置中，开通「人群管理（Audience Management）」权限。该权限用于管理第一方用户数据，包括标签、属性、人群数据的创建与维护。

4. 根据实际接入主体，在「 Token 获取」配置中选择账号。

5. 点击「获取或重置」，获取 Access Token 与 Refresh Token。

6. 后续需将应用 ID、client_secret、Access Token、Refresh Token 等信息填入神策后台对应广告平台的「添加/编辑连接」配置项中，完成授权。具体填写方式见第 2 步。

Step 2：在神策后台填写连接信息，完成授权

1. 在「数据管理 > 数据源管理」中点击「腾讯广告」，进入连接列表页。

2. 点击右上角「创建」，打开「添加连接」抽屉，填写以下参数（具体以产品界面为准）：

   1. 连接名称；

   2. 授权类型：自授权（腾讯私有应用选择此类型）；

   3. App ID：填写第 1 步复制的应用 ID；

   4. App Secret：填写第 1 步复制的 client_secret；

   5. Access Token：填写第 1 步获取的访问令牌；

   6. Refresh Token：填写第 1 步获取的刷新令牌；

   7. 广告账号：手动填写广告账号 ID。私有应用 Token 默认仅能管理注册 QQ 名下的账号，不可跨账号；如需管理同主体下其他 QQ 账号，请以腾讯侧实际授权范围为准，或改用方式二。广告账号 ID 可在投放后台或客户工作台中获取：

      1. 投放后台：使用开户 QQ 登录腾讯广告投放后台 → 在页面左上角或「账户管理」区域查看名下广告账号 ID。

      2. 客户工作台：登录「腾讯广告客户工作台」→ 在「组织概览」中查看并管理名下所有广告账户。

   8. 推送字段：用于配置分群用户标识与广告平台人群包字段的映射关系。

      1. 神策字段&广告平台字段：请确保左侧字段的实际加密方式与右侧广告平台字段要求的加密方式一致（如左侧为 MD5，右侧选择 MD5 类型字段）。若需将原值转为指定加密方式，请先创建虚拟属性，将原值加密为目标格式，再选择该虚拟属性进行推送。详见：章节六、创建虚拟属性（加密转换）

      2. 右侧支持的广告平台字段（15个），显示格式为「广告平台标识字段显示名（广告平台标识字段英文名_加密方式）」：IDFA（IDFA_HASH）、IMEI（IMEI_HASH）、手机号（Phone_HASH）、IDFA（IDFA）、IMEI（IMEI）、微信 OpenID（WX_OPENID）注：官方已升级为 WECHAT_OPENID，新配置建议直接用 WECHAT_OPENID、微信 UnionID（WX_UNIONID）、微信 OpenID（WECHAT_OPENID）、OAID（OAID）、OAID（OAID_HASH）、手机号（Phone_SHA256）、IMEI（IMEI_MD5_SHA256）、IDFA（IDFA_MD5_SHA256）、OAID（OAID_MD5_SHA256）、CAID（CAID）

3. 配置完成后，点击抽屉右上角「测试连接」。测试通过后，点击「提交」。

4. 提交成功后，即可将分群推送至腾讯广告指定广告账号。创建推送任务流程可参考「三、创建推送任务」。

注意：私有应用 Token 只能管理注册 QQ 名下的账号，这是腾讯侧硬约束。如需跨账号管理（如服务商管理多个客户账号），请改用方式二：三方应用 OAuth 授权。

 

2.2 三方应用OAuth授权流程（仅限有权限的客户）

适用场景与目的说明：

        当应用类型为三方应用，且当前账号已具备「创建三方应用」权限时，可通过三方应用 OAuth 授权，使神策获得访问腾讯广告指定广告账号人群管理接口的权限，并支持跨账号管理。

        该方式通常适用于技术服务商，或已向腾讯申请并通过审批、需跨账号管理多个广告账户的客户。若不具备「创建三方应用」权限，请使用方式一。

前置条件

1. 已是开发者，且在腾讯广告开发者平台创建 三方应用。

   1. 若尚未注册为开发者，请参考腾讯官方文档《如何注册成为开发者？》完成注册。

   2. 若尚未创建应用，请参考腾讯官方文档《如何创建应用并申请权限？》完成应用创建及权限申请。

2. 已确认需授权的广告账号范围。

3. 神策后台具备「数据管理 > 数据源管理」操作权限。

 

操作步骤

Step 1：在神策后台填写三方应用信息

1. 登录神策后台，进入「数据管理 > 数据源管理」。

2. 点击「腾讯广告」，进入连接列表页。

3. 点击右上角「创建」，打开「添加连接」抽屉。

4. 输入连接名称。

5. 填写 App ID、App Secret。该信息来源于腾讯广告开发者平台中已创建的三方应用，获取方式同方式一；App Secret 即方式一中的 client_secret。

6. 授权类型选择三方应用 OAuth 授权对应类型，具体以产品界面为准。

Step 2：将神策回调地址配置至三方应用（首次配置）

1. 在神策「添加连接」抽屉中，复制系统显示的「回调地址」。

2. 登录腾讯广告开发者平台，进入目标三方应用详情页。

3. 找到「授权回调地址」字段，粘贴神策提供的回调地址，并保存。该地址与神策抽屉中显示的「回调地址」为同一地址。

4. 该步骤仅在首次配置或回调地址发生变更时执行。

Step 3：在神策后台发起授权

1. 返回神策「添加连接」抽屉。

2. 点击「前往授权」按钮。

Step 4：完成腾讯广告 OAuth 授权

1. 系统将打开腾讯广告授权页。

2. 使用 QQ 登录。

3. 在授权页选择授权身份。

4. 点击「同意授权」。

Step 5：选择广告账号并提交连接

1. 授权完成后，返回神策「添加连接」抽屉页面。

2. 系统自动获取 Access Token、Refresh Token 等令牌信息。

3. 系统自动拉取该授权身份下的广告账号，勾选需要推送的广告账号。

4. 配置推送字段。用于配置分群用户标识与广告平台人群包字段的映射关系。请确保左侧字段的实际加密方式与右侧广告平台字段要求的加密方式一致（如左侧为 MD5，右侧选择 MD5 类型字段）。若需将原值转为指定加密方式，请先创建虚拟属性，将原值加密为目标格式，再选择该虚拟属性进行推送。详见：章节六、创建虚拟属性（加密转换）

5. 点击「测试连接」，测试通过后点击「提交」，完成连接配置。

6. 配置完成后，即可将分群推送至腾讯广告指定广告账号。创建推送任务流程可参考「三、创建推送任务」。

注意事项

• 三方应用 OAuth 授权支持跨账号管理，具体可管理的广告账号范围以腾讯侧授权结果为准。

• 授权成功后，Access Token、Refresh Token 由系统自动获取，无需手动填写。

• 回调地址需与腾讯广告开发者平台三方应用中配置的授权回调地址保持一致。

• 授权身份将决定可拉取和管理的广告账号范围，请根据实际业务选择。

• 推送字段直接影响腾讯侧匹配效果，建议优先选择高质量标识，如微信 OpenID、手机号，并确保字段格式符合腾讯要求。

• 测试连接通过后方可提交。提交成功后，即可将分群推送至腾讯广告指定广告账号。

 

三、创建推送任务

3.1 手动推送

功能说明：在分群历史详情中，可对某个已计算完成的分群版本发起手动推送。

操作路径：分群管理 → 目标分群详情 → 分群历史详情 → 目标分群版本 →「立即推送」→ 推送配置

推送配置项：

1. 推送规则：支持添加多条规则，每条规则独立选择一个推送通道，规则 Tab 支持「✕」删除、「+」新增；
2. 广告账号：广告账号即接收分群的投放账号，支持添加多个广告账号；
3.  推送字段：用于配置分群用户标识与广告平台人群包字段的映射关系。
   1. 神策字段&广告平台字段：请确保左侧字段的实际加密方式与右侧广告平台字段要求的加密方式一致（如左侧为 MD5，右侧选择 MD5 类型字段）。若需将原值转为指定加密方式，请先创建虚拟属性，将原值加密为目标格式，再选择该虚拟属性进行推送。详见：章节六、创建虚拟属性（加密转换）
   2. 支持两种推送字段配置方式
      1. 预设字段映射模板：创建连接时预制的推送字段模板，覆盖大多数标准场景，减少配置成本和配错风险。
      2. 自定义推送字段映射：模板不满足时（比如客户的设备 ID 存在自定义属性 $oaid_custom 里，或加密方式与模板不同），可条手动选择「源字段 → 目标字段_转换规则」。
4. 同步方式：
   1. 仅支持追加（APPEND）。
   2. 追加含义：每次推送执行时，只把本次分群计算出的用户添加进广告平台的目标人群包；之前已在包里的用户不动，即使某个用户这次不在分群里了，也不会被移出。
5. 可推送结果数预估：查看当前规则下的可推送结果数预估。

提交：配置完成后，点击「立即推送」，确认后提交推送任务。

 

3.2 自动推送 

功能说明：创建或编辑分群时开启推送，用于在分群计算完成后按已配置规则自动执行推送。

开启入口（具体入口以当前产品页面为准）：

1. 创建分群时：分群管理 → 创建分群 → 推送设置 → 开启推送
2. 已有分群时：分群管理 → 分群详情 → 推送设置 → 编辑

推送配置：点击「推送设置」中的「开启推送/编辑」后，进行「推送设置」 ，配置项同手动配置。

 

四、查看推送任务

4.1 在分群详情页查看

可在「分群管理 -> 分群详情 -> 推送记录」中，查看该分群对应的推送任务及执行结果。

适用场景：适用于查看单个分群的推送记录及执行结果。

 

4.2 在推送任务页查看

可在「数据管理 -> 通用数据集成 -> 推送任务」中，搜索、查看、管理推送任务

 

六、创建虚拟属性（加密转换）

在配置推送之前，若广告平台要求的数据格式与神策侧原始数据不一致（如平台要求 MD5，原始数据是明文），需先创建虚拟属性进行加密转换。

阅读提示：本章节仅指引“如何创建与绑定虚拟属性”。涉及各广告平台的具体字段枚举、SQL 公式模板及加密规范，请查阅独立参考文档《人群包推送加密配置参考》

6.1 操作步骤

操作路径：【元数据管理】 -> 【用户表】 -> 【虚拟属性】Tab -> 【创建虚拟属性】

操作步骤：

Step 1：确认加密需求与数据现状（关键前置）

在创建虚拟属性前，请务必先完成以下两项核对，避免建错属性导致推送匹配失败：

1. 明确目标平台的字段要求：查阅目标平台（如腾讯广告、百度营销）官方文档，确认对应标识字段（如手机号、IMEI、IDFA）要求的加密方式及终态格式（位数、大小写）。

   • 神策支持的广告平台字段（15个）：IDFA（IDFA_HASH）、IMEI（IMEI_HASH）、手机号（Phone_HASH）、IDFA（IDFA）、IMEI（IMEI）、微信 OpenID（WX_OPENID）注：官方已升级为 WECHAT_OPENID，新配置建议直接用 WECHAT_OPENID、微信 UnionID（WX_UNIONID）、微信 OpenID（WECHAT_OPENID）、OAID（OAID）、OAID（OAID_HASH）、手机号（Phone_SHA256）、IMEI（IMEI_MD5_SHA256）、IDFA（IDFA_MD5_SHA256）、OAID（OAID_MD5_SHA256）、CAID（CAID）
   • （各平台对字段的具体要求可参考 6.2.2 注意事项中的官方文档链接）

    

2. 核对神策侧原始数据格式：确认您打算使用的神策原值字段（如 users.phone）当前的实际存储格式（是明文、MD5、AES 密文，还是其他格式）。

3. 判断是否需要转换：

   • 格式一致：如左侧明文 IDFA -> 右侧要求明文 IDFA，则无需创建虚拟属性，直接映射原值即可。

   • 格式不一致：如左侧明文手机号 -> 右侧要求 MD5 手机号，则需要创建虚拟属性，并在 6.2 通用速查表中匹配对应的 SQL 模板。

Step 2：填写基础信息

• 属性名：建议规范化命名，如 phone_sha256、idfa_md5（以英文开头，仅支持大小写字母、数字、下划线）。

• 属性显示名：便于业务识别的名称，如 SHA256加密手机号。

• 数据类型：选择【字符串 String】（加密后的哈希值为字符类型）。

Step 3：配置计算逻辑

• 在【虚拟属性计算逻辑】栏点击【添加】按钮。

• 创建方式选择【使用 SQL 确定虚拟属性的值】。

• 在 SQL 输入框中输入加密转换逻辑（从 6.2 复制对应公式，替换字段名）。

• 点击【保存】。

Step 4：提交生效

• 返回虚拟属性列表，点击右上角【提交】。

• 等待底层数据重跑完成，虚拟属性即可生效。

 

6.2 通用加密 SQL 场景速查表及注意事项

6.2.1 通用加密 SQL 场景速查表

以下为各平台最常见的加密场景及 SQL 模板，适用于腾讯广告、百度营销等平台。使用时请将示例中的 users.phone 替换为实际字段名（如 users.imei、users.idfa、users.oaid 等）。

加密方式	需虚拟属性	虚拟属性表达式示例（以手机号为例）
原值（明文）	否	直接映射原值列
MD5	是	md5(users.phone)
SHA256	是	sha2(users.phone, 256)
先 MD5 再 SHA256	是	sha2(md5(users.phone), 256)
MD5（含格式清洗）	是	md5(regexp_replace(regexp_replace(users.phone,'[^0-9]',''),'^0+',''))
MD5（含大小写转换）	是	md5(lower(users.imei)) 或 md5(upper(users.idfa))

⚠️ 注意：以上为基础模板。各广告平台对具体字段枚举（如腾讯的 HASH_MOBILE_PHONE）、终态格式（如具体的位数、大小写规则）要求不同，请务必查阅独立参考文档或各平台官方文档。

6.2.2 注意事项

1. 引用规范：SQL 中必须严格写成 表名.字段名，如 users.phone，否则系统会校验失败。

2. 数据规范化与哈希大小写：生成哈希前，手机号、邮箱等原始数据需按平台要求进行规范化处理（如去空格、统一国家码、转小写等）；生成哈希后，各平台对 MD5 / SHA256 的大小写要求也不同。具体均以媒体侧披露的帮助手册为准。

3. 以官方为准：各平台对字段枚举、加密方式及格式的要求会不定期更新。最终要求请务必严格以广告平台官方披露的最新文档为准：

   • 平台	官方文档说明	链接
     腾讯广告	号码包类型（user_id_type 枚举）	https://developers.e.qq.com/v3.0/docs/enums
     百度营销	输入信息 - idType	https://dev2.baidu.com/content?sceneType=0&pageId=100543&nodeId=499&subhead=

4. 数据刷新延迟：提交虚拟属性后，需等待底层数据重跑完成，才能用于人群包推送测试。建议先用少量测试人群验证广告平台匹配率（匹配率影响因素的详细排查，请参考第七章 FAQ Q5）。 

6.3 推送字段映射与绑定

虚拟属性创建并生效后，在配置【推送字段】时进行绑定：

• 左侧神策字段：选择刚才创建的虚拟属性（如 phone_sha256）。

• 右侧广告平台字段：选择对应的加密字段（如 手机号（Phone_SHA256））。

• 核心原则：确保左侧字段的实际加密方式与右侧平台要求的加密方式完全一致。

 

七、FAQ

Q1：业务场景及使用应用类型示例

以下用QQ举例说明，实际场景已腾讯官方为准：

场景	开发者账号（QQ）	投放广告 （QQ/微信）	关系	能用私有应用吗
自己开发自己用	QQ-A（自己的广告账户开户 QQ）	QQ-A 自己名下的广告账户	同 QQ	✅
品牌主公司 IT 给业务部门开发工具	QQ-A（公司广告账户开户 QQ）	QQ-B（业务部门员工 QQ）	不同 QQ，同主体	✅
集团下独立子公司，各自有广告账户	QQ-A（集团开户 QQ，主体是集团）	QQ-B（子公司开户 QQ，主体是子公司）	不同 QQ，不同主体	❌（要走三方应用）
SaaS 厂商给客户代管	QQ-A（SaaS 公司公共 QQ）	QQ-B（客户自己的广告账户 QQ）	完全无关	❌（要走三方应用）

 

Q2：需要我自己填写广告账号 ID 吗？

看您用的是哪种对接方式：

• 私有应用自授权（方式一）：需要。 私有应用 token 不能调列账号接口，必须手动把广告账号 ID 填进神策后台（查 ID 方式见「第三节第 3 步」）。

• 三方应用 OAuth 授权（方式二）：不需要。 授权成功后系统会自动拉取该身份下的账号列表，勾选即可。

 

Q3：普通客户（广告主/代理商）可以用三方应用吗？

详见腾讯官方文档《开发者应用的分类及作用》：https://developers.e.qq.com/docs/start

 

Q4：创建推送时配置中「同步方式：追加（APPEND）」是什么意思？同一个人群包重复推送到腾讯广告后，数据是怎么更新的？

1、在神策创建腾讯广告人群推送任务时，同步模式选择“追加（APPEND）”，表示：

• 本次任务仅将当前分群中匹配成功的用户标识新增至目标腾讯侧人群包；

• 不删除目标人群包中已有用户；

• 不以本次推送结果整体覆盖历史数据；

• 若目标人群包不存在，则创建；若已存在，则在其基础上追加。

因此，追加模式下的数据更新结果为历次推送中匹配成功用户的并集，而非最新一次推送结果的替换。

2、同一个人群包重复推送后的数据更新规则

每次推送，神策将用户标识提交至腾讯，腾讯基于自身用户库匹配，仅匹配成功的用户进入人群包；腾讯侧对目标人群包执行追加操作，历史已匹配用户继续保留。

• 若本次分群人数减少，或部分用户已从分群中移出，这些用户不会自动从腾讯侧人群包中删除。

• 最终人群包用户 = 历次推送中匹配成功用户的并集（同一用户是否去重以腾讯侧为准）。

• 腾讯接口不支持“用最新一批用户整体替换旧数据”，神策亦不提供自动清空能力。

3、示例说明

分群 A 首次推送 1000 人，腾讯侧匹配成功 600 人；分群重新计算后变为 1200 人，腾讯侧匹配成功 700 人。

4、如需清空后重新推送

神策不提供自动清空能力，可任选以下方式：

• 登录腾讯广告如翼后台（ruyi.qq.com/audience），手动删除该人群包后重新推送；

• 在神策新建一个分群，并推送为全新人群包。

5、建议

若业务要求腾讯侧人群包与神策最新分群保持一致，应避免反复向同一人群包追加。建议每次新建人群包，或先删除旧人群包后再推送，以确保人群包内容符合最新分群结果。

 

Q5 ：为什么神策推送列表显示“推送成功”，但详情抽屉和广告后台均显示“处理中/计算中”？

此现象属于正常的异步状态同步延迟，原因如下：

1. 状态含义不同：

   • 推送列表的“成功”：指神策系统已成功发起推送请求（数据已发送至广告平台）。

   • 详情抽屉/广告后台的“处理中”：指广告平台正在后台处理数据，尚未生成最终的人群包。神策侧需要等广告平台处理完成后，才能拉取到最终结果。

2. 异步轮询机制：由于人群包处理需要时间，神策采用异步轮询方式获取广告平台的真实状态。轮询时间间隔采用阶梯递增（退避）策略：

   • 初始阶段：1 分钟、2 分钟、4 分钟、8 分钟、16 分钟、32 分钟。

   • 后续阶段：达到 60 分钟后，改为每 1 小时查询一次。

   • 超时兜底机制（重要）：为避免任务状态长期悬而未决，系统设有超时自动失败机制。若自推送发起后，超过 48 小时仍未查询到广告平台的成功处理结果，系统将自动将该任务状态标记为“失败”。

Q6：为什么神策推送结果数与腾讯广告匹配人数不一致？（数据同步与时效说明）

⚠️ 核心结论：短期不一致属预期行为，排查与验收以生效后的列表人数为准。

该现象由数据同步与生效的时间差导致：

1. 接口返回的匹配数（文件级解析结果）：神策调用广告平台接口推送文件后，接口返回的匹配数仅为文件级解析结果，代表数据文件已被成功接收和初步解析。

2. DMP 列表人数（异步生效后的快照）：广告平台 DMP 后台的「人群列表人数」是异步生效后的快照，通常会在 24 小时内完成更新。在此期间，DMP 后台可能显示旧数据或暂不更新。

3. 预期行为：两端数据在短期内（通常为推送后的 24 小时内）不一致，属于正常现象，并非系统 Bug。请客户侧和测试同学知悉。

📌 排查与验收建议：

• 请勿以接口返回的匹配数作为最终验收标准。

• 请等待 24 小时（或广告后台异步生效完成）后，以 DMP 列表实际生效的人数作为最终排查与验收标准。

常见匹配率影响因素参考：

匹配过程由腾讯侧完成，神策无法干预匹配率。

如需提升匹配效果，建议优先推送高质量标识（如微信 OpenID、手机号），并确保字段值符合格式要求。