/basicOpen/adReport/manage/putSpCampaign{
"operation": {
"method": "POST",
"path": "/basicOpen/adReport/manage/putSpCampaign"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/putSpCampaign?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"sid\": 9090,\n \"campaigns\": [\n {\n \"campaignId\": 414070570476640,\n \"isBaseValue\": 0,\n \"isBasePlacementAll\": 1,\n \"dynamicBidding\": {\n \"strategy\": \"LEGACY_FOR_SALES\",\n \"placementBidding\": [\n {\n \"placement\": \"PLACEMENT_PRODUCT_PAGE\",\n \"percentage\": 38\n },\n {\n \"placement\": \"PLACEMENT_TOP\",\n \"percentage\": 25\n },\n {\n \"placement\": \"PLACEMENT_REST_OF_SEARCH\",\n \"percentage\": 15\n },\n {\n \"placement\": \"SITE_AMAZON_BUSINESS\",\n \"percentage\": 10\n }\n ]\n }\n }\n ]\n}'",
"responseExample": {
"code": 1,
"success": true,
"data": {
"apiResult": [
{
"code": "SUCCESS",
"campaignId": "468467189609276"
},
{
"code": "SUCCESS",
"campaignId": "67532229161080"
},
{
"code": "SUCCESS",
"campaignId": "393233412099415"
},
{
"code": "entityStateError",
"description": "Archived entity cannot be modified"
}
]
},
"message": "success",
"request_id": "ed914dcf_fe5a_4ec3_8e92_c72f1dd95081",
"response_time": "2025-05-21 00:00:00"
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | sid | sid 和 profileId 必传一个 | number | — | 必填 | sid 和 profileId 必传一个 |
| 2 | profileId | sid 和 profileId 必传一个 | integer | — | 可选 | sid 和 profileId 必传一个 |
| 3 | campaigns | 广告活动列表 | array<object> | — | 必填 | 广告活动列表 |
| 3.1 | campaignId | 广告活动id | number | — | 必填 | 广告活动id |
| 3.2 | state | 有效状态 | string | — | 可选 | 有效状态:enabled-启用 paused-暂停 |
| 3.3 | budget | 预算对象 | object | — | 可选 | 预算对象 |
| 3.3.1 | budgetType | 预算类型 固定传daily | string | — | 可选 | 预算类型 固定传daily |
| 3.3.2 | budget | 预算金额 | number | — | 可选 | 预算金额 |
| 3.4 | isBaseValue | 是否调整基准值 | number | — | 必填 | 是否调整基准值:1-是 0-否 |
| 3.5 | baseType | 调整基准值类型 | string | — | 可选 | 调整基准值类型:1-固定值 2-系统反推 |
| 3.6 | baseValue | 固定值时传 基准值 | string | — | 可选 | 固定值时传 基准值 |
| 3.7 | isBasePlacementAll | 是否同步更新分时策略广告位基准值 | number | — | 可选 | 是否同步更新分时策略广告位基准值:1-是 0或不传-不调整 |
| 3.8 | dynamicBidding | 广告位竞价配置 | object | — | 可选 | 广告位竞价配置 |
| 3.8.1 | strategy | 竞价策略 | string | — | 可选 | 竞价策略:AUTO_FOR_SALES-动态竞价-提高和降低 LEGACY_FOR_SALES-动态竞价-只降低 MANUAL-固定竞价 |
| 3.8.2 | placementBidding | 广告位相关参数 | array<object> | — | 可选 | 广告位相关参数 |
| 3.8.2.1 | placement | 广告位 | string | — | 可选 | 广告位:PLACEMENT_PRODUCT_PAGE-商品页面 PLACEMENT_TOP-搜索结果顶部(首页) PLACEMENT_REST_OF_SEARCH-搜索结果的其余位置 SITE_AMAZON_BUSINESS-亚马逊企业购 |
| 3.8.2.2 | percentage | 广告位百分比 | number | — | 可选 | 广告位百分比 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | code | number | 1 | 必填 | |
| 2 | success | success | boolean | true | 必填 | |
| 3 | data | data | object | — | 必填 | |
| 3.1 | apiResult | apiResult | array<object> | 详见返回成功示例 | 必填 | |
| 3.1.1 | code | SUCCESS 成功 其他为失败 | string | SUCCESS | 必填 | SUCCESS 成功 其他为失败 |
| 3.1.2 | campaignId | 成功时返回 广告活动id | string | 468467189609276 | 可选 | 成功时返回 广告活动id |
| 3.1.3 | description | 不成功时返回错误的原因 | string | — | 可选 | 不成功时返回错误的原因 |
| 4 | message | message | string | success | 必填 | |
| 5 | request_id | 链路id | string | f0763238_fed4_4f06_ae05_0f864e1c78b2 | 必填 | 链路id |
| 6 | response_time | 响应时间 | string | — | 必填 | 响应时间 |
| 7 | error_details | 错误信息 | array<any> | — | 必填 | 错误信息 |
领星ERP的接口:修改SP广告活动和广告位(/basicOpen/adReport/manage/putSpCampaign),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。