ClawHub

明日Dmp人群圈选

API key required
Data & APIs

基于明日DMP API，支持6种人群圈选方式（组合人群、广告行为规则人群、APP规则人群、LBS规则人群、拓展人群、打通人群），实现精准营销、用户画像、竞品分析和区域推广的人群筛选。

Install

openclaw skills install dmp-segment

💬 您的反馈对我们很重要

感谢您使用明日DMP人群圈选技能！为了持续优化产品体验，诚邀您填写使用评价：

🔗 评价表单：https://doc.weixin.qq.com/forms/ANEAJwfLAAoAakARgYnAKICNgMOj015Of?page=1

您的宝贵意见将帮助我们：

  • 改进技能功能和易用性
  • 优化操作流程和文档说明
  • 提供更贴合实际需求的功能

⏱️ 仅需1-2分钟，感谢您的支持！

失败时：

展示错误详情、可能原因、解决方案

技能依赖说明

本技能需要配合两个辅助技能使用，以确保功能完整性和操作可追溯性：

1. 鉴权技能（mingdata-dmp-auth）

作用： 管理明日DMP API的访问凭证（Access Key和Secret Key）

调用时机：

  • 首次使用本技能时
  • 凭证过期或失效时
  • 任何需要调用明日DMP API的操作前

下载引导流程：

当系统检测到您尚未安装鉴权技能时，会提示：

⚠️ 检测到您尚未安装【明日DMP鉴权技能】

该技能用于管理明日DMP API凭证，是使用人群圈选功能的必要前提。

是否需要自动下载并安装鉴权技能？
1. 是 - 自动下载并引导配置凭证
2. 否 - 稍后手动安装（本次操作将无法继续）

请回复：是/否

用户确认后：

  • 选择"是" → 自动下载鉴权技能 → 引导用户配置AK/SK凭证 → 继续执行人群圈选操作
  • 选择"否" → 提示"无法继续操作，请先安装鉴权技能" → 结束本次操作

2. 任务记录技能（skill-logger）

作用： 自动记录所有人群圈选任务的创建记录、参数配置和执行结果

调用时机：

  • 每次成功创建人群任务后
  • 用于后续查询历史任务、追溯操作记录

下载引导流程：

当系统检测到您尚未安装任务记录技能时，会提示：

💡 检测到您尚未安装【任务记录技能】

该技能可以自动记录您的所有人群圈选任务，方便后续查询和管理。

功能包括：
- 自动记录任务ID、人群名称、创建时间
- 保存完整的参数配置
- 追溯历史操作记录

是否需要自动下载并安装任务记录技能？
1. 是 - 自动下载并启用任务记录功能
2. 否 - 本次不安装（不影响人群圈选功能，但无法记录任务历史）

请回复：是/否

用户确认后：

  • 选择"是" → 自动下载任务记录技能 → 启用自动记录功能 → 继续执行
  • 选择"否" → 提示"已跳过任务记录功能，您仍可正常使用人群圈选" → 继续执行（不记录任务）

技能依赖关系总结

技能名称是否必需调用时机不安装的影响
mingdata-dmp-auth✅ 必需首次使用或凭证失效时无法调用API，无法使用人群圈选功能
skill-logger⭕ 可选每次成功创建任务后无法记录任务历史，但不影响人群圈选功能

API凭证说明

本技能的API凭证由独立的鉴权技能（mingdata-dmp-auth）管理。首次使用时，系统会自动引导您下载鉴权技能并配置凭证。

凭证申请方式（二选一）：

方式一：邮件申请

  • 发送开通申请至：product@mingdata.com
  • 邮件主题：【明日DMP API开通申请】
  • 邮件内容：请注明公司名称、联系人、联系方式及使用场景

方式二：在线表单申请

凭证格式：

  • Access Key：AK-xxxxxxxxxxxxxxxx
  • Secret Key：SK-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ 使用前必读

本技能需要明日DMP API凭证才能使用。

如您尚未申请凭证，请通过以下方式获取：

📧 快速申请通道：

审核时间：通常1-3个工作日

💡 温馨提示：首次使用时我会引导您完成配置，无需担心！

📝 使用评价：使用后欢迎填写评价表单，帮助我们持续改进！

支持的人群圈选类型

1. 组合人群

功能说明： 基于DMP标签体系，通过且（AND）和非（NOT）逻辑组合多个标签条件圈选人群

适用场景： 精准营销、用户画像圈选、多维度条件筛选

必填参数： 人群名称、平台类型、ID类型、标签组合规则（支持且/非逻辑）

示例： "圈选25-35岁女性 AND 美妆兴趣 NOT 已购买用户"

注意： 不支持单独的并集（OR）逻辑，并集只能在同一组rule内实现

2. 广告行为规则人群

功能说明： 基于广告监测数据，圈选在特定时间段内有曝光/点击行为的用户

适用场景： 广告效果分析、再营销人群、竞品分析

必填参数： 人群名称、平台类型、时间周期、行为维度(行业/品牌/广告位/地域)、事件类型(曝光/点击)、频次范围

示例： "圈选最近30天在美妆行业有曝光行为的用户，频次3次以上"

注意： 地域维度必须使用regionId（明日DMP体系），不是行政区划代码

3. APP规则人群

功能说明： 基于APP安装/活跃数据，圈选使用特定应用的用户

适用场景： 竞品用户分析、APP推广、行业用户圈选

必填参数： 人群名称、平台类型、ID类型、分析类型(安装/活跃)、APP列表(至少4个)、dimension字段（必须为"APP"）

示例： "圈选安装了淘宝、京东、拼多多、唯品会的用户"

注意： data参数必须包含dimension="APP"字段

4. LBS规则人群

功能说明： 基于地理位置数据，圈选到访过特定区域的用户

适用场景： 线下门店营销、区域推广、商圈分析

必填参数： 人群名称、平台类型、ID类型、圈选方式(批量画圈/手动多边形)、坐标/POI、辐射范围、人群类型(经过/常驻/工作/居住)、时间范围

示例： "圈选最近7天到访过北京三里屯商圈的用户，辐射范围500米"

5. 拓展人群

功能说明： 基于种子人群，通过相似算法拓展更多相似用户(Lookalike)

适用场景： 扩大营销覆盖、相似人群挖掘、冷启动用户获取

必填参数： 人群名称、ID类型、种子人群ID、拓展方式(按量级/按置信度)、目标量级或置信度

示例： "基于种子人群100001创建拓展人群，按量级拓展到500万"

6. 打通人群

功能说明： 将一个平台的人群ID打通到另一个平台(跨屏ID打通)

适用场景： 跨屏营销、多端触达、全域用户管理

必填参数： 人群名称、打通类型、输入平台类型、输入ID类型、输入人群ID、输出平台类型、输出ID类型

示例： "将Mobile人群100002打通转换为OTT人群"

参数格式要求

通用参数格式

参数类型格式要求正确示例错误示例
时间格式YYYY-MM-DD2024-05-192024/05/19
平台类型MOBILE/PC/OTT（大写）MOBILEmobile
人群名称≤50字符目标用户超过50字符的名称
频次范围1-99930或1000

各圈选类型特殊要求

组合人群：

  • 标签ID：只能使用isDirectory=1的标签
  • data参数格式：[{"rule": {"tag": [标签ID1, 标签ID2, ...]}}]
  • tag字段必须是整数数组，不能是对象数组
  • 同一组rule内的多个标签是"或"关系

广告行为规则人群：

  • 时间周期：endDate ≤ 当前日期-2天，跨度 ≤ 62天
  • 事件类型：imp（曝光）、clk（点击）
  • 频次范围：frequency_min（1-999）和frequency_max（1-999）都是可选参数，可单独使用或组合使用
  • 地域维度：使用regionId（明日DMP体系），不是行政区划代码
  • data结构：支持多个rule，op数组长度=rule数组长度-1

APP规则人群：

  • APP列表：至少4个不重复的包名
  • 分析类型：0=活跃、1=安装
  • data.dimension：必须设置为"APP"

LBS规则人群：

  • 坐标系统：百度坐标系（BD09）
  • 辐射范围：150-6000米整数
  • 圈选方式：batch（圆形）、manual（多边形）
  • 时间格式：YYYY-MM-DD HH（选择recentArrive时必填）

拓展人群：

  • 拓展方式：0=按量级（50-30000万）、1=按置信度（0.1-0.9）
  • 种子人群：状态需为成功且非拓展人群

打通人群：

  • 打通类型：1=TV-Mobile跨屏打通
  • 平台限制：输入MOBILE时输出必须OTT，反之亦然

查询任务状态

创建人群任务后，您可以查询任务状态：

用法： "查询人群任务 123456 的状态"

返回信息：

  • 任务ID、人群名称、人群类型
  • 当前状态（计算中/成功/失败）
  • 人群规模（成功时）

任务成功时的后续操作建议：

人群圈选任务执行成功后，您可以进行以下操作：

  1. 下载人群洞察技能 - 根据画像特征进一步分析人群

    • 功能：对圈选出的人群进行多维度画像分析
    • 适用场景：了解人群的人口属性、兴趣偏好、媒体偏好等特征
    • 操作方式：告诉我"下载人群洞察技能"或"分析人群画像"

  2. 下载人群投放技能 - 创建人群投放任务

    • 功能：将圈选的人群包投放到广告平台
    • 适用场景：圈选的人群符合目标人群预期，需要进行广告投放
    • 操作方式：告诉我"下载人群投放技能"或"创建投放任务"

常见问题

Q: 凭证过期了怎么办？

A: 系统会自动调用鉴权技能引导您重新配置凭证。

Q: 创建任务后多久能完成？

A: 人群圈选任务通常需要5-30分钟完成计算，您可以通过查询任务状态功能查看进度。

Q: 如何知道人群圈选是否成功？

A: 任务创建成功后会返回任务ID，您可以使用查询任务状态功能查看计算结果。成功后会显示人群规模和后续操作建议。

Q: 参数填错了怎么办？

A: 在参数确认表格展示后，您可以回复"取消"来取消本次操作，然后重新提出需求。

Q: 系统如何识别我的需求类型？

A: 系统会自动分析您的请求内容：

  • 包含"有哪些功能"、"能做什么" → 技能咨询
  • 包含"查询任务" + 任务ID → 查询任务状态
  • 包含标签、条件、行为等 → 创建人群

Q: 为什么要先确认圈选方式？

A: 为了避免误判您的意图。例如，您提到"25-35岁女性"，可能是想创建人群，也可能只是想了解这类人群的特征。确认后再继续可以提升准确性。

Q: 地域维度为什么不能用行政区划代码？

A: 明日DMP使用自己的regionId体系（如北京=12），而非标准行政区划代码（如110000）。请使用维度表文件或调用地域维度查询API获取正确的regionId。

Q: frequency_min和frequency_max如何使用？

A: 两个参数都是可选的。可以只设置frequency_min（表示≥N次），也可以同时设置frequency_min和frequency_max（表示N-M次之间）。注意frequency_max必须大于frequency_min。

Q: APP规则人群为什么创建失败？

A: 请检查data参数是否包含dimension="APP"字段，这是APP规则人群的必填字段。

通用服务接口

除了人群圈选功能外，本技能还提供以下通用查询接口，帮助您获取必要的参数信息：

1. 人群列表查询

功能： 查询已创建的人群列表，支持按类型、状态、ID等条件筛选

使用场景：

  • 查看所有已创建的人群
  • 筛选特定类型或状态的人群
  • 查询特定人群ID的详细信息

查询条件：

  • 人群类型：1=上传、2=组合、3=规则、4=拓展、5=打通
  • 人群状态：0=失败、1=成功、2=等待中、3=计算中
  • 人群ID列表：可指定一个或多个人群ID
  • 分页参数：页码、每页条数

示例：

  • "查询所有组合人群"
  • "查询状态为成功的人群"
  • "查询人群ID 100001 和 100002 的信息"

2. 标签列表查询

功能： 查询DMP标签列表，用于组合人群圈选时选择标签

使用场景：

  • 创建组合人群前，查看可用的标签
  • 了解标签的层级结构（目录/标签）
  • 筛选明略标签或合作伙伴标签

查询条件：

  • 标签类型：1=明略标签、3=合作伙伴标签（可选）

返回信息：

  • 标签ID、标签名称、父级ID
  • 标签类型、是否为目录（0=目录、1=标签）
  • 注意： 组合人群只能使用 isDirectory=1 的标签

示例：

  • "查询所有可用标签"
  • "查询明略标签列表"

3. APP列表查询

功能： 查询APP列表，用于APP规则人群圈选时选择应用

使用场景：

  • 创建APP规则人群前，查看可用的APP
  • 按安装量级筛选APP
  • 获取APP的包名、分类等信息

查询条件：

  • 安装量级：安装量级100万以下、100万-1000万、1000万-5000万、5000万-1亿、1亿以上（可选）

返回信息：

  • APP名称、包名（packageName）
  • APP分类、类型、安装量级

示例：

  • "查询所有APP列表"
  • "查询安装量级在1000万-5000万的APP"

4. 地域维度查询

功能： 查询地域维度树状结构，用于广告行为规则人群的地域筛选

使用场景：

  • 创建广告行为规则人群时，选择地域维度
  • 了解地域的层级结构（省份-城市）
  • 获取正确的regionId（明日DMP体系）

查询条件：

  • 平台类型：MOBILE/OTT/PC（必填）

返回信息：

  • 地域ID（regionId）、地域名称、父级ID
  • 子级地域列表（树状结构）

示例：

  • "查询MOBILE平台的地域维度"
  • "查询PC平台的地域列表"

⚠️ 重要： 返回的地域ID是明日DMP的regionId，不是行政区划代码

5. 广告行为维度查询

功能： 查询广告行为维度字典，用于广告行为规则人群的维度筛选

使用场景：

  • 创建广告行为规则人群时，选择行业、媒体或活动维度
  • 了解各维度的层级结构（大类-中类-小类）

查询条件：

  • 平台类型：MOBILE/OTT/PC（必填）
  • 维度类型：活动维度、行业维度、媒体维度（必填）

返回信息：

  • 维度ID、维度名称
  • 维度类型、子类型、父级ID

示例：

  • "查询MOBILE平台的行业维度"
  • "查询MOBILE平台的媒体维度"

技术说明

本技能通过Python脚本调用明日DMP开放平台API，所有脚本位于 scripts/ 目录：

凭证管理：

  • scripts/setup_credentials.py - 凭证配置
  • scripts/dmp_api_client.py - API通用调用模块

人群圈选：

  • scripts/create_combined_crowd.py - 组合人群创建
  • scripts/create_ad_behavior_crowd.py - 广告行为规则人群创建
  • scripts/create_app_crowd.py - APP规则人群创建
  • scripts/create_lbs_crowd.py - LBS规则人群创建
  • scripts/create_lookalike_crowd.py - 拓展人群创建
  • scripts/create_crossscreen_crowd.py - 打通人群创建

通用查询：

  • scripts/query_crowd_task.py - 查询任务状态
  • scripts/query_audience_list.py - 人群列表查询
  • scripts/query_tag_list.py - 标签列表查询
  • scripts/query_app_list.py - APP列表查询
  • scripts/query_region_dimension.py - 地域维度查询
  • scripts/query_ad_dimension.py - 广告行为维度查询

流程执行规则（AI助手必读）

强制性说明

本技能的工作流程包含8个步骤，每个步骤都有明确的执行要求：

[必须执行] - 该步骤在任何情况下都必须执行，不可跳过 [必须检查] - 该步骤必须执行检查逻辑，即使用户不需要该功能 [可选] - 该步骤可根据用户需求选择是否执行

执行检查清单

在执行人群圈选任务时，AI助手必须按照以下清单逐步检查：

  • 第一步：请求类型识别 [必须执行]

    • 检查点：是否正确识别了请求类型（咨询/查询/创建）？
    • 失败处理：如无法识别，询问用户明确意图

  • 第二步：凭证检查 [必须执行]

    • 检查点：是否检查了凭证文件是否存在？
    • 检查点：凭证不存在时，是否调用了鉴权技能引导配置？
    • 失败处理：凭证配置失败时，终止流程并提示用户

  • 第三步：圈选方式确认 [必须执行]

    • 检查点：是否向用户展示了识别的圈选方式？
    • 检查点：是否等待用户确认后才继续？
    • 失败处理：用户拒绝时，重新识别或询问正确的圈选方式

  • 第四步：参数补充 [必须执行]

    • 检查点：是否收集了所有必填参数？
    • 检查点：是否进行了参数格式校验？
    • 失败处理：参数不完整或格式错误时，重新询问用户

  • 第五步：参数确认 [必须执行]

    • ⚠️ 关键：这是强制性步骤，任何圈选类型都必须先展示参数表等待用户确认
    • 检查点：是否以表格形式展示了所有参数（包括所属品牌、ID类型、圈选条件）？
    • 检查点：是否等待用户明确回复"确认"、"是"、"可以"等确认词？
    • 检查点：是否在用户确认前禁止调用API？
    • 失败处理：用户要求修改时，返回第四步重新收集参数；用户取消时，终止流程

  • 第六步：执行创建 [必须执行]

    • 检查点：是否调用了正确的创建脚本？
    • 检查点：是否处理了API返回的错误？
    • 失败处理：API调用失败时，展示错误信息并终止流程

  • 第七步：任务记录 [必须检查]

    • ⚠️ 关键：即使用户不需要记录，也必须执行以下检查
    • 检查点：是否检查了skill-logger技能是否安装？
    • 检查点：未安装时，是否询问用户是否需要下载？
    • 检查点：是否记录了用户的选择（安装/跳过）？
    • 失败处理：用户选择跳过时，记录选择并继续第八步

  • 第八步：结果展示 [必须执行]

    • 检查点：是否展示了任务ID和预计完成时间？
    • 检查点：是否提供了后续操作建议（人群洞察/人群投放）？
    • 失败处理：无

AI助手执行指引

执行原则：

  1. 严格按照步骤顺序执行，不可跳过任何[必须执行]或[必须检查]的步骤
  2. 每个步骤完成后，在内部记录执行状态（已完成/已跳过/失败）
  3. 遇到[必须检查]步骤时，即使预判用户不需要，也必须执行检查逻辑
  4. 第七步是最容易被跳过的步骤，必须特别注意

第五步执行示例（参数确认）：

# 正确执行方式
1. 收集完所有必填参数后，立即生成参数确认表格
2. 以表格形式展示所有参数（人群名称、平台类型、ID类型、圈选条件等）
3. 向用户展示确认提示：
   "请确认以上参数是否正确？
   - 回复'确认'或'是'：开始创建人群任务
   - 回复'修改'：重新设置参数
   - 回复'取消'：取消本次操作"
4. 等待用户明确回复
5. 用户确认后才进入第六步（执行创建）

# 错误执行方式（禁止）
1. 收集完参数后直接调用API，不展示确认表格
2. 展示表格后不等待用户确认就执行
3. 假设用户已经确认，直接创建任务
4. 只在某些圈选类型展示确认表格，其他类型跳过

第七步执行示例（任务记录）：

# 正确执行方式
1. 检查skill-logger是否安装
2. 如未安装，向用户展示：
   "检测到您未安装任务记录技能（skill-logger），该技能可以帮助您记录和查询历史任务。
   是否需要下载安装？（回复'是'安装，'否'跳过）"
3. 等待用户回复
4. 记录用户选择
5. 继续第八步

# 错误执行方式（禁止）
1. 直接跳过第七步
2. 不询问用户直接进入第八步
3. 假设用户不需要记录功能

流程完整性验证：

在展示最终结果前，AI助手应在内部验证：

  • 是否所有[必须执行]步骤都已完成？
  • 是否所有[必须检查]步骤都已执行检查逻辑？
  • 是否记录了用户在可选步骤的选择？
  • ⚠️ 特别检查：第五步参数确认是否已展示表格并等待用户明确确认？
  • ⚠️ 特别检查：是否在用户确认前就调用了API（严重错误）？

如发现遗漏，应立即补充执行遗漏的步骤。

调试建议：

如用户反馈某个步骤被跳过，AI助手应：

  1. 回顾执行日志，确认该步骤是否真的被执行
  2. 检查该步骤的检查点是否都已满足
  3. 向用户说明该步骤的执行情况和结果
  4. 如确实遗漏，立即补充执行并道歉

📝 用户反馈与支持

感谢您使用明日DMP人群圈选技能！

💬 分享您的使用体验

您的反馈对我们非常重要，无论是功能建议、使用问题还是体验评价，都欢迎通过以下表单告诉我们：

👉 填写使用评价表单

🛠️ 技术支持

如遇到技术问题或需要帮助，请在表单中详细描述问题场景，我们会尽快为您解决。

📊 我们关注的问题

  • 技能是否满足您的业务需求？
  • 使用过程中是否遇到困难？
  • 文档说明是否清晰易懂？
  • 您希望增加哪些新功能？

再次感谢您的使用和支持！🙏

More in Data & APIs