批量添加推广计划

HTTP请求方式

POST

请求地址

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

Headers 请求参数

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

Body 请求参数

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

字段	类型	必须	描述
campaignName	string	yes	推广计划名称，推广计划名称长度范围：[1字节：100字节]，字节计算参考UTF-8编码的字节长度；1个中文按3个字节计算，英文、数字、符号按1个字节计算注意：新建名称不能与同一账户下未删除的计划名称重复，不可输入敏感词；推广计划名称仅保留中间空格，首尾空格不保留
ocpxFlag	string	yes	是否为oCPX计划枚举值：0-否，1-标准oCPC（需转化收集），2-oCPM计划（需收集转化），3-放量投放计划（需收集转化）
bidPolicy	string	yes	模式选择，仅在是否为oCPX计划为标准版oCPC、oCPM计划时生效枚举值：0-目标成本模式 1-稳定模式，2-稳定启动模式；注意：2-稳定启动模式仅中小客户可用
orderSource	string	yes	数据来源，仅当是否为oCPX计划为标准版oCPC、oCPM计划、放量投放计划时生效枚举值：0-代码监测，1-建站工具，2-API对接
orderType	string	yes	转化类型，仅在是否为oCPX计划为标准版oCPC、oCPM计划、放量投放计划时生效枚举值：根据数据来源判断转化类型，具体请查看表格
bootStrategy	string	yes	冷启动策略，仅在是否为oCPX计划为标准版oCPC、oCPM计划时生效枚举值：0-放量投放，1-CPC，2-CPM，3-模型出价注意：标准版oCPC不可选CPM，oCPM计划不可选CPC；模型出价有限制条件，同主体下至少有一个推广组30天内，在相同转化类型下有≥10个转化时可选择，如果主体投放下降，会出现某个账户曾经可选模型出价，后面不可选的情况。
orderPrice	string	yes	目标转化成本，仅在是否为oCPX计划为标准版oCPC、oCPM计划时生效取值范围：[0.5,max（账户预算, 100000）]，需填写不小于0.5的整数或2位小数。
cpmPrice	string	yes	CPM出价，仅在是否为oCPX计划为oCPM计划时生效取值范围：[0.1,max（账户预算, 100000)] ，需填写不小于0.1的整数或2位小数。
cpcPrice	string	yes	CPC出价，仅在是否为oCPX计划为标准版oCPC时生效取值范围：[0.1,max（账户预算, 100000)] ，需填写不小于0.1的整数或2位小数。
orderUrl	string	no	转化成功页地址 URL，在是否为oCPX计划为否、或标准版oCPC、oCPM计划、放量投放计划的转化类型为快投放时生效最多输入5个url，需用英文逗号隔开，单个url长度不可超过512字节
accelerateConsumeFlag	string	no	一键起量，仅在是否为oCPX计划为标准版oCPC、oCPM计划时生效枚举值：0-关闭，1-开启注意：如果重新开启一键起量，生效时间会向后顺延；例如2点开启一键起量，3点关闭，4点又开启，则一键起量生效时间会投到10点。
budget	string	yes	每日预算在是否为oCPX计划为否时，取值范围：[50,Min(10000000, 账户预算)]，允许传0，表示不限预算；在是否为oCPX计划为标准版oCPC、oCPM计划时，取值范围：[100,Min(10000000, 账户预算)]，允许传0，表示不限预算；但当冷启动策略选择nobid时，不可选择不限预算；在是否为oCPX计划为放量投放计划时，取值范围：[100,Min(10000000, 账户预算)]，不允许传0。
equalBudgetFlag	string	yes	预算分配控制，仅在是否为oCPX计划为否时生效枚举值：0-标准：将每日预算均匀地分配到整个投放日程中，1-尽速：在投放日程中尽可能地获得更多的展现（建议与精准定向配合使用）。
budgetLimitedAlert	string	yes	预算受限提醒枚举值：0-否，1-是
auditRefusedWarnFlag	string	yes	创意审核拒登提醒枚举值：0-否，1-是
startDate	string	yes	推广计划开始日期日期输入格式：YYYY-MM-DD，例如2023-12-31，输入日期不能早于当日，不能晚于 2030-12-31
endDate	string	no	推广计划结束日期日期输入格式：YYYY-MM-DD，不能早于开始日期，不能晚于 2030-12-31，不传或传空默认投放至2030-12-31
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……]}……]每周二不投放。

数据来源与转化类型对应关系

数据来源为代码监测（枚举值为0）时

转化类型	描述
0	订单转化
1	注册转化
2	创建角色转化
3	到达转化
4	自定义转化
5	次日活跃转化
11	表单转化
13	咨询转化
14	线索转化
15	快投放

数据来源为建站工具（枚举值为1）时

转化类型	描述
1	掌中云-注册
3	服务号-新客
4	点击转化
6	服务号-老客
11	表单转化
12	电话按钮点击
13	咨询转化
18	有效浏览
21	中间页
22	有效时长浏览
23	一句话咨询
24	三句话咨询

数据来源为API对接（枚举值为2）时

转化类型	描述
0	订单转化
1	注册转化
3	创建角色转化
4	到达转化
5	自定义转化
11	表单转化
12	有效电话转化
13	咨询转化
14	线索转化
21	中间页

请求示例

curl --location --request POST 'https://api.e.360.cn/display/campaign/Add' \
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "campaignName": "新建一个推广计划",
        "ocpxFlag": "2",
        "bidPolicy": "1",
        "orderSource": "1",
        "orderType": "1",
        "bootStrategy": "0",
        "orderPrice": "100",
        "cpmPrice": "101",
        "cpcPrice": "99",
        "orderUrl": "",
        "budget": "101",
        "equalBudgetFlag": "1",
        "budgetLimitedAlert": "1",
        "auditRefusedWarnFlag": "0",
        "startDate": "2023-11-22",
        "weekHours": [
            {
                "week": 1,
                "hour": [0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
            },
            {
                "week": 2,
                "hour": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
            },
            {
                "week": 3,
                "hour": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
            },
            {
                "week": 4,
                "hour": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
            },
            {
                "week": 5,
                "hour": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
            },
            {
                "week": 6,
                "hour": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
            },
            {
                "week": 7,
                "hour": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
            }
        ]
    }
]'

返回结果

{
  "errno": 0,
  "errmsg": "OK",
  "data": [
    {
      "errno": 2000000,
      "id": 3907501127,
      "name": "新建一个推广计划"
    }
  ]
}

返回结果说明

字段	类型	描述
errno	int	错误码参见errorCode.md
id	string	新增的推广计划的id
name	string	新增的推广计划的ID对应的名称

results matching ""

No results matching ""