这个品类的数据长什么样
广告营销领域的收益率数据主要来源于广告投放管理系统、第三方广告效果监测平台。数据更新节奏为每日凌晨完成前一日全量数据的汇总与更新。单份日报文档以投放计划、媒体渠道、投放时段为拆分维度，包含投放计划ID、媒体渠道名称、投放时段、累计曝光次数、累计点击次数、累计转化次数、总投放消耗金额、总收益金额、单位消耗收益比等字段。其中金额类字段以人民币元为单位，次数类字段以次、个为单位。
这些特征在「分享与嵌入」这一环带来什么约束
广告营销收益率数据的每日全量更新特性，要求分享与嵌入的模块需支持定时同步数据源，避免返回过时的历史数据。按投放渠道拆分的结构化数据，要求嵌入的对话机器人需支持按渠道、时段参数筛选召回内容，避免返回冗余的无关数据。多来源的数据源接入特性，要求配置项需支持绑定多个广告监测平台的数据源，整合跨渠道的收益率数据。金额类字段的展示需求，要求嵌入模块需支持格式化金额展示，同时需配置权限控制避免敏感数据泄露。此外，营销场景下常需将数据分享给外部客户或嵌入内部报表系统，要求嵌入的交互功能需适配外部页面的展示逻辑。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
datasourceSyncInterval | 86400 秒 | 匹配广告营销收益率数据的每日全量更新节奏，保证API与嵌入模块返回最新的单日数据 |
recallTopK | 前 8–12 条 | 广告营销日报按投放渠道拆分后数据条目较多，限制召回条数避免返回冗余信息 |
similarityThreshold | 0.78–0.82 | 精准匹配用户查询的投放渠道或时段，过滤无关的日报数据 |
shareApiAuth | 启用密钥验证 | 控制API分享的访问权限，仅允许授权的营销系统调用接口 |
iframeSandbox | allow-same-origin allow-scripts allow-popups | 配置iframe的安全权限，支持外部图片放大功能同时规避跨域风险 |
enableExternalImageZoom | 开启 | 支持在嵌入页面的外部容器中放大回复中的图片，解决iframe内查看模糊的问题 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 调用分享API时部分问题无法召回知识库数据，调试页面可正常召回。未配置
datasourceSyncInterval参数，API使用的数据源未定时同步最新的广告营销日报数据，导致API调用时无匹配的最新数据。 - 嵌入网页的对话机器人回复中带有图片时，仅能在iframe内部放大查看，无法在外部容器全屏查看。未开启
enableExternalImageZoom配置项，或iframe的sandbox权限未包含allow-popups参数。 - 修改嵌入前端代码后，浏览器控制台提示“连接被阻止，因为它是由公共页面启动的，意图连接到本地网络上的设备或服务器”。未配置
iframeAllowList参数，或允许的域名未包含自定义前端代码部署的域名，导致浏览器的跨域安全策略拦截了请求。
怎么确认配好了
- 调用分享API，查询预设的投放渠道数据，核对返回结果与调试页面的召回结果匹配。
- 在嵌入页面的对话机器人中发送包含图片的测试问题，点击图片确认可脱离iframe容器放大查看。
- 查看浏览器控制台与API日志，确认无认证失败、跨域拦截或数据源同步异常的提示。
- 等待数据源刷新间隔周期结束后，再次调用API核对数据更新时间与官方日报发布时间一致。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。