平台、Unified 实体、供应商 API、接口和连接器。
ads.campaignUnified即将推出一个广告系列,附投放目标、预算、状态和其下的广告组。
主键 平台 + 广告系列 ID计划 9 个调用暂无 Direct 接口
我们自己拟的第一版路径,尚未评审。每个调用通过你授权的 Connection 作用于所列平台,目前都还没有部署。
/ v1/ ads/ campaigns广告系列列表,附状态、预算和花费全部 8 个广告平台草稿/ v1/ ads/ tree按层级一次返回广告系列、广告组和广告全部 8 个广告平台草稿/ v1/ ads/ campaigns/ {campaignId}读取一个广告系列在平台上的当前设置全部 8 个广告平台草稿/ v1/ ads/ campaigns/ {campaignId}/ analytics一个广告系列按天的花费和效果全部 8 个广告平台草稿/ v1/ ads/ campaigns新建广告系列,设置目标和预算全部 8 个广告平台草稿/ v1/ ads/ campaigns/ {campaignId}修改预算、出价或名称Meta · Google · Reddit · OpenAI草稿/ v1/ ads/ campaigns/ {campaignId}/ status暂停或恢复一个或多个广告系列全部 8 个广告平台草稿/ v1/ ads/ campaigns/ {campaignId}/ duplicate复制广告系列,连同其中的广告组和广告Meta · TikTok · LinkedIn草稿/ v1/ ads/ campaigns/ {campaignId}删除广告系列全部 8 个广告平台草稿根据各广告平台自己的对象拟定的第一版 schema。Unified 层上线前,字段名、类型和覆盖范围都可能调整。
ad_accountAdAccount平台报告值namestring平台报告值objectivestring平台报告值映射到统一的目标列表,保留平台原值statusStatus平台报告值投放中、已暂停或已归档,统一成一套状态budgetBudget平台报告值按日预算或总预算,使用账户币种bid_strategystring平台报告值starts_atdatetime平台报告值ends_atdatetime平台报告值spendMoney平台报告值impressionsinteger平台报告值clicksinteger平台报告值conversionsnumber平台报告值按各平台自己的归因窗口统计已经能返回这类对象的供应商接口,字段保持供应商的原始格式。代码中指定供应商,更换供应商需要改代码。
目前还没有 Direct 接口返回 Campaign,它会随 Unified 层一起上线。