- Auth
- Accounts
- First call
- Reporting
- DSP report
- Sponsored ads V3
- Sponsored ads V2
- Snapshots
- Sponsored Products
- Sponsored Display
- Sponsored Brands
- 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 informationPOST
- Get all query based audiences execution metadata.GET
- Get query based audience execution metadata for a given audienceExecutionId.GET
- Update query based audience execution metadata for a given audienceExecutionId.PUT
- Delete query based audience execution metadata for a given audienceExecutionId.DELETE
- Lookalike audiences
- 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 brands
- Get landing page ASINS
- Sponsored Display
- Stores
- Product metadata
- Budget rules
- Budget usage
- Creative asset library
- Locations
- Exports
- Sponsored TV
- Amazon DSP
- Partner opportunities
Creates query based audience execution metadata information
POST
/amc/audiences/query
最后修改时间：2025-03-16 02:19:30
责任人：未设置
请求参数
Header 参数
Amazon-Advertising-API-ClientId
string
必需
示例值:
{{client_id}}
Amazon-Advertising-API-EntityId
string
必需
GET method on amc/accounts to fetch the AMC Account ID/Entity ID.示例值:
{{advertiser_id}}
Amazon-Marketing-Cloud-Audience-InstanceId
string
必需
示例值:
{{instanceId}}
Authorization
string
必需
示例值:
Bearer {{access_token}}
Body 参数application/json
audienceName
string
必需
audienceDescription
string
必需
advertiserId
string
必需
advertiserType
string
必需
query
string
必需
timeWindowStart
string
必需
timeWindowEnd
string
必需
refreshRateDays
integer
必需
timeWindowRelative
string
必需
示例
{
"audienceName": "AudienceDemo",
"audienceDescription": "Audience created for Audience Demo",
"advertiserId": "11111111",
"advertiserType": "xxxxxx",
"query": "SELECT user_id FROM amazon_attributed_events_by_conversion_time_for_audiences WHERE conversion_event_subtype = 'shoppingCart'",
"timeWindowStart": "2024-05-25T00:00:00Z",
"timeWindowEnd": "2024-05-27T01:00:00Z",
"refreshRateDays": 1,
"timeWindowRelative": "TRUE"
}示例代码
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/amc/audiences/query' \
--header 'Amazon-Advertising-API-ClientId: {{client_id}}' \
--header 'Amazon-Advertising-API-EntityId: {{advertiser_id}}' \
--header 'Amazon-Marketing-Cloud-Audience-InstanceId: {{instanceId}}' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"audienceName": "AudienceDemo",
"audienceDescription": "Audience created for Audience Demo",
"advertiserId": "11111111",
"advertiserType": "xxxxxx",
"query": "SELECT user_id FROM amazon_attributed_events_by_conversion_time_for_audiences WHERE conversion_event_subtype = '\''shoppingCart'\''",
"timeWindowStart": "2024-05-25T00:00:00Z",
"timeWindowEnd": "2024-05-27T01:00:00Z",
"refreshRateDays": 1,
"timeWindowRelative": "TRUE"
}'返回响应
🟢200Creates query based audience execution metadata information (Sponsored Ads).
text/plain
Body
audienceExecutionDescription
string
必需
audienceExecutionId
string
必需
status
string
必需
示例
{"audienceExecutionDescription":"Successfully started audience creation workflow.","audienceExecutionId":"7ad8521c-ddd1-42b7-9172-e3b8ad93dc5a","status":"PENDING"}🟢200Creates query based audience execution metadata information (DSP)
修改于 2025-03-16 02:19:30