用途:把 Spotify Ads API 的 campaign、ad set、ad 层级实体数据导出为 CSV,可选合并效果指标,用于离线审阅。
主要能力:支持导出全部 campaign 或指定 campaign(UUID);用 --metrics 附带 impressions、spend、clicks、reach、frequency、ctr、completes、completion_rate;用 --date-range <start> <end> 指定指标日期范围(ISO 8601,默认最近 30 天)。CSV 为反规范化结构,每行一个 ad,重复 campaign 与 ad set 数据;无 ad 的 ad set 也会输出一行,ad 列留空。
使用方式:先设置 PLUGIN_ROOT 并定义 api() 包装脚本,首次调用 Ads API v3 前需阅读 live-openapi.md。可用 api --env 获取 TOKEN、AD_ACCOUNT_ID、AUTO_EXECUTE、BASE_URL 等设置,输出可安全 eval。实体数据需完整分页(limit=50,按 offset 递增);指标通过 aggregate_reports 按 CAMPAIGN、AD_SET、AD 层级获取,指定日期范围时改用 granularity=DAY 并加 report_start/report_end,LIFETIME 时不要传这两个参数,分页用 continuation_token。金额字段中 micro_amount 需除以 1,000,000;指标 SPEND 已是计费货币,直接显示。写 CSV 建议用 Python csv 模块或 jq @csv,避免用 echo 拼接。
适用场景:需要把广告账户结构、定向、预算、出价与效果数据导出成表格做离线分析或存档时。
限制:DMA 级定向(dma_ids)对新 ad set 已不可用,旧 campaign 可能仍含该数据;大账户(50+ campaign)分页可能耗时 30-60 秒;某实体无指标时对应指标列留空;出错时展示错误并继续用已有数据,同时标注缺失的实体类型。auto_execute 为 true 时直接执行,为 false 时先展示首个 curl 命令并确认。其他事实暂未提供。