批量更新推广计划

HTTP请求方式

POST

请求地址

https://api.e.360.cn/display/campaign/Update

Headers 请求参数

字段	类型	必须	描述
Content-Type	string	yes	application/json
apiKey	string	yes	注册时分配到的api key，该参数作为HTTP HEAD字段传递。
accessToken	string	yes	访问token

Body 请求参数

请求参数通过JSON Array传参，一次操作计划数量不超过100个，任意层级同object的重复key以最后一个为准

字段	类型	必须	描述
campaignId	integer	yes	待修改的推广计划ID
name	string	yes	推广计划名称，推广计划名称长度范围：[1字节：100字节]，字节计算参考UTF-8编码的字节长度；1个中文按3个字节计算，英文、数字、符号按1个字节计算注意：新建名称不能与同一账户下未删除的计划名称重复，不可输入敏感词；推广计划名称仅保留中间空格，首尾空格不保留
assetOrderTypeId	string	no	转化目标，仅在投放方式为oCPC、oCPM、放量投放时生效枚举值：根据数据来源判断转化类型，具体请查看表格
orderPrice	string	no	目标转化出价，仅在投放方式为oCPC、oCPM、放量投放时生效取值范围：[0.5,min（账户预算, 100000）]，需填写不小于0.5的整数或2位小数。单位：元
deepConversionType	string	no	深度转化优化枚举值：0-关闭，1-开启
deepOrderTypeId	string	no	深度转化目标，仅在投放方式为oCPC、oCPM、放量投放时生效枚举值：要支持根据账户内资产以及模型支持情况来判断哪些转化目标可作为深度转化目标
deepOrderPrice	string	no	深度目标转化出价，仅在投放方式为oCPC、oCPM、放量投放时生效取值范围：[0.5,min（账户预算, 100000）]，需填写不小于0.5的整数或2位小数。单位：元
orderUrl	string	no	转化成功页地址 URL，在投放方式为 CPM/CPC生效最多输入5个url，需用英文逗号隔开，单个url长度不可超过512字节
accelerateConsumeFlag	string	no	一键起量，仅在投放方式为oCPC、oCPM、放量投放时生效枚举值：0-关闭，1-开启注意：如果重新开启一键起量，生效时间会向后顺延；例如2点开启一键起量，3点关闭，4点又开启，则一键起量生效时间会投到10点；当开启深度转化优化时，此项仅支持关闭。
budget	string	yes	计划预算在投放方式为CPM/CPC时，取值范围：[50,Min(10000000, 账户预算)]，允许传0，表示不限预算；在投放方式为oCPC、oCPM时，取值范围：[100,Min(10000000, 账户预算)]，允许传0，表示不限预算；为放量投放时，取值范围：[100,Min(10000000, 账户预算)]，不允许传0。单位：元
equalBudgetFlag	string	yes	预算分配控制枚举值：0-标准：将每日预算均匀地分配到整个投放日程中，1-尽速：在投放日程中尽可能地获得更多的展现（建议与精准定向配合使用）。
startDate	string	yes	推广计划开始日期日期输入格式：YYYY-MM-DD，例如2023-12-31，输入日期不能早于当日，不能晚于 2038-01-18
endDate	string	no	推广计划结束日期日期输入格式：YYYY-MM-DD，不能早于开始日期，不能晚于 2038-01-18 ，不传或传空默认投放至2038-01-18
weekHours	object	yes	按小时投放日程，json格式，Week字段1-7 表示周一至周日，hour总数为48，其中0为此时段不投放，1为投放，全天不投放也需填写，整周至少投放任一时段。例:[{"week":1,"hour":[1,1,1,1,1,1,1,1,1,1……]},{"week":2,"hour": [0,0,0,0,0,0,0,0,0,0……]},{"week":3,"hour": [1,0,1,1,1,0,1,1,1,1……]}……]每周二不投放。

请求示例

curl --location --request POST 'http://localhost:8076/display/campaign/update' \
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--header 'Content-Type: application/json' \
--data-raw '[{
    "campaignId":5013389,
    "campaignName":"改个名字看看"
}]'

返回结果

{
  "data": [
    {
      "id": 5013489,
      "errno": 2000000,
      "message": "成功"
    }
  ],
  "errmsg": "OK",
  "errno": 0
}

返回结果说明

字段	类型	描述
id	string	修改的推广计划的id

results matching ""

No results matching ""