/pb/openapi/newad/spCampaigns{
"operation": {
"method": "POST",
"path": "/pb/openapi/newad/spCampaigns"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 10,
"text": ""
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | sid | 店铺id | integer | — | 必填 | 店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 2 | profile_id | VC广告店铺profile_id | integer | — | 必填 | VC广告店铺profile_id,对应查询广告账号列表接口对应字段【profile_id】,sid跟profile_id其中一个必填 |
| 3 | state | 状态 | string | — | 可选 | 状态:【不传默认为所有】 enabled paused archived |
| 4 | offset | 分页偏移量 | integer | — | 可选 | 分页偏移量,默认0 |
| 5 | length | 分页长度 | integer | — | 可选 | 分页长度,默认15 |
| 6 | next_token | 分页游标 | string | — | 可选 | 分页游标,上次分页结果中的next_token (第一次分页无需填写,当next_token 和 offset同时存在时以next_token为主 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0 成功 |
| 2 | message | 提示消息 | string | 操作成功 | 必填 | 提示消息 |
| 3 | error_details | 错误信息 | array<any> | — | 必填 | 错误信息 |
| 4 | request_id | 请求链路id | string | nd8492d4-7a15-11ed-b162-0242ac1c0004 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2022-11-03 14:09:15 | 必填 | 响应时间 |
| 6 | total | 总数 | integer | 1 | 必填 | 总数 |
| 7 | next_token | 分页游标 | string | "ODAwMDAwMDAwMDAwMDAyNDE3" | 必填 | 分页游标,填入下次请求中的next_token |
| 8 | data | 响应数据 | array<object> | — | 必填 | 响应数据 |
| 8.1 | campaign_id | 广告活动id | number | 1711935301143 | 必填 | 广告活动id |
| 8.2 | lastOverBudgetAt | 超预算时间 | string | 2026-10-08 12:34:56 | 必填 | 超预算时间 |
| 8.3 | profile_id | 亚马逊店铺数字id | number | 121923590660074 | 必填 | 亚马逊店铺数字id |
| 8.4 | name | 广告活动名称 | string | PVC Pouch-Label (A4/20P)_auto_20210810 | 必填 | 广告活动名称 |
| 8.5 | campaign_type | 广告活动类型 | string | sponsoredProducts | 必填 | 广告活动类型 |
| 8.6 | targeting_type | 投放类型 | string | auto | 必填 | 投放类型 |
| 8.7 | premium_bid_adjustment | 溢价报价调整 | number | 1 | 必填 | 溢价报价调整 |
| 8.8 | daily_budget | 每日预算 | number | 10 | 必填 | 每日预算 |
| 8.9 | start_date | 起始日期 | string | 2021-08-09 00:00:00 | 必填 | 起始日期 |
| 8.10 | end_date | 结束日期 | string | 2021-08-09 00:00:00 | 必填 | 结束日期 |
| 8.11 | creation_date | 创建日期 | number | 1628567183000 | 必填 | 创建日期 |
| 8.12 | last_updated_date | 最后更新时间 | number | 1632985461000 | 必填 | 最后更新时间 |
| 8.13 | state | 状态 | string | enabled | 必填 | 状态 |
| 8.14 | serving_status | 服务状态 | string | CAMPAIGN_STATUS_ENABLED | 必填 | 服务状态 |
| 8.15 | bidding | 竞价策略【json格式】 | string | {"strategy":"legacyForSales","adjustments":[{"predicate":"placementRestOfSearch","percentage":23},{"predicate":"placementProductPage","percentage":12},{"predicate":"placementTop","percentage":900}],"shopperCohortBidding":[{"percentage":1,"audienceSegments | 必填 | 竞价策略【json格式】 |
| 8.16 | portfolio_id | 广告组合id | number | 935301143 | 必填 | 广告组合id |
| 8.17 | tags | 标签信息 | array<object> | — | 必填 | 标签信息 |
| 8.17.1 | parent | 父标签 | string | t1 | 必填 | 父标签 |
| 8.17.2 | child | 子标签 | string | tttsadw | 必填 | 子标签 |
领星ERP的接口:SP广告活动(/pb/openapi/newad/spCampaigns),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。