- Auth
- Accounts
- First call
- Reporting
- DSP report
- Sponsored ads V3
- Sponsored ads V2
- Snapshots
- Test accounts
- Amazon Marketing Stream
- Amazon Marketing Cloud
- Administration
- Accounts
- Instances
- Create an instance
- List all instances
- List information about the requested instance
- Update instance details
- Update AWS account metadata in the requested instance
- List advertisers in instance
- Create advertiser update
- Get advertiser update
- Gets advertiser information about the requested AMC instance
- Delete AMC instance
- Reporting
- AMC Audiences
- Rule-based audiences
- Creates query based audience execution metadata information
- Get all query based audiences execution metadata.
- Get query based audience execution metadata for a given audienceExecutionId.
- Update query based audience execution metadata for a given audienceExecutionId.
- Delete query based audience execution metadata for a given audienceExecutionId.
- Lookalike audiences
- Rule-based audiences
- Administration
- Sponsored Products
- Sponsored Brands
- Campaigns
- Ad groups
- Ads
- Targeting
- Recommendations
- Theme targeting
- Create keywords
- Update keyword
- Get keyword
- Delete keyword
- Create negative keywords
- Update negative keyword
- Get negative keyword
- Delete negative keyword
- Create product targets
- Update a product target
- Get product target
- Delete product target
- Create negative product target
- Update negative product target
- Get negative product target
- Delete negative product target
- Get all categories
- Get category refinements
- Ad creatives
- Get brandsGET
- Get landing page ASINSGET
- Sponsored Display
- Stores
- Product metadata
- Budget rules
- Budget usage
- Creative asset library
- Locations
- Exports
- Sponsored TV
- Amazon DSP
- Partner opportunities
Create store spotlight ad
POST
/sb/v4/ads/storeSpotlight
最后修改时间：2025-03-16 02:19:30
责任人：未设置
请求参数
Header 参数
Amazon-Advertising-API-ClientId
string
必需
示例值:
{{client_id}}
Authorization
string
必需
示例值:
Bearer {{access_token}}
Amazon-Advertising-API-Scope
string
必需
示例值:
{{profileId}}
Accept
string
必需
示例值:
application/vnd.sbadresource.v4+json
Body 参数application/json
ads
array [object {5}]
必需
landingPage
object
可选
name
string
可选
state
string
可选
adGroupId
string
可选
creative
object
可选
示例
{
"ads": [
{
"landingPage": {
"url": "https://www.amazon.com/stores/page/0064AC34-18F6-4CD3-849F-531E7C5AE8D6"
},
"name": "Name for store spotlight",
"state": "ENABLED",
"adGroupId": "{{adGroupId}}",
"creative": {
"brandName": "My brand name",
"subpages": [
{
"pageTitle": "Savannah",
"asin": "B08MV395Y1",
"url": "https://www.amazon.com/stores/page/2B2AE9C7-7EF4-4993-AA76-0FFF7EF7D050"
},
{
"pageTitle": "Miami",
"asin": "B08VGX1BXG",
"url": "https://www.amazon.com/stores/page/E411CCC7-B125-4076-A476-197441A2A23E"
},
{
"pageTitle": "San Fran",
"asin": "B08VGYL7BM",
"url": "https://www.amazon.com/stores/page/BE713C9E-F85F-4461-B42A-29740F5B61F5"
}
],
"brandLogoAssetID": "amzn1.assetlibrary.asset1.xxxxxx",
"headline": "Cheap pants"
}
}
]
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://www.amazon.com/ap/oa/sb/v4/ads/storeSpotlight' \
--header 'Amazon-Advertising-API-ClientId: {{client_id}}' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Amazon-Advertising-API-Scope: {{profileId}}' \
--header 'Accept: application/vnd.sbadresource.v4+json' \
--header 'Content-Type: application/json' \
--data-raw '{
"ads": [
{
"landingPage": {
"url": "https://www.amazon.com/stores/page/0064AC34-18F6-4CD3-849F-531E7C5AE8D6"
},
"name": "Name for store spotlight",
"state": "ENABLED",
"adGroupId": "{{adGroupId}}",
"creative": {
"brandName": "My brand name",
"subpages": [
{
"pageTitle": "Savannah",
"asin": "B08MV395Y1",
"url": "https://www.amazon.com/stores/page/2B2AE9C7-7EF4-4993-AA76-0FFF7EF7D050"
},
{
"pageTitle": "Miami",
"asin": "B08VGX1BXG",
"url": "https://www.amazon.com/stores/page/E411CCC7-B125-4076-A476-197441A2A23E"
},
{
"pageTitle": "San Fran",
"asin": "B08VGYL7BM",
"url": "https://www.amazon.com/stores/page/BE713C9E-F85F-4461-B42A-29740F5B61F5"
}
],
"brandLogoAssetID": "amzn1.assetlibrary.asset1.xxxxxx",
"headline": "Cheap pants"
}
}
]
}'返回响应
🟢207Success
application/json
Body
ads
object
必需
error
array
必需
success
array [object {3}]
必需
示例
{
"ads": {
"error": [],
"success": [
{
"ad": {
"adGroupId": "72598658504351",
"adId": "185980120883864",
"campaignId": "203755086457166",
"creative": {
"brandLogoAssetID": "amzn1.assetlibrary.asset1.xxxxxxx:version_v1",
"brandName": "My store",
"headline": "Cheap pants",
"subpages": [
{
"asin": "B08MV395Y1",
"pageTitle": "Savannah",
"url": "https://www.amazon.com/stores/page/xxxxxxxxx"
},
{
"asin": "B08VGX1BXG",
"pageTitle": "Miami",
"url": "https://www.amazon.com/stores/page/xxxxxxxx"
},
{
"asin": "B08VGYL7BM",
"pageTitle": "San Fran",
"url": "https://www.amazon.com/stores/page/xxxxxxxx"
}
],
"type": "STORE_SPOTLIGHT"
},
"extendedData": {
"creationDate": 1678812501793,
"lastUpdateDate": 1678812502131,
"servingStatus": "AD_POLICING_PENDING_REVIEW"
},
"landingPage": {
"pageType": "STORE",
"url": "https://www.amazon.com/stores/page/xxxxxx"
},
"name": "test landing store",
"state": "ENABLED"
},
"adId": "185980120883864",
"index": 0
}
]
}
}修改于 2025-03-16 02:19:30