Lingxing
切换旧版

创建 SD 广告活动

POST/basicOpen/adReport/manage/postSdCampaign

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/adReport/manage/postSdCampaignHTTPSPOST1

请求参数

profileIdstring必填
必须属于当前授权企业的广告店铺唯一标识;使用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。
campaignsarray<object>必填
待创建的展示型推广活动列表;每次提交 1~100 个活动。
最少1项
最多100项
隐藏子属性
adProductstring必填
SPONSORED_DISPLAY 表示展示型推广广告。
budgetsarray<object>必填
活动的货币预算列表,须且仅包含一项预算。创建时传预算类型和预算值,响应中另有预算周期。
最少1项
隐藏子属性
budgetTypestring必填
MONETARY 表示货币金额预算。
budgetValueobject必填
货币预算值的类型包装对象。
隐藏子属性
monetaryBudgetValueobject必填
货币预算金额的包装对象。
隐藏子属性
monetaryBudgetobject必填
以广告店铺对应币种计价的预算金额;创建时不传币种字段。
隐藏子属性
valuenumber必填
以广告店铺对应币种计价的预算金额。结合本次响应的美元币种及每日周期,示例表示每日预算为 2 美元。
costTypestring必填
CPC=按点击计费
VCPM=按千次可见展示计费。
countriesarray<any>
活动投放范围的国家代码列表,最多一个国家
US 表示美国。
endDateTimestring
广告活动结束时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。当前外部接口要求不早于开始时间。
marketplaceScopestring必填
SINGLE_MARKETPLACE 表示单站点广告活动。
marketplacesarray<any>必填
活动投放的亚马逊零售站点代码列表,须匹配广告店铺的授权站点
US 表示美国站。
最少1项
namestring必填
用于识别和管理广告活动的名称。
portfolioIdstring
活动所属广告组合的唯一标识,可不传或传空字符串;有值时须为正整数字符串。
startDateTimestring必填
活动计划开始投放的时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。实际创建时应使用符合亚马逊要求的开始日期。
statestring必填
ENABLED=已启用
PAUSED=已暂停。已启用仍需满足开始时间及其他投放条件。

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSdCampaign?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "profileId": "1234567890123456",
    "campaigns": [
        {
            "adProduct": "SPONSORED_DISPLAY",
            "budgets": [
                {
                    "budgetType": "MONETARY",
                    "budgetValue": {
                        "monetaryBudgetValue": {
                            "monetaryBudget": {
                                "value": 1
                            }
                        }
                    }
                }
            ],
            "costType": "CPC",
            "marketplaceScope": "SINGLE_MARKETPLACE",
            "name": "示例广告",
            "startDateTime": "2026-10-20T00:00:00Z",
            "state": "PAUSED",
            "marketplaces": [
                "US"
            ]
        }
    ]
}'

返回结果

Json Object

codeinteger必填
平台业务状态码,0 表示成功
示例 0
messagestring必填
响应消息
示例 success
error_detailsarray<any>必填
参数校验等错误详情
示例 []
request_idstring必填
请求链路标识
示例 example-request-id
response_timestring必填
响应时间
示例 2026-10-19 12:00:00
dataobject必填
响应数据。
隐藏子属性
apiResultarray<object>必填
每项结果通过原始下标对应请求中的活动;应检查每项结果码,批量或工具调用可能包含失败项。
隐藏子属性
adProductstring必填
SPONSORED_DISPLAY 表示展示型推广广告。
budgetsarray<object>必填
活动的货币预算列表,须且仅包含一项预算。创建时传预算类型和预算值,响应中另有预算周期。
隐藏子属性
budgetTypestring必填
MONETARY 表示货币金额预算。
budgetValueobject必填
货币预算值的类型包装对象。
隐藏子属性
monetaryBudgetValueobject必填
货币预算金额的包装对象。
隐藏子属性
monetaryBudgetobject必填
响应中的预算金额及其币种。
隐藏子属性
currencyCodestring必填
AED=阿联酋迪拉姆
AUD=澳大利亚元
BRL=巴西雷亚尔
CAD=加拿大元
CHF=瑞士法郎
CNY=人民币
DKK=丹麦克朗
EGP=埃及镑
EUR=欧元
GBP=英镑
INR=印度卢比
JPY=日元
MXN=墨西哥比索
MXP=墨西哥比索
NGN=尼日利亚奈拉
NOK=挪威克朗
NZD=新西兰元
PLN=波兰兹罗提
SAR=沙特里亚尔
SEK=瑞典克朗
SGD=新加坡元
TRY=土耳其里拉
USD=美元
ZAR=南非兰特。
valuenumber必填
以广告店铺对应币种计价的预算金额。结合本次响应的美元币种及每日周期,示例表示每日预算为 2 美元。
recurrenceTimePeriodstring必填
DAILY 表示每日预算;该字段出现在展示型推广活动的预算响应中,官方创建预算对象未定义此字段。
campaignIdstring必填
亚马逊创建成功后生成的活动唯一标识;以字符串保存,避免长整数精度丢失。
costTypestring必填
CPC=按点击计费
VCPM=按千次可见展示计费。
countriesarray<any>必填
活动投放范围的国家代码列表,最多一个国家
US 表示美国。
creationDateTimestring必填
亚马逊记录的活动创建时间;末尾 Z 表示协调世界时。
endDateTimestring必填
广告活动结束时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。当前外部接口要求不早于开始时间。
lastUpdatedDateTimestring必填
亚马逊记录的活动最后更新时间;末尾 Z 表示协调世界时。
marketplaceScopestring必填
SINGLE_MARKETPLACE 表示单站点广告活动。
marketplacesarray<any>必填
活动投放的亚马逊零售站点代码列表,须匹配广告店铺的授权站点
US 表示美国站。
namestring必填
用于识别和管理广告活动的名称。
startDateTimestring必填
活动计划开始投放的时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。实际创建时应使用符合亚马逊要求的开始日期。
statestring必填
ENABLED=已启用
PAUSED=已暂停
ARCHIVED=已永久归档且不可重新启用。
codestring必填
SUCCESS 表示当前广告活动创建成功。
示例 SUCCESS
indexinteger必填
对应请求活动数组中的原始下标,从 0 开始。
totalinteger必填
统一响应中的总数,本创建接口未设置分页总数,默认为0
示例 0

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "example-request-id",
    "response_time": "2026-10-19 12:00:00",
    "data": {
        "apiResult": [
            {
                "adProduct": "SPONSORED_DISPLAY",
                "budgets": [
                    {
                        "budgetType": "MONETARY",
                        "budgetValue": {
                            "monetaryBudgetValue": {
                                "monetaryBudget": {
                                    "currencyCode": "USD",
                                    "value": 1
                                }
                            }
                        },
                        "recurrenceTimePeriod": "DAILY"
                    }
                ],
                "campaignId": "1234567890123456",
                "costType": "CPC",
                "countries": [
                    "US"
                ],
                "creationDateTime": "2026-10-20T00:00:00Z",
                "endDateTime": "2026-10-20T00:00:00Z",
                "lastUpdatedDateTime": "2026-10-20T00:00:00Z",
                "marketplaceScope": "SINGLE_MARKETPLACE",
                "marketplaces": [
                    "US"
                ],
                "name": "示例广告",
                "startDateTime": "2026-10-20T00:00:00Z",
                "state": "PAUSED",
                "code": "SUCCESS",
                "index": 0
            }
        ]
    },
    "total": 0
}

附加说明

  • profileId 必须属于当前授权企业。标识使用字符串传递,避免长整数精度丢失。
  • 在 Query 中传入 access_token、app_key、timestamp、sign。修改请求体或鉴权参数后须重新计算签名,签名传输时只进行一次 URL 编码。
  • 先检查顶层 code,再逐项检查 data.apiResult[].code。顶层成功不代表每项均创建成功;index 是请求数组中从0开始的原始下标。
  • 示例仅说明数据结构,不是经过真实创建验证的返回。调用前替换标识及投放配置;字段说明中的源接口样本信息来自上游接口定义。
  • 返回字段表描述创建成功项,实际字段取决于创意类型及上游返回,失败项可能只包含结果码和下标。
  • 预算及竞价调整比例须非负,结束时间不得早于开始时间;开始日期和站点须满足亚马逊要求。