这个品类的数据长什么样
广告营销智能尽调报告的数据主要来自广告投放平台API、媒体监测工具接口、第三方舆情系统以及合规备案数据库。数据更新节奏差异明显，广告投放的实时曝光、转化数据为小时级更新，舆情数据为分钟级更新，合规备案数据则为季度级更新。单份报告的文档结构包含媒体资源标识、投放时段、曝光量、转化量、预算金额、合规关键词命中情况等字段，单位分别为次、个、元，部分数据源会以千次曝光、万元为单位呈现数据。
这些特征在「HTTP 接口与外部系统」这一环带来什么约束
多数据源的接入需求要求配置多个独立的外部API端点，每个端点的鉴权方式、请求格式存在差异，需要分别适配。不同的更新节奏需要设置差异化的轮询间隔，避免高频调用触发限流。字段与单位的不统一要求配置专门的映射与转换规则，否则会导致尽调报告数据混乱。合规类数据源的访问频次限制更为严格，需要额外配置限流策略，防止接口被临时封禁。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
external_api_auth_type | 按对接平台选，如api_key或oauth2_client_credentials | 不同广告营销数据源的鉴权标准不同，投放平台多采用API Key，合规备案接口多采用OAuth2 |
external_api_poll_interval | 1–5 分钟 | 广告投放数据更新频率多为小时级，舆情数据为分钟级，取中间区间平衡实时性与调用限额 |
field_mapping_rule | 按数据源字段映射至media_id、put_time、impression_count等标准字段 | 广告营销数据源的字段命名差异大，统一映射后可适配后续处理逻辑 |
request_rate_limit | 100 请求/分钟 | 多数广告平台API限流阈值为100-200请求/分钟，取区间下限避免触发限流 |
response_parse_timeout | 30 秒 | 广告数据接口返回数据量较大，30秒可覆盖多数正常响应时长 |
unit_conversion_config | 开启千次曝光转单次、万元转元 | 不同数据源的单位格式不一致，统一单位后可保证尽调报告数据一致性 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 调用第三方广告平台API返回404错误。原因是未正确配置接口端点路径，部分平台的API版本路径存在差异，例如部分媒体平台的v2版本接口与v1路径不一致。
- 接口返回数据字段为空。原因是未配置正确的字段映射规则，广告营销数据源的嵌套字段（如
data.report.impression）未正确提取，导致后续处理无法获取有效数据。 - 接口调用触发限流报错。原因是未设置合理的请求限流阈值，高频调用广告平台API导致被平台封禁临时访问权限。
怎么确认配好了
- 发起单次测试调用，查看接口返回的原始数据是否与第三方平台的控制台数据一致。
- 检查字段映射后的标准字段是否完整，无缺失或格式错误。
- 查看调用日志，确认请求频次未超过配置的限流阈值，无404或限流报错。
- 触发尽调报告生成流程，确认生成的报告中包含正确的广告投放数据与统一的单位格式。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。