报告类型

adGroupId、adGroupName、attributedConversions14d、attributedConversions14dSameSKU、attributedConversions1d、attributedConversions1dSameSKU、attributedConversions30d、attributedConversions30dSameSKU、attributedConversions7d、attributedConversions7dSameSKU、attributedKindleEditionNormalizedPagesRead14d、attributedKindleEditionNormalizedPagesRoyalties14d、attributedSales14d、attributedSales14dSameSKU、attributedSales1d、attributedSales1dSameSKU、attributedSales30d、attributedSales30dSameSKU、attributedSales7d、attributedSales7dSameSKU、attributedUnitsOrdered14d、attributedUnitsOrdered14dSameSKU、attributedUnitsOrdered1d、attributedUnitsOrdered1dSameSKU、attributedUnitsOrdered30d、attributedUnitsOrdered30dSameSKU、attributedUnitsOrdered7d、attributedUnitsOrdered7dSameSKU、campaignBudget、campaignBudgetType、campaignId、campaignName、campaignStatus、clicks、cost、currency、impressions、keywordId*、keywordStatus、keywordText、matchType、query*

adGroupId、adGroupName、attributedConversions14d、attributedConversions14dSameSKU、attributedConversions1d、attributedConversions1dSameSKU、attributedConversions30d、attributedConversions30dSameSKU、attributedConversions7d、attributedConversions7dSameSKU、attributedKindleEditionNormalizedPagesRead14d、attributedKindleEditionNormalizedPagesRoyalties14d、attributedSales14d、attributedSales14dSameSKU、attributedSales1d、attributedSales1dSameSKU、attributedSales30d、attributedSales30dSameSKU、attributedSales7d、attributedSales7dSameSKU、attributedUnitsOrdered14d、attributedUnitsOrdered14dSameSKU、attributedUnitsOrdered1d、attributedUnitsOrdered1dSameSKU、attributedUnitsOrdered30d、attributedUnitsOrdered30dSameSKU、attributedUnitsOrdered7d、attributedUnitsOrdered7dSameSKU、campaignBudget、campaignBudgetType、campaignId、campaignName、campaignStatus、clicks、cost、impressions、query*、targetId*、targetingExpression、targetingText、targetingType

adGroupId、adGroupName、attributedConversions14d、attributedSales14d、campaignBudget、campaignBudgetType、campaignId、campaignName、campaignStatus、clicks、cost、impressions、keywordBid、keywordId*、keywordStatus、keywordText、matchType、query*、searchTermImpressionRank、searchTermImpressionShare

adGroupId、adGroupName、attributedConversions14d、attributedSales14d、campaignBudget、campaignBudgetType、campaignStatus、clicks、cost、impressions、keywordBid、keywordId*、keywordStatus、keywordText、matchType、query*、vctr、video5SecondViewRate、video5SecondViews、videoCompleteViews、videoFirstQuartileViews、videoMidpointViews、videoThirdQuartileViews、videoUnmutes、viewableImpressions、vtr、currency

```shell
curl --request POST 'https://advertising-api.amazon.com/v2/sp/keywords/report' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxx' \
--header 'Amazon-Advertising-API-ClientId: xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxx' \
--data-raw '{
"reportDate": "20211102",
"metrics": "impressions,clicks,cost",
"segment": "query"
}'
```

```shell
curl --request POST 'https://advertising-api.amazon.com/v2/hsa/keywords/report' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxx' \
--header 'Amazon-Advertising-API-ClientId: xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxx' \
--data-raw '{
"reportDate": "20211102",
"metrics": "impressions,clicks,cost",
"segment": "query",
"creativeType": "all"
}'
```

```shell
curl --request POST 'https://advertising-api.amazon.com/v2/hsa/keywords/report' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxx' \
--header 'Amazon-Advertising-API-ClientId: xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxx' \
--data-raw '{
"reportDate": "20211102",
"metrics": "impressions,clicks,cost",
"segment": "query",
"creativeType": "video"
}'
```

adGroupId、adGroupName、asin、attributedKindleEditionNormalizedPagesRead14d、attributedKindleEditionNormalizedPagesRoyalties14d、attributedSales14dOtherSKU、attributedSales1dOtherSKU、attributedSales30dOtherSKU、attributedSales7dOtherSKU、attributedUnitsOrdered14d、attributedUnitsOrdered14dOtherSKU、attributedUnitsOrdered1d、attributedUnitsOrdered1dOtherSKU、attributedUnitsOrdered30d、attributedUnitsOrdered30dOtherSKU、attributedUnitsOrdered7d、attributedUnitsOrdered7dOtherSKU、campaignId、campaignName、currency、keywordId、keywordText、matchType、otherAsin、sku (seller only)、targetId、targetingExpression、targetingText、targetingType

adGroupId、adGroupName、asin、attributedSales14dOtherSKU、attributedSales1dOtherSKU、attributedSales30dOtherSKU、attributedSales7dOtherSKU、attributedUnitsOrdered14dOtherSKU、attributedUnitsOrdered1dOtherSKU、attributedUnitsOrdered30dOtherSKU、attributedUnitsOrdered7dOtherSKU、campaignId、campaignName、currency、otherAsin、sku (seller only)、viewAttributedUnitsOrdered1dOtherSKU、viewAttributedUnitsOrdered7dOtherSKU、viewAttributedUnitsOrdered14dOtherSKU、viewAttributedUnitsOrdered30dOtherSKU、viewAttributedSales1dOtherSKU、viewAttributedSales7dOtherSKU、viewAttributedSales14dOtherSKU、viewAttributedSales30dOtherSKU、viewAttributedConversions1dOtherSKU、viewAttributedConversions7dOtherSKU、viewAttributedConversions14dOtherSKU、viewAttributedConversions30dOtherSKU、attributedConversions1dOtherSKU、attributedConversions7dOtherSKU、attributedConversions14dOtherSKU、attributedConversions30dOtherSKU.

<p>**注意**： 商品推广的 ASIN 报告要求将 `campaignType` 参数作为请求体的一部分。应始终将其设置为 `sponsoredProducts`。以下示例返回与关键词相关的销量。要获得已购买商品的完整集合，可以再请求第二份报告，在指标列表中包含 `targetId`，并省略 `keywordId`。</p>

```shell
curl --request POST 'https://advertising-api.amazon.com/v2/sp/asins/report' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxx' \
--header 'Amazon-Advertising-API-ClientId: xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxx' \
--data-raw '{
"reportDate": "20211102",
"metrics": "otherAsin,asin,keywordId,campaignId,adGroupId,attributedSales14dOtherSKU,attributedSales1dOtherSKU,attributedUnitsOrdered30dOtherSKU",
"campaignType": "sponsoredProducts"
}'
```
</details>

展示型推广

 <p>此示例对使用受众投放（方案 T00030）的广告组请求效果数据。</p>

```shell
curl --request POST 'https://advertising-api.amazon.com/sd/asins/report' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxx' \
--header 'Amazon-Advertising-API-ClientId: xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxx' \
--data-raw '{
"reportDate": "20211102",
"metrics": "otherAsin,asin,campaignId,adGroupId,attributedSales1dOtherSKU,attributedUnitsOrdered14dOtherSKU",
"tactic": "T00030"
}'
```
</details>

广告报告

广告报告可帮助您了解品牌推广活动在广告级别的表现。

路径

广告类型	路径
品牌推广	/v2/hsa/ads/report

注意： 要为商品推广和展示型推广获取推广的商品级别的效果数据，请参阅商品广告报告。

可用指标

品牌推广（版本 3）

adGroupId、adGroupName、applicableBudgetRuleId、applicableBudgetRuleName、attributedConversions14d、attributedConversions14dSameSKU、attributedDetailPageViewsClicks14d、attributedOrderRateNewToBrand14d、attributedOrdersNewToBrand14d、attributedOrdersNewToBrandPercentage14d、attributedSales14d、attributedSales14dSameSKU、attributedSalesNewToBrand14d、attributedSalesNewToBrandPercentage14d、attributedUnitsOrderedNewToBrand14d、attributedUnitsOrderedNewToBrandPercentage14d、campaignBudget、campaignBudgetType、campaignId、campaignName、campaignRuleBasedBudget、campaignStatus、clicks、cost、dpv14d、impressions、unitsSold14d、vctr、attributedBrandedSearches14d

品牌推广视频（版本 3）和多广告组广告活动（版本 4）

adGroupId、adGroupName、adId、applicableBudgetRuleId、applicableBudgetRuleName、attributedConversions14d、attributedConversions14dSameSKU、attributedDetailPageViewsClicks14d、attributedOrderRateNewToBrand14d、attributedOrdersNewToBrand14d、attributedOrdersNewToBrandPercentage14d、attributedSales14d、attributedSales14dSameSKU、attributedSalesNewToBrand14d、attributedSalesNewToBrandPercentage14d、attributedUnitsOrderedNewToBrand14d、attributedUnitsOrderedNewToBrandPercentage14d、campaignBudget、campaignBudgetType、campaignId、campaignName、campaignRuleBasedBudget、campaignStatus、clicks、cost、dpv14d、impressions、vctr、video5SecondViewRate、video5SecondViews、videoCompleteViews、videoFirstQuartileViews、videoMidpointViews、videoThirdQuartileViews、videoUnmutes、viewableImpressions、vtr、attributedBrandedSearches14d、currency

注意

adId 仅可用于多广告组广告活动。对于使用版本 3 广告活动接口创建的视频广告活动，adId 将不可用。

请求示例

如果您要复制示例请求，请确保使用与您的地理位置对应的正确 URL，并对您的账户使用有效的身份验证凭据。

品牌推广和品牌推广视频

<p>广告报告必须在请求体中将 `creativeType` 设置为 `all`。该报告将同时包含品牌推广和品牌推广视频广告活动的数据。</p>


```shell
curl --request POST 'https://advertising-api.amazon.com/v2/hsa/ads/report' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxx' \
--header 'Amazon-Advertising-API-ClientId: xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxx' \
--data-raw '{
"reportDate": "20211102",
"metrics": "adId,adGroupId,campaignId,impressions,clicks,cost,attributedConversions14d,attributedSales14d",
"creativeType":"all"
}'
```
</details>

匹配的定向投放报告

匹配的定向投放报告可以帮助您根据展示型推广活动所在的商品详情页了解展示型推广活动的效果。匹配的定向投放报告仅包含商品详情页至少记录过一次广告点击的 ASIN。适用于展示型推广的匹配的定向投放报告可以按广告活动、广告组或投放级别进行细分。

对于展示型推广，您可以通过请求 campaigns、adGroups 或 targets 报告并在请求体中将 segment 设置为 matchedTarget 来创建匹配的定向投放报告。

路径

广告类型	路径
展示型推广活动	/sd/campaigns/report
展示型推广广告组	/sd/adGroups/report
展示型推广投放	/sd/targets/report

可用指标

展示型推广：广告活动

attributedConversions14d、attributedConversions14dSameSKU、attributedConversions1d、attributedConversions1dSameSKU、attributedConversions30d、attributedConversions30dSameSKU、attributedConversions7d、attributedConversions7dSameSKU、attributedDetailPageView14d、attributedOrdersNewToBrand14d、attributedSales14d、attributedSales14dSameSKU、attributedSales1d、attributedSales1dSameSKU、attributedSales30d、attributedSales30dSameSKU、attributedSales7d、attributedSales7dSameSKU、attributedSalesNewToBrand14d、attributedUnitsOrdered14d、attributedUnitsOrdered1d、attributedUnitsOrdered30d、attributedUnitsOrdered7d、attributedUnitsOrderedNewToBrand14d、campaignBudget、campaignId、campaignName、campaignStatus、clicks、cost、costType、currency、impressions、viewAttributedConversions14d、viewAttributedDetailPageView14d、viewAttributedSales14d、viewAttributedUnitsOrdered14d、viewImpressions、viewAttributedOrdersNewToBrand14d、viewAttributedSalesNewToBrand14d、viewAttributedUnitsOrderedNewToBrand14d、attributedBrandedSearches14d、viewAttributedBrandedSearches14d、matchedTarget*

展示型推广：广告组

adGroupId、adGroupName、attributedConversions14d、attributedConversions14dSameSKU、attributedConversions1d、attributedConversions1dSameSKU、attributedConversions30d、attributedConversions30dSameSKU、attributedConversions7d、attributedConversions7dSameSKU、attributedDetailPageView14d、attributedOrdersNewToBrand14d、attributedSales14d、attributedSales14dSameSKU、attributedSales1d、attributedSales1dSameSKU、attributedSales30d、attributedSales30dSameSKU、attributedSales7dSameSKU、attributedUnitsOrdered14d、attributedUnitsOrdered1d、attributedUnitsOrdered30d、attributedUnitsOrdered7d、attributedUnitsOrderedNewToBrand14d、bidOptimization、campaignId、campaignName、clicks、cost、currency、impressions、viewAttributedConversions14d、viewAttributedDetailPageView14d、viewAttributedSales14d、viewAttributedUnitsOrdered14d、viewImpressions,viewAttributedOrdersNewToBrand14d、viewAttributedSalesNewToBrand14d、viewAttributedUnitsOrderedNewToBrand14d、attributedBrandedSearches14d、viewAttributedBrandedSearches14d、matchedTarget*

展示型推广：投放

adGroupId、adGroupName、attributedConversions14d、attributedConversions14dSameSKU、attributedConversions1d、attributedConversions1dSameSKU、attributedConversions30d、attributedConversions30dSameSKU、attributedConversions7d、attributedConversions7dSameSKU、attributedDetailPageView14d、attributedOrdersNewToBrand14d、attributedSales14d、attributedSales14dSameSKU、attributedSales1d、attributedSales1dSameSKU、attributedSales30d、attributedSales30dSameSKU、attributedSales7d、attributedSales7dSameSKU、attributedSalesNewToBrand14d、attributedUnitsOrdered14d、attributedUnitsOrdered1d、attributedUnitsOrdered30d、attributedUnitsOrdered7d、attributedUnitsOrderedNewToBrand14d、campaignId、campaignName、clicks、cost、currency、impressions、targetId、targetingExpression、targetingText、targetingType、viewAttributedConversions14d、viewAttributedDetailPageView14d、viewAttributedSales14d、viewAttributedUnitsOrdered14d、viewAttributedOrdersNewToBrand14d、viewAttributedSalesNewToBrand14d、viewAttributedUnitsOrderedNewToBrand14d、attributedBrandedSearches14d、viewAttributedBrandedSearches14d、matchedTarget*

*指标在默认情况下已添加到报告中。

请求示例

如果您要复制示例请求，请确保使用与您的地理位置对应的正确 URL，并对您的账户使用有效的身份验证凭据。

展示型推广：投放

```shell
curl --request POST 'https://advertising-api.amazon.com/sd/targets/report' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxx' \
--header 'Amazon-Advertising-API-ClientId: xxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxx' \
--data-raw '{
"reportDate": 20220301,
"tactic": "T00030",
"metrics": "campaignId,adGroupId,targetId,targetingExpression,targetingText,targetingType,impressions,clicks,cost,currency,attributedConversions1d,attributedConversions7d,attributedConversions14d,attributedConversions30d,attributedUnitsOrdered1d,attributedUnitsOrdered7d,attributedUnitsOrdered14d,attributedUnitsOrdered30d,attributedSales1d,attributedSales7d,attributedSales14d,attributedSales30d,attributedSales1dSameSKU,attributedSales7dSameSKU,attributedSales14dSameSKU,attributedSales30dSameSKU",
"segment": "matchedTarget"
}'
```
</details>

• © 2023 Amazon.com, Inc. or its affiliates.
• Conditions of Use
• Privacy Notice
• License Agreement
• Data Policies