创建 SP 广告活动
POST
/basicOpen/adReport/manage/postSpCampaign接口信息
| API Path | 请求协议 | 请求方式 | 令牌桶容量 |
|---|---|---|---|
/basicOpen/adReport/manage/postSpCampaign | HTTPS | POST | 1 |
请求参数
profileIdstring必填campaignsarray<object>必填隐藏子属性
adProductstring必填autoCreationSettingsobject必填隐藏子属性
autoCreateTargetsboolean必填autoManageCampaignbooleanbudgetsarray<object>必填隐藏子属性
budgetTypestring必填budgetValueobject必填隐藏子属性
monetaryBudgetValueobject必填隐藏子属性
monetaryBudgetobject必填隐藏子属性
valuenumberrecurrenceTimePeriodstring必填countriesarray<any>endDateTimestringmarketplaceScopestring必填marketplacesarray<any>必填namestring必填optimizationsobject隐藏子属性
bidSettingsobject隐藏子属性
bidAdjustmentsobject隐藏子属性
audienceBidAdjustmentsarray<object>隐藏子属性
audienceIdstring必填percentageinteger必填creativeBidAdjustmentsarray<object>隐藏子属性
creativeTypestringpercentageinteger必填placementBidAdjustmentsarray<object>隐藏子属性
percentageinteger必填placementstring必填bidStrategystringbudgetSettingsobject隐藏子属性
offAmazonBudgetControlStrategystringportfolioIdstringsiteRestrictionsarray<any>startDateTimestring必填statestring必填请求cURL示例
curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSpCampaign?access_token=value×tamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
"profileId": "1234567890123456",
"campaigns": [
{
"adProduct": "SPONSORED_PRODUCTS",
"autoCreationSettings": {
"autoCreateTargets": false
},
"budgets": [
{
"budgetType": "MONETARY",
"budgetValue": {
"monetaryBudgetValue": {
"monetaryBudget": {
"value": 1
}
}
},
"recurrenceTimePeriod": "DAILY"
}
],
"marketplaceScope": "SINGLE_MARKETPLACE",
"name": "示例广告",
"startDateTime": "2026-10-20T00:00:00Z",
"state": "PAUSED",
"marketplaces": [
"US"
]
}
]
}'
返回结果
Json Object
codeinteger必填messagestring必填error_detailsarray<any>必填request_idstring必填response_timestring必填dataobject必填隐藏子属性
apiResultarray<object>必填隐藏子属性
codestring必填indexinteger必填adProductstring必填autoCreationSettingsobject必填隐藏子属性
autoCreateTargetsboolean必填autoScaleGlobalCampaignstring必填budgetsarray<object>必填隐藏子属性
budgetTypestring必填budgetValueobject必填隐藏子属性
monetaryBudgetValueobject必填隐藏子属性
monetaryBudgetobject必填隐藏子属性
currencyCodestring必填valuenumber必填recurrenceTimePeriodstring必填campaignIdstring必填countriesarray<any>必填creationDateTimestring必填lastUpdatedDateTimestring必填marketplaceScopestring必填marketplacesarray<any>必填namestring必填optimizationsobject必填隐藏子属性
bidSettingsobject必填隐藏子属性
bidAdjustmentsobject必填隐藏子属性
audienceBidAdjustmentsarray<object>必填隐藏子属性
audienceIdstring必填percentageinteger必填placementBidAdjustmentsarray<object>必填隐藏子属性
percentageinteger必填placementstring必填bidStrategystring必填budgetSettingsobject必填隐藏子属性
marketplaceBudgetAllocationstring必填offAmazonBudgetControlStrategystring必填startDateTimestring必填statestring必填totalinteger必填返回成功示例
{
"code": 0,
"message": "success",
"error_details": [],
"request_id": "example-request-id",
"response_time": "2026-10-19 12:00:00",
"data": {
"apiResult": [
{
"code": "SUCCESS",
"index": 0,
"adProduct": "SPONSORED_PRODUCTS",
"autoCreationSettings": {
"autoCreateTargets": false
},
"autoScaleGlobalCampaign": "AUTO",
"budgets": [
{
"budgetType": "MONETARY",
"budgetValue": {
"monetaryBudgetValue": {
"monetaryBudget": {
"currencyCode": "USD",
"value": 1
}
}
},
"recurrenceTimePeriod": "DAILY"
}
],
"campaignId": "1234567890123456",
"countries": [
"US"
],
"creationDateTime": "2026-10-20T00:00:00Z",
"lastUpdatedDateTime": "2026-10-20T00:00:00Z",
"marketplaceScope": "SINGLE_MARKETPLACE",
"marketplaces": [
"US"
],
"name": "示例广告",
"optimizations": {
"bidSettings": {
"bidAdjustments": {
"audienceBidAdjustments": [
{
"audienceId": "example",
"percentage": 1
}
],
"placementBidAdjustments": [
{
"percentage": 1,
"placement": "TOP_OF_SEARCH"
}
]
},
"bidStrategy": "MANUAL"
},
"budgetSettings": {
"marketplaceBudgetAllocation": "AUTO",
"offAmazonBudgetControlStrategy": "MAXIMIZE_REACH"
}
},
"startDateTime": "2026-10-20T00:00:00Z",
"state": "PAUSED"
}
]
},
"total": 0
}
附加说明
- profileId 必须属于当前授权企业。标识使用字符串传递,避免长整数精度丢失。
- 在 Query 中传入 access_token、app_key、timestamp、sign。修改请求体或鉴权参数后须重新计算签名,签名传输时只进行一次 URL 编码。
- 先检查顶层 code,再逐项检查 data.apiResult[].code。顶层成功不代表每项均创建成功;index 是请求数组中从0开始的原始下标。
- 示例仅说明数据结构,不是经过真实创建验证的返回。调用前替换标识及投放配置;字段说明中的源接口样本信息来自上游接口定义。
- 返回字段表描述创建成功项,实际字段取决于创意类型及上游返回,失败项可能只包含结果码和下标。
- 预算及竞价调整比例须非负,结束时间不得早于开始时间;开始日期和站点须满足亚马逊要求。