Mediago API
zh
  • en
  • zh
  1. 广告计划管理
Mediago API
zh
  • en
  • zh
  • 身份认证
    • 获取访问令牌
      POST
  • 账户管理
    • 获取授权账户列表
      GET
  • 广告计划管理
    • 获取授权广告计划列表
      GET
    • 获取广告计划详情
      GET
    • 创建广告计划
      POST
    • 更新广告计划
      POST
    • 批量更新广告计划
      POST
    • 批量开启/关闭广告计划
      POST
    • 批量归档广告计划
      POST
  • 广告管理
    • 获取授权广告列表
      GET
    • 批量开启/关闭广告
      POST
  • Sites屏蔽管理
    • 获取账户层级Site屏蔽列表
      GET
    • 账户层级Site屏蔽/解除屏蔽
      POST
    • 获取广告计划层级Site屏蔽列表
      GET
    • 广告计划层级Site屏蔽/解除屏蔽
      POST
  • API 报表
    • 获取账户层级天级报表
      GET
    • 获取广告计划天级报表
      GET
    • 获取广告天级报表
      GET
    • 获取广告计划或广告小时级报表
      GET
    • 获取账户层级Site天级报表
      GET
    • 获取广告计划层级Site天级报表
      GET
  1. 广告计划管理

批量更新广告计划

POST
https://api.mediago.io/manage/v2/campaign/bulk-update
Last modified:2025-10-13 07:54:11

提示#

该 API 支持同时并发处理最多 10 个广告计划
每次请求最多可提交 10 个活动
响应时间通常在 5 秒以内
每个活动在独立事务中处理，以确保数据一致性
QPS（每秒查询次数）限制：60，IP 限制：15

支持的更新字段#

字段名类型描述描述必填
campaign_idsarray广告计划ID列表1-10个ID是
daily_capdouble日预算限制天预算，最低天预算为$20/天，daily_cap/cpc不能小于30否
cpcdoubleCPC出价单次点击消耗（单位：美元），cpc不能高于$5，daily_cap/cpc不能小于30当计费类型（charge_type）设置为点击计费（cpc）或智能出价（smart_bid）时，需要点击计费价格（cpc）；当计费类型设置为最大转化出价（maxcv）时，不需要点击计费价格（cpc）
statusinteger状态开关广告计划的开启/关闭状态，其中0表示关闭，1表示开启否
start_timestring开始时间广告计划的开始时间，格式为yyyy-mm-dd hh:mm:ss，不能早于调用API的当天否
end_timestring结束时间广告计划的结束时间，格式为yyyy-mm-dd hh:mm:ss，不能早于开始时间，也不能晚于2030年否
charge_typestring计费类型出价方式，默认使用历史值。允许的值包含：cpc, smart_bid, max_cv否
target_cpadouble目标CPA您活动的目标CPA（单位：美元）营销目标选择潜在客户生成或在线购买时，需要提供目标CPA；当选择网站参与时，不需要目标CPA。
objectivestring广告目标您活动的目标。注意：请选择一个目标。允许的值包括："lead" 表示潜在客户生成，"conversions" 表示在线购买，"awareness" 表示网站参与否
optimization_typestring优化类型您活动的转化目标。注意：请填写一个转化目标。转化目标是账户中嵌入的Pixel重要转化类型。如果Pixel重要转化尚未安装，请选择'-1'作为值。允许的值包括："1" 表示查看内容，"2" 表示应用安装，"3" 表示完成注册，"4" 表示添加到购物车，"5" 表示添加支付信息，"6" 表示搜索，"7" 表示开始结账，"8" 表示购买，"9" 表示添加到心愿单，"10" 表示潜在客户，"-1" 表示默认优化当营销目标选择潜在客户生成或在线购买时，optimization_type为必填项；当选择网站参与时，optimization_type不是必填optimization_type是账户中嵌入的Pixel重要转化类型。如果Pixel重要转化尚未安装，您可以选择默认优化，这将优化默认传回的重要转化。
day_parting[][]int投放时段一个7*24的数组，指示您开启广告计划的特定时段或特定星期几，其中第一维度的索引0-6表示周一到周日，第二维度的索引0-23表示一天中的小时数，值1表示选中，0表示未选中 例如：[[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],[0,0,0,1,1,1,1,1,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0],[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]]表示活动将在每周五上午3点到下午2点运行否
dp_timezonestring时段时区默认选择您的账户时区。我们将根据所选时区投放广告计划。允许的值包含：EST UTC-12 UTC-11 UTC-10 UTC-9 UTC-8 UTC-7 UTC-6 UTC-5 UTC-4 UTC-3 UTC-2 UTC-1 UTC UTC+1 UTC+2 UTC+3 UTC+4 UTC+5 UTC+6 UTC+7 UTC+8 UTC+9 UTC+10 UTC+11 UTC+12 UTC+13 UTC+14否

常见问题解答 (FAQ)#

Q1: 为什么我的CPC设置失败了？#

A: CPC设置失败通常有以下几个原因：
低于最小值: 不同币种有不同的最小CPC要求，请参考币种限制表
精度问题: CPC最多支持3位小数，如0.123
超过上限: CPC不能超过5美元，且不能超过日预算的1/30
大于日预算: CPC不能大于当前的日预算设置

Q2: MaxCV模式的日预算限制是什么？#

A: MaxCV模式有特殊的日预算限制：
普通MaxCV: 日预算不能超过20000
MaxCV Plus: 日预算不能超过30000
变化限制: 日预算变化不能超过原值的10倍，需要逐步调整

Q3: 投放时段设置有什么要求？#

A: 投放时段设置要求：
矩阵格式: 必须是7×24的二维数组，代表7天×24小时
值限制: 每个时段只能是0（关闭）或1（开启）
至少一个: 至少要有一个时段设置为1
时区转换: 系统会根据dp_timezone自动进行时区转换

Q4: 为什么Campaign更新失败提示"无有效广告素材"？#

A: 这是因为：
Campaign必须包含有效的广告素材才能进行编辑
广告素材可能已被删除或审核不通过
解决方案: 为Campaign添加有效的广告素材后再进行更新

Q5: 如何处理部分Campaign更新失败的情况？#

A: 接口支持部分成功：
成功的Campaign: 会在success_campaign_ids中返回
失败的Campaign: 会在failed_campaign_ids中返回
详细错误: 在validation_errors中查看具体的错误原因和字段信息
重试策略: 可以针对失败的Campaign修正参数后重新提交

Q6: 币种限制是如何确定的？#

A: 币种限制基于以下原则：
最小CPC: 确保广告有效竞价的最低出价
最小日预算: 确保Campaign有足够预算进行投放
汇率考虑: 基于各币种的购买力和市场情况设定

Q7: 时间格式有什么特殊要求？#

A: 时间格式要求：
严格格式: 必须使用YYYY-MM-DD HH:MM:SS格式
时区处理: 时间会根据账户时区进行处理
逻辑验证: 开始时间必须早于结束时间
示例: 2024-01-01 00:00:00

Q8: 如何理解CPC与日预算的关系？#

A: CPC与日预算有以下关系：
基本原则: CPC不能大于日预算
效率考虑: CPC建议不超过日预算的1/30，确保有足够点击机会
上限控制: CPC最高不超过5美元（等值其他币种）

Request

Header Params

Body Params application/json

Example
基础字段更新示例
{
  "campaign_ids": [
    123456,
    789012
  ],
  "status": 1,
  "cpc": 0.25,
  "daily_cap": 100.0,
  "start_time": "2024-01-01 00:00:00",
  "end_time": "2024-12-31 23:59:59",
  "charge_type": "cpc",
  "target_cpa": 5.0,
  "objective": "lead_generation",
  "optimization_type": "cpa",
  "day_parting": [
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0]
  ],
  "dp_timezone": "Asia/Shanghai"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.mediago.io/manage/v2/campaign/bulk-update' \
--header 'Authorization: Bearer your_access_token_here' \
--header 'Content-Type: application/json' \
--data-raw '{
  "campaign_ids": [
    123456,
    789012
  ],
  "status": 1,
  "cpc": 0.25,
  "daily_cap": 100.0,
  "start_time": "2024-01-01 00:00:00",
  "end_time": "2024-12-31 23:59:59",
  "charge_type": "cpc",
  "target_cpa": 5.0,
  "objective": "lead_generation",
  "optimization_type": "cpa",
  "day_parting": [
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0],
    [0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0]
  ],
  "dp_timezone": "Asia/Shanghai"
}'

Responses

🟢200成功响应
application/json
Body

Example
{
    "code": 0,
    "msg": "Bulk update completed",
    "data": {
        "success_campaign_ids": [123, 456],
        "failed_campaign_ids": [789],
        "failed_reasons": ["Campaign 789: no permission to operate"],
        "validation_errors": [
            {
                "campaign_id": 789,
                "field": "cpc",
                "value": "0.15",
                "message": "CPC 0.150 is below minimum value 0.200"
            }
        ]
    }
}
🟠400参数错误响应
Modified at 2025-10-13 07:54:11
Previous
更新广告计划
Next
批量开启/关闭广告计划
Built with