快照概述
使用快照高效地检索您的商品推广活动、品牌推广活动和展示型推广活动的结构。快照是异步生成的，可以在多个级别进行请求，包括广告活动、广告组、产品广告、投放目标、关键词等。
快照与报告
报告包含指定日期的效果数据，而快照提供有关请求时刻的广告活动的元数据。换句话说，您可以使用快照检索所有已配置的广告活动、广告组、投放表达式等的元数据，具体取决于广告活动类型。
快照与列表操作
快照返回类似于 GET 和 GET /extended 操作的广告活动、广告组、关键词和其他广告活动实体的信息。快照是异步运行的，而 GET 和 GET /extended 则是同步运行。如果您拥有许多广告活动或复杂的广告活动结构，并且希望获取账户中所有广告活动的信息，我们建议使用快照。
如果您只需要单个广告活动的详细信息，请使用带有查询参数的 GET 请求，而不是快照。
快照示例
快照以 JSON 格式呈现。
此示例显示了一个商品推广快照，其中包含一条单独的投放记录。
[
{
"targetId":1234567890,
"adGroupId":2345678901,
"campaignId":345678901,
"expressionType":"manual",
"state":"enabled",
"bid":1.18,
"expression":[
{
"type":"asinCategorySameAs",
"value":"2475895011"}
],
"resolvedExpression":[
{
"type":"asinCategorySameAs",
"value":"Men's Wallets"
}
]
}
]
按广告类型划分的快照类型
每种广告类型支持的快照类型各不相同。
| 快照类型 |
商品推广 |
品牌推广 |
展示型推广 |
| 广告活动 |
x |
x |
x |
| adGroups |
x |
|
x |
| keywords |
x |
x |
|
| negativeKeywords |
x |
|
|
| campaignNegativeKeywords |
x |
|
|
| productAds |
x |
|
x |
| targets |
x |
|
x |
| negativeTargets |
x |
|
|
按广告类型和快照类型划分的字段
不同广告类型的快照包含不同的字段。以下各段落中的表中列出了每种类型的快照中包含的字段。
商品推广
广告活动
| 字段 |
描述 |
| campaignId |
广告活动的编号。可用于联接报告数据。 |
| name |
广告主指定的广告活动名称。 |
| campaignType |
与广告活动相关的广告类型。始终设为 sponsoredProducts。 |
| targetingType |
广告活动使用的投放类型，该值分别为 manual 或 auto。 |
| premiumBidAdjustment |
布尔值，用于表示广告活动是否已开启高级竞价调整。 |
| dailyBudget |
广告主设置的广告活动的每日预算。 |
| startDate |
广告活动的开始日期。 |
| state |
广告活动的状态 (enabled、paused 或 archived)。 |
| 竞价方案 |
竞价方案，该值分别为 legacyForSales、autoForSales 或 manual。 |
| bidding.adjustments.predicate |
采用竞价控制的广告位，该值分别为 placementTop 或 placementProductPage。 |
| bidding.adjustments.percentage |
竞价调整百分比值。 |
广告组
| 字段 |
描述 |
| adGroupId |
广告组的编号。可用于联接报告数据。 |
| name |
广告主指定的广告组名称。 |
| campaignId |
广告活动的编号。 |
| defaultBid |
广告组的默认竞价。 |
| state |
广告组的状态 (enabled、paused 或 archived)。 |
关键词
注意
如果您的商品推广活动使用自动投放，请确保请求 keywords 和 targets 快照，进而确保获取所有广告活动投放结构。
| 字段 |
描述 |
| keywordId |
关键字的编号。可用于联接报告数据。 |
| adGroupId |
广告主指定的广告组名称。 |
| campaignId |
广告活动的编号。 |
| keywordText |
关键词的确切文本。 |
| matchType |
值为 broad、exact 或 phrase 其中之一。 |
| state |
关键词的状态 (enabled、paused 或 archived)。 |
| bid |
关键词的竞价。 |
否定关键词
| 字段 |
描述 |
| keywordId |
广告组的编号。可用于联接报告数据。 |
| adGroupId |
广告主指定的广告组名称。 |
| campaignId |
广告活动的编号。 |
| keywordText |
否定关键词的文本。 |
| matchType |
值为 broad、exact 或 phrase 其中之一。 |
| state |
关键词的状态 (enabled、paused 或 archived)。 |
广告活动否定关键词
| 字段 |
描述 |
| keywordId |
广告组的编号。可用于联接报告数据。 |
| campaignId |
广告活动的编号。 |
| keywordText |
否定关键词的文本。 |
| matchType |
值为 broad、exact 或 phrase 其中之一。 |
| state |
关键词的状态 (enabled、paused 或 archived)。 |
产品广告
| 字段 |
描述 |
| adId |
广告的编号。可用于联接报告数据。 |
| adGroupId |
广告组的编号。 |
| campaignId |
广告活动的编号。 |
| asin |
与广告关联的 ASIN。 |
| sku |
与广告关联的商品 SKU。仅适用于卖家账户。 |
| state |
广告的状态 (enabled、paused 或 archived)。 |
投放内容
注意
如果您的商品推广活动使用自动投放，请确保请求 keywords 和 targets 快照，进而确保获取所有广告活动投放结构。
| 字段 |
描述 |
| targetId |
投放表达式的编号。可用于联接报告数据 |
| adGroupId |
广告组的编号。 |
| campaignId |
广告活动的编号。 |
| expressionType |
投放方案，manual 或 auto。 |
| state |
投放表达式的状态 (enabled、paused 或 archived)。 |
| bid |
投放表达式的竞价。 |
| expression.type |
投放表达式中使用的运算符。 |
| expression.value |
投放表达式的值。 |
| resolvedExpression.type |
投放表达式中使用的运算符。 |
| resolvedExpression.value |
投放表达式的解析值。 |
否定投放
| 字段 |
描述 |
| targetId |
投放表达式的编号。可用于联接报告数据。 |
| adGroupId |
广告组的编号。 |
| campaignId |
广告活动的编号。 |
| expressionType |
投放方案，manual 或 auto。 |
| state |
投放表达式的状态 (enabled、paused 或 archived)。 |
| expression.type |
投放表达式中使用的运算符。 |
| expression.value |
投放表达式的值。 |
| resolvedExpression.type |
投放表达式中使用的运算符。 |
| resolvedExpression.value |
投放表达式的解析值。 |
品牌推广
警告
目前，广告 API 不支持品牌推广视频广告活动的快照或使用版本 4 接口创建的广告活动的快照。快照包括版本 3的记录，仅限非视频广告活动。
广告活动
| 字段 |
描述 |
| campaignId |
广告活动的编号。可用于联接报告数据。 |
| name |
广告主指定的广告活动名称。 |
| budget |
广告主设置的广告活动的每日预算。 |
| budgetType |
预算的时间段，该值分别为 daily 或 lifetime。 |
| startDate |
广告活动的开始日期。 |
| state |
广告活动的状态 (enabled、paused 或 archived)。 |
| servingStatus |
广告活动的已计算状态。 |
| spendingPolicy |
广告活动的支出策略。 |
| bidOptimization |
用于表示广告活动是否启用了自动竞价优化，该值分别为 true 或 false。 |
| ruleBasedBudget.value |
基于规则的预算的值。 |
| ruleBasedBudget.applicableRuleId |
有效规则的标识符。 |
| ruleBasedBudget.applicableRuleName |
有效规则的名称。 |
| ruleBasedBudget.isProcessing |
如果正在进行规则评估，则设置为 true。评估完成并更新规则预算值后，则设置为 false。 |
关键词
| 字段 |
描述 |
| keywordId |
关键字的编号。可用于联接报告数据。 |
| adGroupId |
广告主指定的广告组名称。 |
| campaignId |
广告活动的编号。 |
| keywordText |
关键词的确切文本。 |
| matchType |
值为BROAD、EXACT 或 PHRASE 其中之一。 |
| state |
关键词的状态 (enabled、paused 或 archived)。 |
| bid |
关键词的竞价。 |
展示型推广
广告活动
| 字段 |
描述 |
| campaignId |
广告活动的编号。可用于联接报告数据。 |
| name |
广告主指定的广告活动名称。 |
| tactic |
广告活动的投放方案，值为 T00020 或 T00030。 |
| budget |
广告主设置的广告活动的预算金额。 |
| budgetType |
预算分配时间段。 |
| startDate |
广告活动的开始日期。 |
| state |
广告活动的状态 (enabled、paused 或 archived)。 |
| costType |
广告活动的计费方式，该值分别为 vCPM（每千次可见展示成本）或 CPC（单次点击成本）。 |
| deliveryProfile |
始终为 as_soon_as_possible。 |
| servingStatus |
广告活动的已计算状态。 |
| creationDate |
广告活动的创建日期。 |
| lastUpdateDate |
广告活动最后一次更新的日期。 |
广告组
| 字段 |
描述 |
| adGroupId |
广告组的编号。可用于联接报告数据。 |
| name |
广告主指定的广告组名称。 |
| campaignId |
广告活动的编号。 |
| tactic |
广告活动的投放方案，值为 T00020 或 T00030。 |
| defaultBid |
广告组的默认竞价。 |
| bidOptimization |
对于 vCPM 广告活动，该值始终为 reach。对于 CPC 广告活动，该值分为别 clicks 或 conversions。 |
| state |
广告组的状态 (enabled、paused 或 archived)。 |
| servingStatus |
广告组的已计算状态。 |
| creationDate |
广告组的创建日期。 |
| lastUpdateDate |
广告组最后一次更新的日期。 |
产品广告
| 字段 |
描述 |
| adId |
广告的编号。可用于联接报告数据。 |
| adGroupId |
广告组的编号。 |
| campaignId |
广告活动的编号。 |
| asin |
与广告关联的 ASIN。 |
| sku |
与广告关联的商品 SKU。仅适用于卖家账户。 |
| state |
广告的状态 (enabled、paused 或 archived)。 |
| servingStatus |
广告的已计算状态。 |
| creationDate |
广告的创建日期。 |
| lastUpdateDate |
广告最后一次更新的日期。 |
投放内容
| 字段 |
描述 |
| targetId |
投放表达式的编号。可用于联接报告数据。 |
| adGroupId |
广告组的编号。 |
| expressionType |
投放方案，manual 或 auto。 |
| state |
投放表达式的状态 (enabled、paused 或 archived)。 |
| expression.type |
投放表达式中使用的运算符。 |
| expression.value |
投放表达式的值。 |
| resolvedExpression.type |
投放表达式中使用的运算符。 |
| resolvedExpression.value |
投放表达式的解析值。 |
| servingStatus |
投放表达式的已计算状态。 |
| creationDate |
创建投放表达式的日期。 |
| lastUpdateDate |
投放表达式最后一次更新的日期。 |
