营销归因漏斗图生成

任务目标

深度解析营销归因分析报告，自动提取或推断多触点归因结构化数据
生成带中文标注、专业商务级的多触点归因漏斗图，支持自定义画面比例
触发场景：全渠道营销效果分析、预算精细化再分配、触点转化效率评估、营销报告可视化汇报

能力组成

能力流程描述

该技能由 5 个能力节点按序串联，构成「报告理解 → 归因数据抽取/推断 → 生图提示词渲染 → 图像生成 → 轮询取图」的完整链路：

深度解析漏斗图生成意图与专业标准（intent_analyzer）：解析用户需求，理解漏斗图生成意图，形成结构化意图（deep_intent）与成功标准（success_criteria），作为后续各环节的质量基准；
从营销报告中抽取/推断结构化归因数据（attribution_analyzer）：接收用户输入的营销报告全文（report_text），结合上一步的成功标准，按「数据逻辑一致性优先、推断数据需标注」的融合策略，抽取各触点层级、预算权重、转化率、流失率等归因数据；若报告中缺少显式归因分析，则基于原始报告内容智能推断生成，推断字段自动标注（is_inferred=true）；
将结构化归因数据渲染为精准漏斗图生图提示词（funnel_visual_prompt_render）：将结构化归因数据按「数据逻辑一致性优先、中文标注优先、权重宽度视觉映射」原则渲染为专业生图提示词（optimized_prompt），并融合用户指定的画面比例；
生成漏斗图图像（图像生成模型）：按优化后的提示词与画面比例生成多触点归因漏斗图；
轮询漏斗图生成状态（polling）：以 5 秒间隔轮询图像生成任务状态（最长 600 秒），直至 task_status === 'SUCCEEDED'，返回漏斗图访问地址。

数据流转方式：用户输入 report_text（必填）与 aspect_ratio（选填，默认 16:9）→ 意图分析产出成功标准 → 归因数据抽取/推断产出 structured_funnel_data → 渲染产出 optimized_prompt → 图像生成 → 轮询成功后输出 structured_funnel_data、funnel_image_url、optimized_prompt 三类交付物。整个流程由系统自动串联执行，用户仅需提供报告文本与画面比例。

技能能力组成流程图

flowchart TD
    A["用户输入<br/>report_text 营销报告文本（必填）<br/>aspect_ratio 画面比例（选填，默认16:9）"] --> B["Step1 深度解析漏斗图生成意图与专业标准<br/>（intent_analyzer）"]
    B --> C["Step2 从营销报告中抽取/推断结构化归因数据<br/>（attribution_analyzer，推断数据自动标注）"]
    C --> D["Step3 渲染为精准漏斗图生图提示词<br/>（funnel_visual_prompt_render）"]
    D --> E["Step4 生成漏斗图图像<br/>（图像生成模型）"]
    E --> F["Step5 轮询漏斗图生成状态<br/>（间隔5秒，最长600秒）"]
    F -->|"task_status === SUCCEEDED"| G["输出<br/>structured_funnel_data 结构化归因数据<br/>funnel_image_url 漏斗图URL<br/>optimized_prompt 生图提示词"]
    F -->|"生成中"| F

前置准备

凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey（对应环境变量 SHOWAPI_APP_KEY）
鉴权配置：本 Skill 调用需要 AppKey 鉴权。所有 API 请求的 URL 查询参数中需携带 appKey={你的AppKey}。

如何获取 AppKey

如果你还没有 AppKey，请按以下步骤通过手机验证获取：
1. 请用户提供手机号（中国大陆手机号）
2. 调用发送验证码接口：
```
POST https://www.showapi.com/auth/agent_sendCode
Content-Type: application/x-www-form-urlencoded

phone={手机号}
```
  成功响应：{"flag":true,"remark":"发送成功"}
3. 请用户查看手机收到的6位验证码并告诉你
4. 调用验证接口获取 AppKey：
```
POST https://www.showapi.com/auth/agent_verify
Content-Type: application/x-www-form-urlencoded

phone={手机号}&code={验证码}
```
  成功响应：{"flag":true,"app_key":"你的AppKey"}
5. 将获取到的 app_key 保存，后续所有 API 调用 URL 中携带 appKey={app_key} 参数
注意事项
- 验证码5分钟有效，每分钟只能发送1次
- 如果手机号已注册过易源数据平台账户，会直接返回该账户的 AppKey，不会重复注册
- AppKey 获取后请妥善保存，避免重复验证
模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
依赖：仅使用 Python 标准库，无需安装第三方包

操作步骤

模拟体验流程（无 appKey）

自动触发模拟调用 系统检测到未配置 appKey 时，自动向 https://www.showapi.com/_nuxt3/api/2405-105 发送 POST 请求（body: {"flow_id":"6a3b8e6c3c51f2c209002e8f"}），直接获取完整模拟生成结果。此过程为一次性返回，不执行 execute_task.py 和 query_task.py。
可视化预览 将返回的 JSON 结果以 HTML 形式可视化展示，重点呈现漏斗图图片内容。
引导真实调用 提示用户当前为无 appKey 的模拟运行结果。如需真实调用，请通过手机验证获取 AppKey（步骤见「前置准备-鉴权配置」），并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。

标准流程（有 appKey，强制异步执行）

收集用户需求 收集用户的营销归因分析报告全文或核心段落文本（report_text，必填），确认生成图的画面比例（aspect_ratio，选填，可选值：1:1、3:4、4:3、16:9、9:16，默认 16:9）。

异步提交生成任务 调用脚本异步执行漏斗图生成任务，仅返回唯一 task_id，不阻塞等待。调用示例：

python scripts/execute_task.py --report-text "本季度全渠道营销归因漏斗分析：社交媒体曝光触点占预算40%……" --aspect-ratio "16:9" --async

轮询查询任务结果（必选） 使用 task_id 循环查询任务状态，每一轮轮询后，即时将当前返回的核心资料同步反馈给用户，直至获取完整结果。调用示例：
```
python scripts/query_task.py --task-id "返回的task_id值"
```
等待结果完成必须轮询直到完成。
结果解析与落地应用 提取漏斗图URL（funnel_image_url）、结构化归因数据（structured_funnel_data：总层数、各触点层级、权重占比、到下一层转化率、流失率、是否推断标注）、优化后的生图提示词（optimized_prompt），用于营销汇报、预算再分配决策或图像复现微调。
生成html页面 生成一个简单的html页面来融合返回的主要信息，特别是漏斗图图片。

使用示例

示例1：全渠道营销归因漏斗分析

输入：提供本季度全渠道营销归因分析报告（社交媒体曝光 → 搜索引擎点击 → 私域社群注册 → 电商转化）
流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
产出：四层中文标注归因漏斗图 + 结构化归因数据（权重/转化率/流失率）+ 生图提示词
配置要点：aspect_ratio=16:9（适合汇报PPT横版展示）

示例2：报告无显式归因数据的智能推断

输入：仅有营销活动总结报告，未包含显式归因分析段落
流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
产出：基于原始报告智能推断的漏斗数据与漏斗图，推断字段自动标注 is_inferred=true
配置要点：直接粘贴报告全文即可，无需手工整理归因数据

示例3：竖版漏斗图用于移动端报告

输入：营销报告 + 指定竖版画面比例
流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
产出：适配移动端阅读的 3:4 或 9:16 竖版漏斗图
配置要点：aspect_ratio 可选 1:1、3:4、4:3、16:9、9:16

生成效果示例

描述

技能运行后输出三类结果：

漏斗图图片（funnel_image_url）：专业商务级多触点归因漏斗图，图中文字为中文，漏斗层级宽度与触点权重占比进行视觉映射，逐层标注触点名称、预算权重、到下一层转化率与流失率，配色商务、构图整洁，可直接用于营销汇报；
结构化归因数据（structured_funnel_data）：包含总层数（total_layers）、数据来源类型（data_source_type，报告抽取或智能推断）、漏斗层级明细（funnel_layers：层级ID、触点中文名、权重占比、到下一层转化率、流失率、是否推断标注）；
优化后的生图提示词（optimized_prompt）：用于生成漏斗图的精准提示词，便于后续复现或微调图像风格。

输出案例

说明：若输出结果包含图片，优先插入对应图片资源，之后再输出 JSON / Markdown 格式的文本内容。

生成效果示例图：

生成效果示例1

生成效果示例2

生成效果示例3

接口返回 JSON 数据示例（以四层全渠道归因报告为输入）：

{
  "showapi_res_body": {
    "structured_funnel_data": {
      "data_source_type": "extracted",
      "total_layers": 4,
      "funnel_layers": [
        {
          "layer_id": 1,
          "touchpoint_name_cn": "社交媒体曝光触点",
          "weight_percentage": 40,
          "conversion_rate_to_next": 5,
          "drop_rate": 95,
          "is_inferred": false
        },
        {
          "layer_id": 2,
          "touchpoint_name_cn": "搜索引擎点击触点",
          "weight_percentage": 30,
          "conversion_rate_to_next": 15,
          "drop_rate": 85,
          "is_inferred": false
        },
        {
          "layer_id": 3,
          "touchpoint_name_cn": "私域社群注册触点",
          "weight_percentage": 20,
          "conversion_rate_to_next": 25,
          "drop_rate": 75,
          "is_inferred": false
        },
        {
          "layer_id": 4,
          "touchpoint_name_cn": "电商转化触点",
          "weight_percentage": 10,
          "conversion_rate_to_next": 0,
          "drop_rate": 0,
          "is_inferred": false
        }
      ]
    },
    "funnel_image_url": "https://oss.showapi.com/result/funnel_chart_xxxxxxxx.png",
    "optimized_prompt": "专业商务级多触点营销归因漏斗图，中文标注，四层漏斗结构自上而下：第一层社交媒体曝光触点（预算权重40%）→ 第二层搜索引擎点击触点（权重30%，曝光到点击转化率5%）→ 第三层私域社群注册触点（权重20%，点击到注册转化率15%）→ 第四层电商转化触点（权重10%，注册到转化转化率25%）；漏斗层级宽度与权重占比视觉映射，逐层标注触点名称、权重与转化率，深蓝金色商务配色，简洁扁平风格，16:9横版构图，适合商业汇报展示"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

资源索引

scripts/execute_task.py：异步提交营销归因漏斗图生成任务（真实调用时使用）
scripts/query_task.py：轮询查询异步任务结果（真实调用时使用）

响应数据结构

1. 异步任务提交响应

{
  "showapi_res_body": {
    "task_id": "唯一任务ID",
    "status": "pending",
    "msg": "任务已提交，正在异步处理中"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

2. 任务查询响应（单轮轮询返回数据，需实时同步给用户）

{
  "showapi_res_body": {
    "structured_funnel_data": {
      "data_source_type": "数据来源类型（extracted=报告抽取 / inferred=智能推断）",
      "total_layers": 4,
      "funnel_layers": [
        {
          "layer_id": 1,
          "touchpoint_name_cn": "触点中文名",
          "weight_percentage": 40,
          "conversion_rate_to_next": 5,
          "drop_rate": 95,
          "is_inferred": false
        }
      ]
    },
    "funnel_image_url": "生成的多触点归因漏斗图URL",
    "optimized_prompt": "精准优化后的生图提示词"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

report_text 为必填项，需提供营销报告全文或核心段落文本；若报告中缺少归因分析，系统将基于原始报告智能推断生成，推断字段会通过 is_inferred=true 标注。
aspect_ratio 可选值：1:1、3:4、4:3、16:9、9:16，默认 16:9。
所有任务强制异步执行，不支持同步模式。
轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
图像生成环节内部轮询最长 600 秒（间隔 5 秒），请耐心等待轮询直至任务完成。
模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请通过手机验证获取 AppKey 并配置。

营销归因漏斗图生成-万维易源

营销归因漏斗图生成

任务目标

能力组成

能力流程描述

技能能力组成流程图

前置准备

如何获取 AppKey

注意事项

操作步骤

模拟体验流程（无 appKey）

标准流程（有 appKey，强制异步执行）

使用示例

示例1：全渠道营销归因漏斗分析

示例2：报告无显式归因数据的智能推断

示例3：竖版漏斗图用于移动端报告

生成效果示例

描述

输出案例

资源索引

响应数据结构

1. 异步任务提交响应

2. 任务查询响应（单轮轮询返回数据，需实时同步给用户）

注意事项