shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsAPI key required

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

深度解析用户营销报告，提取或推断多触点归因数据，生成带中文标注的专业商务级漏斗图；适用于营销数据分析、多触点转化漏斗可视化、归因模型展示场景

personAuthor: u_b7ff7d1bhubenterprise
downloadDownload package

营销归因漏斗图生成

任务目标

  • 深度解析营销报告文本，精准提取或推断多触点归因数据结构
  • 自动生成结构化漏斗数据，并渲染精准生图提示词
  • 生成带中文标注的专业商务级多触点归因漏斗图
  • 支持自定义画面比例，适用于各类汇报与展示场景

能力组成

能力流程描述

该技能通过异步任务机制完成营销归因漏斗图的生成，完整能力链路包含以下阶段：

  1. 意图解析阶段：分析用户提供的营销报告文本，明确漏斗图生成的核心意图与专业标准。
  2. 数据抽取与推断阶段：从非结构化的报告文本中，抽取各触点层级、权重占比、转化率等核心数据；若报告未直接提供，则基于上下文进行合理推断并标注。
  3. 提示词渲染阶段：将结构化归因数据结合视觉映射规则（如权重宽度映射、中文标注优先），转化为精准优化的生图提示词。
  4. 图像生成与轮询阶段：调用底层图像生成能力产出漏斗图，系统自动通过轮询机制等待图像生成完成（超时时间 600 秒，间隔 5 秒）。
  5. 结果交付阶段：将最终生成的漏斗图 URL、结构化漏斗数据以及生图提示词组装返回，支持 HTML 可视化展示。

技能能力组成流程图

技能能力组成流程图

前置准备

  • 凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
  • 模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
  • 依赖：仅使用 Python 标准库，无需安装第三方包

操作步骤

模拟体验流程（无 appKey）

  1. 自动触发模拟调用 系统检测到未配置 appKey 时，自动向 https://www.showapi.com/_nuxt3/api/2405-105 发送 POST 请求（body: {"flow_id":"6a3b8e6c3c51f2c209002e8f"}），直接获取完整模拟生成结果。此过程为一次性返回，不执行 execute_task.py 和 query_task.py。

  2. 可视化预览 将返回的 JSON 结果以 HTML 形式可视化展示，重点呈现生成的漏斗图图片内容。

  3. 引导真实调用 提示用户当前为无 appKey 的模拟运行结果。如需真实调用，请前往 ShowAPI 注册账号（注册即送2元余额），并在 https://www.showapi.com/console#/myApp 获取 appKey。

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

  1. 收集用户需求 梳理用户提供的营销报告全文或核心段落文本，确认需要呈现的漏斗层级与画面比例（选填，默认 16:9）。

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

    python scripts/execute_task.py --report-text "本季度全渠道营销归因漏斗分析报告..." --aspect-ratio 16:9 --async

  3. 轮询查询任务结果（必选） 使用 task_id 循环查询任务状态，每一轮轮询后，即时将当前返回的核心资料同步反馈给用户，直至获取完整结果。 调用示例：

    python scripts/query_task.py --task-id "返回的task_id值"

  4. 等待结果完成 必须轮询直到完成。

  5. 结果解析与落地应用 提取生成的漏斗图链接及结构化归因数据，用于汇报演示或进一步分析。

  6. 生成html页面 生成一个简单的html页面来融合返回的主要信息，特别是漏斗图图片。

使用示例

示例1：全渠道营销归因报告可视化

  • 输入：提供包含曝光、点击、注册、转化四层结构的全渠道营销报告文本
  • 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
  • 产出：带各层转化率与权重标注的专业漏斗图
  • 配置要点：aspect_ratio=16:9，适合宽屏汇报演示

示例2：私域社群转化漏斗生成

  • 输入：提供社群运营的触达、互动、留资、成交数据文本
  • 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
  • 产出：适配移动端展示的竖版漏斗图
  • 配置要点：aspect_ratio=9:16，适合手机端查看

生成效果示例

描述

技能运行后，会输出三部分核心内容：

  1. funnel_image_url：生成的多触点归因漏斗图 URL，图中包含中文触点名称、权重占比、转化率等关键标注，视觉上呈现宽度递减的金字塔形态。
  2. structured_funnel_data：从报告中抽取或推断的结构化数据，包含总层数、数据来源类型及各层级的详细指标（是否推断、流失率、转化率、层级ID、权重、触点中文名）。
  3. optimized_prompt：底层模型使用的精准生图提示词，可用于复现或微调。

输出案例

说明：优先插入生成的漏斗图图片资源，之后再输出 JSON 格式的结构化数据。

生成效果示例1 生成效果示例2 生成效果示例3

{
  "showapi_res_body": {
    "funnel_image_url": "https://oss.showapi.com/generated/funnel_12345.png",
    "structured_funnel_data": {
      "total_layers": 4,
      "data_source_type": "报告直接提取",
      "funnel_layers": [
        {
          "layer_id": 1,
          "touchpoint_name_cn": "社交媒体曝光触点",
          "weight_percentage": 40.0,
          "conversion_rate_to_next": 5.0,
          "drop_rate": 95.0,
          "is_inferred": false
        },
        {
          "layer_id": 2,
          "touchpoint_name_cn": "搜索引擎点击触点",
          "weight_percentage": 30.0,
          "conversion_rate_to_next": 15.0,
          "drop_rate": 85.0,
          "is_inferred": false
        }
      ]
    },
    "optimized_prompt": "A professional marketing attribution funnel chart, 4 layers..."
  },
  "showapi_res_code": 0
}

资源索引

响应数据结构

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": {
      "total_layers": "总层数(integer)",
      "data_source_type": "数据来源类型(string)",
      "funnel_layers": [
        {
          "is_inferred": "是否推断(boolean)",
          "drop_rate": "流失率(number)",
          "conversion_rate_to_next": "到下一层转化率(number)",
          "layer_id": "层级ID(integer)",
          "weight_percentage": "权重占比(number)",
          "touchpoint_name_cn": "触点中文名(string)"
        }
      ]
    },
    "optimized_prompt": "精准优化后的生图提示词",
    "funnel_image_url": "生成的多触点归因漏斗图URL"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

  1. report_text 为必填项，需提供营销报告的全文或核心段落，数据越完整生成的漏斗越精准。
  2. 所有任务强制异步执行，不支持同步模式。
  3. 轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
  4. 若报告数据缺失，模型会进行推断并在 is_inferred 字段标注为 true。
  5. 模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请注册 ShowAPI 账号并配置 appKey。