/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"
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | sid | sid 和 profileId 必传一个 | number | — | Required | sid 和 profileId 必传一个 |
| 2 | profileId | sid 和 profileId 必传一个 | integer | — | Optional | sid 和 profileId 必传一个 |
| 3 | campaigns | 广告活动列表 | array<object> | — | Required | 广告活动列表 |
| 3.1 | campaignId | 广告活动id | number | — | Required | 广告活动id |
| 3.2 | state | 有效状态 | string | — | Optional | 有效状态:enabled-启用 paused-暂停 |
| 3.3 | budget | 预算对象 | object | — | Optional | 预算对象 |
| 3.3.1 | budgetType | 预算类型 固定传daily | string | — | Optional | 预算类型 固定传daily |
| 3.3.2 | budget | 预算金额 | number | — | Optional | 预算金额 |
| 3.4 | isBaseValue | 是否调整基准值 | number | — | Required | 是否调整基准值:1-是 0-否 |
| 3.5 | baseType | 调整基准值类型 | string | — | Optional | 调整基准值类型:1-固定值 2-系统反推 |
| 3.6 | baseValue | 固定值时传 基准值 | string | — | Optional | 固定值时传 基准值 |
| 3.7 | isBasePlacementAll | 是否同步更新分时策略广告位基准值 | number | — | Optional | 是否同步更新分时策略广告位基准值:1-是 0或不传-不调整 |
| 3.8 | dynamicBidding | 广告位竞价配置 | object | — | Optional | 广告位竞价配置 |
| 3.8.1 | strategy | 竞价策略 | string | — | Optional | 竞价策略:AUTO_FOR_SALES-动态竞价-提高和降低 LEGACY_FOR_SALES-动态竞价-只降低 MANUAL-固定竞价 |
| 3.8.2 | placementBidding | 广告位相关参数 | array<object> | — | Optional | 广告位相关参数 |
| 3.8.2.1 | placement | 广告位 | string | — | Optional | 广告位:PLACEMENT_PRODUCT_PAGE-商品页面 PLACEMENT_TOP-搜索结果顶部(首页) PLACEMENT_REST_OF_SEARCH-搜索结果的其余位置 SITE_AMAZON_BUSINESS-亚马逊企业购 |
| 3.8.2.2 | percentage | 广告位百分比 | number | — | Optional | 广告位百分比 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | code | number | 1 | Required | |
| 2 | success | success | boolean | true | Required | |
| 3 | data | data | object | — | Required | |
| 3.1 | apiResult | apiResult | array<object> | 详见返回成功示例 | Required | |
| 3.1.1 | code | SUCCESS 成功 其他为失败 | string | SUCCESS | Required | SUCCESS 成功 其他为失败 |
| 3.1.2 | campaignId | 成功时返回 广告活动id | string | 468467189609276 | Optional | 成功时返回 广告活动id |
| 3.1.3 | description | 不成功时返回错误的原因 | string | — | Optional | 不成功时返回错误的原因 |
| 4 | message | message | string | success | Required | |
| 5 | request_id | 链路id | string | f0763238_fed4_4f06_ae05_0f864e1c78b2 | Required | 链路id |
| 6 | response_time | 响应时间 | string | — | Required | 响应时间 |
| 7 | error_details | 错误信息 | array<any> | — | Required | 错误信息 |
The 修改SP广告活动和广告位 API (/basicOpen/adReport/manage/putSpCampaign) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.