SuperAPI AI 工具集

ads

编程与开发

查看项目

更新于 10-16 09:30

技能介绍

用途:通过 Spotify Ads API 管理广告组与广告,包括列表、获取、创建与更新,默认走草稿端点暂存变更,直接写入已发布实体需用户显式要求。

主要能力:支持 ad-sets 与 ads 两类资源的 list、get、create、update;先读取平台设置文件获取 TOKEN、AD_ACCOUNT_ID、AUTO_EXECUTE、BASE_URL 等环境值(可用 api --env 输出)。创建与更新默认使用 drafts 端点,create-live、update-live 为显式直达发布的备用路径。

用法:参数格式为 <resource> <operation> [id];如 ad-sets list 对应 GET ad_accounts/{ad_account_id}/ad_sets?limit=50&sort_direction=DESC。地理定向通过 targets/geos 查询,geo_targets 为含必填 country_code 的扁平对象,可含 region_ids、city_ids、postal_code_ids。金额一律换算为微单位(乘 1,000,000)。执行前按参考资料校验广告产品规则,并先跑 audience 估算(POST estimates/audience,顶层路径),再写入草稿。auto_execute 为 true 直接执行,否则展示命令待确认。

适用场景:需要程序化管理 Spotify 广告组与广告的营销、投放与运营流程。

限制与注意:草稿更新仅支持部分字段;不得发送零或负预算、零出价(MAX_BID/COST_PER_RESULT 下)、不要传 currency 到广告组创建体;platforms 仅 ANDROID、DESKTOP、IOS;POST/PATCH 出错不自动重试;403 时不得重试或断定凭据只读;发布草稿需单独请求并在发布前即时确认;最小受众阈值 400 时不得自行放宽定向。