レポートタイプ
Ads APIは、キャンペーンのエンティティ構造に基づきさまざまなレポートタイプに対応しています。広告タイプに応じて、キャンペーンのパフォーマンスをキャンペーン、広告グループ、広告、キーワード、ターゲット、ASINごとに分析できます。
ほとんどのレポートタイプはパスパラメーターで設定されますが、一部のレポートタイプはリクエスト本文のsegment
パラメーターを使用して設定することもできます。
注
広告コンソールのレポートはAPIとは少し異なります。詳しくは、APIとコンソールのレポートをご覧ください。
広告タイプ別の利用可否
警告
2023年3月30日現在、バージョン2でのスポンサープロダクト広告レポートのサポートは終了しています。今後は、バージョン3のレポートエンドポイントを使用してください。バージョン3へのアップグレード方法の詳細については、『移行ガイド』および「よくある質問」を参照してください。
スポンサー広告のタイプごとに、異なるレポートタイプがサポートされ、個別のパスが定義されています。
レポートタイプ | スポンサープロダクト広告[廃止済み] | スポンサーブランド広告 | スポンサーディスプレイ広告 |
---|---|---|---|
キャンペーン | x | x | x |
掲載枠 | x | x | |
広告グループ | x | x | x |
プロダクト広告 | x | x | |
ターゲット | x | x | x |
キーワード | x | x | |
検索ワード | x | x | |
ASIN | x | x | |
広告 | x | ||
一致ターゲット | x |
キャンペーンレポート
キャンペーンレポートには、キャンペーンレベルで分析されたパフォーマンスデータが含まれています。キャンペーンレポートには、リクエストしたスポンサー広告タイプで、リクエストした日付のパフォーマンスアクティビティが存在するキャンペーンがすべて含まれています。たとえば、スポンサープロダクト広告のキャンペーンレポートでは、選択した日付にインプレッションを獲得したすべてのスポンサープロダクト広告キャンペーンのパフォーマンスデータが返されます。
パス
広告タイプ | パス |
---|---|
スポンサープロダクト広告 | /v2/sp/campaigns/report[廃止済み] |
スポンサーブランド広告 | /v2/hsa/campaigns/report |
スポンサーディスプレイ広告 | /sd/campaigns/report |
利用可能な指標
スポンサープロダクト広告[廃止済み]
applicableBudgetRuleId、applicableBudgetRuleName、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、campaignRuleBasedBudget、campaignStatus、clicks、cost、currency、impressions
スポンサーブランド広告(バージョン3)
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、attributedBrandedSearches14d、topOfSearchImpressionShare
スポンサーブランド動画広告(バージョン3)と複数広告グループのキャンペーン(バージョン4)
attributedConversions14d、attributedConversions14dSameSKU、attributedSales14d、attributedSales14dSameSKU、campaignBudget、campaignBudgetType、campaignId*、campaignName、campaignStatus、clicks、cost、dpv14d、impressions、vctr、video5SecondViewRate、video5SecondViews、videoCompleteViews、videoFirstQuartileViews、videoMidpointViews、videoThirdQuartileViews、videoUnmutes、viewableImpressions、vtr、dpv14d、attributedDetailPageViewsClicks14d、attributedOrderRateNewToBrand14d、attributedOrdersNewToBrand14d、attributedOrdersNewToBrandPercentage14d、attributedSalesNewToBrand14d、attributedSalesNewToBrandPercentage14d、attributedUnitsOrderedNewToBrand14d、attributedUnitsOrderedNewToBrandPercentage14d、attributedBrandedSearches14d、currency、topOfSearchImpressionShare
スポンサーディスプレイ広告
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、videoCompleteViews、videoFirstQuartileViews、videoMidpointViews、videoThirdQuartileViews、videoUnmutes、vtr、vctr、avgImpressionsFrequency、cumulativeReach
*指標はデフォルトでレポートに追加されます。
サンプルリクエスト
リクエストの例をコピーする場合は、実際の地域ごとの正しいURLとアカウントの有効な認証情報を必ず使用してください。
スポンサープロダクト広告[廃止済み]
```shell
curl --request POST 'https://advertising-api.amazon.com/v2/sp/campaigns/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,attributedConversions14d,attributedSales14d"
}'
```
</details>
スポンサーブランドの複数広告グループのキャンペーン
```shell
curl --request POST 'https://advertising-api.amazon.com/v2/hsa/campaigns/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,attributedConversions14d,attributedSales14d",
"creativeType": "all"
}'
```
スポンサーブランド動画広告```shell
curl --request POST 'https://advertising-api.amazon.com/v2/hsa/campaigns/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": "viewableImpressions,vtr,vctr,clicks,cost,attributedConversions14d,attributedSales14d",
"creativeType": "video"
}'
```
</details>
スポンサーディスプレイ広告
<p>このサンプルでは、コンテキストターゲティング(tactic T00020)を使用するキャンペーンのパフォーマンスデータをリクエストしています。この例でリクエストされた指標は、クリック単価(CPC)と1000件あたりのビューアブルインプレッション単価(vCPM)の両方のコストタイプを使用するキャンペーンのデータを返します。</p>
```shell
curl --request POST 'https://advertising-api.amazon.com/sd/campaigns/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,viewImpressions,clicks,cost,attributedConversions14d,viewAttributedConversions14d,attributedSales14d,viewAttributedSales14d",
"tactic": "T00020"
}'
```
</details>
広告枠レポート
広告枠レポートでは、キャンペーン別およびページ上の広告の掲載位置別にパフォーマンスが示されます。
スポンサープロダクト広告とスポンサーブランド広告の場合、キャンペーン
レポートをリクエストし、リクエスト本文でsegment
をplacement
に設定することで、広告枠レポートを作成できます。
パス
広告タイプ | パス |
---|---|
スポンサープロダクト広告 | /v2/sp/campaigns/report[廃止済み] |
スポンサーブランド広告 | /v2/hsa/campaigns/report |
注: スポンサーディスプレイ広告キャンペーンでは、広告枠レポートをご利用いただけません。
利用可能な指標
スポンサープロダクト広告[廃止済み]
applicableBudgetRuleId、applicableBudgetRuleName、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、bidPlus、campaignBudget、campaignBudgetType、campaignId*、campaignName、campaignRuleBasedBudget、campaignStatus、clicks、cost、currency、impressions、placement*
スポンサーブランド広告(バージョン3)
applicableBudgetRuleId、applicableBudgetRuleName、attributedConversions14d、attributedConversions14dSameSKU、attributedDetailPageViewsClicks14d、attributedOrderRateNewToBrand14d、attributedOrdersNewToBrand14d、attributedOrdersNewToBrandPercentage14d、attributedSales14d、attributedSales14dSameSKU、attributedSalesNewToBrand14d、attributedSalesNewToBrandPercentage14d、attributedUnitsOrderedNewToBrand14d、attributedUnitsOrderedNewToBrandPercentage14d、campaignBudget、campaignBudgetType、campaignId*、campaignName、campaignRuleBasedBudget、campaignStatus、clicks、cost、dpv14d、impressions、placement*、 unitsSold14d、attributedBrandedSearches14d
スポンサーブランド動画広告(バージョン3)と複数広告グループのキャンペーン(バージョン4)
attributedConversions14d、attributedConversions14dSameSKU、attributedSales14d、attributedSales14dSameSKU、campaignBudget、campaignBudgetType、campaignId*、campaignName、campaignStatus、clicks、cost、impressions、placement*、vctr、video5SecondViewRate、video5SecondViews、videoCompleteViews、videoFirstQuartileViews、videoMidpointViews、videoThirdQuartileViews、videoUnmutes、viewableImpressions、vtr、dpv14d、attributedDetailPageViewsClicks14d、attributedOrderRateNewToBrand14d、attributedOrdersNewToBrand14d、attributedOrdersNewToBrandPercentage14d、attributedSalesNewToBrand14d、attributedSalesNewToBrandPercentage14d、attributedUnitsOrderedNewToBrand14d、attributedUnitsOrderedNewToBrandPercentage14d、attributedBrandedSearches14d、currency
サンプルリクエスト
リクエストの例をコピーする場合は、実際の地域ごとの正しいURLとアカウントの有効な認証情報を必ず使用してください。
スポンサープロダクト広告[廃止済み]
```shell
curl --request POST 'https://advertising-api.amazon.com/v2/sp/campaigns/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,attributedConversions14d,attributedSales14d",
"segment": "placement"
}'
```
スポンサーブランド広告```shell
curl --request POST 'https://advertising-api.amazon.com/v2/hsa/campaigns/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,attributedConversions14d,attributedSales14d",
"segment": "placement",
"creativeType": "all"
}'
```
</details>
広告グループレポート
すべてのキャンペーンには、ターゲット設定と入札額設定を共有する広告グループが1つ以上含まれます。adGroups
レポートを作成すると、広告グループレベルのパフォーマンスデータを取得できます。
パス
広告タイプ | パス |
---|---|
スポンサープロダクト広告 | /v2/sp/adGroups/report[廃止済み] |
スポンサーブランド広告 | /v2/hsa/adGroups/report |
スポンサーディスプレイ広告 | /sd/adGroups/report |
利用可能な指標
スポンサープロダクト広告[廃止済み]
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
スポンサーブランド広告(バージョン3)
adGroupId*、adGroupName、attributedConversions14d、attributedConversions14dSameSKU、attributedDetailPageViewsClicks14d、attributedOrderRateNewToBrand14d、attributedOrdersNewToBrand14d、attributedOrdersNewToBrandPercentage14d、attributedSales14d、attributedSales14dSameSKU、attributedSalesNewToBrand14d、attributedSalesNewToBrandPercentage14d、attributedUnitsOrderedNewToBrand14d、attributedUnitsOrderedNewToBrandPercentage14d、campaignBudget、campaignBudgetType、campaignId、campaignName、campaignStatus、clicks、cost、dpv14d、impressions、unitsSold14d、attributedBrandedSearches14d
スポンサーブランド動画広告(バージョン3)と複数広告グループのキャンペーン(バージョン4)
adGroupId*、adGroupName、attributedConversions14d、attributedConversions14dSameSKU、attributedSales14d、attributedSales14dSameSKU、campaignBudget、campaignBudgetType、campaignId、campaignName、 campaignStatus、clicks、cost、impressions、vctr、video5SecondViewRate、video5SecondViews、videoCompleteViews、videoFirstQuartileViews、videoMidpointViews、videoThirdQuartileViews、videoUnmutes、viewableImpressions、vtr、dpv14d、attributedDetailPageViewsClicks14d、attributedOrderRateNewToBrand14d、attributedOrdersNewToBrand14d、attributedOrdersNewToBrandPercentage14d、attributedSalesNewToBrand14d、attributedSalesNewToBrandPercentage14d、attributedUnitsOrderedNewToBrand14d、attributedUnitsOrderedNewToBrandPercentage14d、attributedBrandedSearches14d、currency
スポンサーディスプレイ広告
adGroupId、adGroupName、attributedConversions14d、attributedConversions14dSameSKU、attributedConversions1d、attributedConversions1dSameSKU、attributedConversions30d、attributedConversions30dSameSKU、attributedConversions7d、attributedConversions7dSameSKU、attributedDetailPageView14d、attributedOrdersNewToBrand14d、attributedSales14d、attributedSales14dSameSKU、attributedSales1d、attributedSales1dSameSKU、attributedSales30d、attributedSales30dSameSKU、attributedSales7d、attributedSales7dSameSKU、attributedUnitsOrdered14d、attributedUnitsOrdered1d、attributedUnitsOrdered30d、attributedUnitsOrdered7d、attributedUnitsOrderedNewToBrand14d、bidOptimization、campaignId、campaignName、clicks、cost、currency、impressions、viewAttributedConversions14d、viewAttributedDetailPageView14d、viewAttributedSales14d、viewAttributedUnitsOrdered14d、viewImpressions、viewAttributedOrdersNewToBrand14d、viewAttributedSalesNewToBrand14d、viewAttributedUnitsOrderedNewToBrand14d、attributedBrandedSearches14d、viewAttributedBrandedSearches14d、videoCompleteViews、videoFirstQuartileViews、videoMidpointViews、videoThirdQuartileViews、videoUnmutes、vtr、vctr、avgImpressionsFrequency、cumulativeReach
*指標はデフォルトでレポートに追加されます。
サンプルリクエスト
リクエストの例をコピーする場合は、実際の地域ごとの正しいURLとアカウントの有効な認証情報を必ず使用してください。
スポンサープロダクト広告[廃止済み]
```shell
curl --request POST 'https://advertising-api.amazon.com/v2/sp/adGroups/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,attributedConversions14d,attributedSales14d"
}'
```
</details>
スポンサーブランド広告
```shell
curl --request POST 'https://advertising-api.amazon.com/v2/hsa/adGroups/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,attributedConversions14d,attributedSales14d",
"creativeType": "all"
}'
```
</details>
スポンサーディスプレイ広告
<p>このサンプルでは、オーディエンスターゲティング(tactic T00030)を使用する広告グループのパフォーマンスデータをリクエストしています。この例でリクエストされた指標は、クリック課金制(CPC)コストタイプを使用するキャンペーンのデータを返します。</p>
```shell
curl --request POST 'https://advertising-api.amazon.com/sd/adGroups/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": "adGroupId,impressions,clicks,cost,attributedConversions14d,attributedSales14d",
"tactic": "T00030"
}'
```
</details>
プロダクト広告レポート
プロダクト広告レポートには、広告対象商品のパフォーマンスが示されます。productAds
レポートをリクエストすることで、広告対象商品レベルのパフォーマンスデータを生成できます。
パス
広告タイプ | パス |
---|---|
スポンサープロダクト広告 | /v2/sp/productAds/report[廃止済み] |
スポンサーディスプレイ広告 | /sd/productAds/report |
注: スポンサーブランド広告キャンペーンでは、プロダクト広告レポートをご利用いただけません。
利用可能な指標
スポンサープロダクト広告
adGroupId、adGroupName、adId*、asin、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、sku(出品者様のみ)
スポンサーディスプレイ広告
adGroupId、adGroupName、adId、asin、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、sku(出品者様のみ)、viewAttributedConversions14d、viewImpressions、viewAttributedDetailPageView14d、viewAttributedSales14d、viewAttributedUnitsOrdered14d、viewAttributedOrdersNewToBrand14d、viewAttributedSalesNewToBrand14d、viewAttributedUnitsOrderedNewToBrand14d、attributedBrandedSearches14d、viewAttributedBrandedSearches14d、videoCompleteViews、videoFirstQuartileViews、videoMidpointViews、videoThirdQuartileViews、videoUnmutes、vtr、vctr、avgImpressionsFrequency、cumulativeReach
*指標はデフォルトでレポートに追加されます。
サンプルリクエスト
リクエストの例をコピーする場合は、実際の地域ごとの正しいURLとアカウントの有効な認証情報を必ず使用してください。
スポンサープロダクト広告[廃止済み]
```shell
curl --request POST 'https://advertising-api.amazon.com/v2/sp/productAds/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,attributedConversions14d,attributedSales14d"
}'
```
スポンサーディスプレイ広告```shell
curl --request POST 'https://advertising-api.amazon.com/sd/productAds/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,impressions,clicks,cost,attributedConversions14d,attributedSales14d",
"tactic": "T00020"
}'
```
</details>
ターゲットレポート
ターゲットレポートには、ターゲティング表現に関連するパフォーマンスデータが含まれます。ターゲット
レポートをリクエストすることで、ターゲットレベルのパフォーマンスデータを生成できます。
パス
広告タイプ | パス |
---|---|
スポンサープロダクト広告 | /v2/sp/targets/report [廃止済み] |
スポンサーブランド広告 | /v2/hsa/targets/report |
スポンサーディスプレイ広告 | /sd/targets/report |
利用可能な指標
スポンサープロダクト広告[廃止済み]
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、targetId*、targetingExpression、targetingText、targetingType
スポンサーブランド広告(バージョン3)
adGroupId、adGroupName、attributedConversions14d、attributedConversions14dSameSKU、attributedDetailPageViewsClicks14d、attributedOrderRateNewToBrand14d、attributedOrdersNewToBrand14d、attributedOrdersNewToBrandPercentage14d、attributedSales14d、attributedSales14dSameSKU、attributedSalesNewToBrand14d、attributedSalesNewToBrandPercentage14d、attributedUnitsOrderedNewToBrand14d、attributedUnitsOrderedNewToBrandPercentage14d、campaignBudget、campaignBudgetType、campaignId、campaignName、campaignStatus、clicks、cost、dpv14d、impressions、targetId*、targetingExpression、targetingText、targetingType、unitsSold14d、attributedBrandedSearches14d、topOfSearchImpressionShare
スポンサーブランド動画広告(バージョン3)と複数広告グループのキャンペーン(バージョン4)
adGroupId、adGroupName、attributedConversions14d、attributedConversions14dSameSKU、attributedSales14d、attributedSales14dSameSKU、campaignBudget、campaignBudgetType、campaignId、campaignName、campaignStatus、clicks、cost、impressions、targetId*、targetingExpression、targetingText、targetingType、vctr、video5SecondViewRate、video5SecondViews、videoCompleteViews、videoFirstQuartileViews、videoMidpointViews、videoThirdQuartileViews、videoUnmutes、viewableImpressions、vtr、dpv14d、attributedDetailPageViewsClicks14d、attributedOrderRateNewToBrand14d、attributedOrdersNewToBrand14d、attributedOrdersNewToBrandPercentage14d、attributedSalesNewToBrand14d、attributedSalesNewToBrandPercentage14d、attributedUnitsOrderedNewToBrand14d、attributedUnitsOrderedNewToBrandPercentage14d、attributedBrandedSearches14d、currency、topOfSearchImpressionShare
スポンサーディスプレイ広告
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、viewImpressions、viewAttributedConversions14d、viewAttributedDetailPageView14d、viewAttributedSales14d、viewAttributedUnitsOrdered14d、viewAttributedOrdersNewToBrand14d、viewAttributedSalesNewToBrand14d、viewAttributedUnitsOrderedNewToBrand14d、attributedBrandedSearches14d、viewAttributedBrandedSearches14d、videoCompleteViews、videoFirstQuartileViews、videoMidpointViews、videoThirdQuartileViews、videoUnmutes、vtr、vctr
*指標はデフォルトでレポートに追加されます。
サンプルリクエスト
リクエストの例をコピーする場合は、実際の地域ごとの正しいURLとアカウントの有効な認証情報を必ず使用してください。
スポンサープロダクト広告[廃止済み]
```shell
curl --request POST 'https://advertising-api.amazon.com/v2/sp/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": "20211102",
"metrics": "impressions,clicks,cost"
}'
```
</details>
スポンサーブランド広告
```shell
curl --request POST 'https://advertising-api.amazon.com/v2/hsa/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": "20211102",
"metrics": "impressions,clicks,cost",
"creativeType": "all"
}'
```
</details>
スポンサーディスプレイ広告
<p>このサンプルでは、コンテキストターゲティング(tactic T00020)を使用する広告グループのパフォーマンスデータをリクエストします。この例でリクエストされた指標は、クリック課金制(CPC)コストタイプを使用するキャンペーンのデータを返します。</p>
```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": "20211102",
"metrics": "targetId,impressions,clicks,cost",
"tactic": "T00020"
}'
```
</details>
キーワードレポート
キーワードレポートは、ターゲティングに使用されたキーワードごとに分析されたパフォーマンスデータを返します。キーワード
レポートをリクエストすることで、キーワードレベルのパフォーマンスデータを生成できます。
パス
広告タイプ | パス |
---|---|
スポンサープロダクト広告 | /v2/sp/keywords/report [廃止済み] |
スポンサーブランド広告 | /v2/hsa/keywords/report |
注: スポンサーディスプレイ広告キャンペーンでは、キーワードレポートをご利用いただけません。
利用可能な指標
スポンサープロダクト広告[廃止済み]
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
スポンサーブランド広告(バージョン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、keywordBid、keywordId*、keywordStatus、keywordText、matchType、searchTermImpressionRank、searchTermImpressionShare、unitsSold14d、attributedBrandedSearches14d、topOfSearchImpressionShare
スポンサーブランド動画広告(バージョン3)と複数広告グループのキャンペーン(バージョン4)
adGroupId、adGroupName、attributedConversions14d、attributedConversions14dSameSKU、attributedSales14d、attributedSales14dSameSKU、campaignBudget、campaignBudgetType、campaignId、campaignName、campaignStatus、clicks、cost、impressions、keywordBid、keywordId*、keywordStatus、keywordText、matchType、vctr、video5SecondViewRate、video5SecondViews、videoCompleteViews、videoFirstQuartileViews、videoMidpointViews、videoThirdQuartileViews、videoUnmutes、viewableImpressions、vtr、dpv14d、attributedDetailPageViewsClicks14d、attributedOrderRateNewToBrand14d、attributedOrdersNewToBrand14d、attributedOrdersNewToBrandPercentage14d、attributedSalesNewToBrand14d、attributedSalesNewToBrandPercentage14d、attributedUnitsOrderedNewToBrand14d、attributedUnitsOrderedNewToBrandPercentage14d、attributedBrandedSearches14d、currency、topOfSearchImpressionShare
*指標はデフォルトでレポートに追加されます。
サンプルリクエスト
リクエストの例をコピーする場合は、実際の地域ごとの正しいURLとアカウントの有効な認証情報を必ず使用してください。
スポンサープロダクト広告[廃止済み]
```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"
}'
```
</details>
スポンサーブランド広告
```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",
"creativeType": "all"
}'
```
</details>
検索ワードレポート
検索語レポートには、顧客が入力した検索ワードごとに分析されたパフォーマンスデータが含まれます。検索ワードレポートには、1回以上の広告クリックにつながったインプレッションのみが含まれます。ご注意ください。
スポンサープロダクト広告とスポンサーブランド広告の場合、キーワード
レポートをリクエストし、リクエスト本文でsegment
をquery
に設定することで、検索ワードレポートを作成できます。
スポンサープロダクト広告キャンペーンの場合のみ、ターゲット
レポートのリクエスト本文でsegment
をquery
に設定することで、商品をターゲットにしたキャンペーンの検索ワードレポートをリクエストすることもできます。
注: このAPIでは現在、商品をターゲットにしたスポンサーブランド広告キャンペーンの検索ワードレポートをサポートしていません。
パス
広告タイプ | パス |
---|---|
スポンサープロダクト広告 | /v2/sp/keywords/report [廃止済み] |
スポンサープロダクト広告 | /v2/sp/targets/report |
スポンサーブランド広告 | /v2/hsa/keywords/report |
注: スポンサーディスプレイ広告キャンペーンでは、検索ワードレポートをご利用いただけません。
利用可能な指標
スポンサープロダクト広告:キーワード[廃止済み]
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
スポンサーブランド広告(バージョン3)
adGroupId、adGroupName、attributedConversions14d、attributedSales14d、campaignBudget、campaignBudgetType、campaignId、campaignName、campaignStatus、clicks、cost、impressions、keywordBid、keywordId*、keywordStatus、keywordText、matchType、query*、searchTermImpressionRank、searchTermImpressionShare
スポンサーブランド動画広告(バージョン3)と複数広告グループのキャンペーン(バージョン4)
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
*指標はデフォルトでレポートに追加されます。
サンプルリクエスト
リクエストの例をコピーする場合は、実際の地域ごとの正しいURLとアカウントの有効な認証情報を必ず使用してください。
スポンサープロダクト広告[廃止済み]
```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"
}'
```
ASINレポート
ASINレポートには、ハローコンバージョン、つまり顧客が広告をクリックして注文したものの、広告対象SKU/ASINとは異なるSKU/ASINが購入されたというコンバージョンが含まれます。
ヒント:スポンサープロダクト広告
現在のASINレポートには、キーワードとターゲットの両方に関連する指標を含めることはできません。リクエストで
targetingID
を指標として追加した場合、レポートはターゲットを条件にして絞り込まれるため、キーワードに関連する売上は返されません。リクエストにtargetingID
を指定しない場合、レポートはキーワードを条件にして絞り込まれるため、ターゲットに関連する売上は返されません。したがって、デフォルトの動作では、レポートはキーワードを条件にして絞り込まれます。また、指標リストにkeywordId
とtargetingID
の両方を指定した場合、レポートはターゲットのみを条件にして絞り込まれるので、キーワードは返されないことにも注意してください。
パス
広告タイプ | パス |
---|---|
スポンサープロダクト広告 | /v2/sp/asins/report[廃止済み] |
スポンサーディスプレイ広告 | /sd/asins/report |
注: スポンサーブランド広告キャンペーンでは、ASINレポートをご利用いただけません。
利用可能な指標
スポンサープロダクト広告[廃止済み]
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(出品者様のみ)、targetId、targetingExpression、targetingText、targetingType
スポンサーディスプレイ広告
adGroupId、adGroupName、asin、attributedSales14dOtherSKU、attributedSales1dOtherSKU、attributedSales30dOtherSKU、attributedSales7dOtherSKU、attributedUnitsOrdered14dOtherSKU、attributedUnitsOrdered1dOtherSKU、attributedUnitsOrdered30dOtherSKU、attributedUnitsOrdered7dOtherSKU、campaignId、campaignName、currency、otherAsin、sku(出品者様のみ)、viewAttributedUnitsOrdered1dOtherSKU、viewAttributedUnitsOrdered7dOtherSKU、viewAttributedUnitsOrdered14dOtherSKU、viewAttributedUnitsOrdered30dOtherSKU、viewAttributedSales1dOtherSKU、viewAttributedSales7dOtherSKU、viewAttributedSales14dOtherSKU、viewAttributedSales30dOtherSKU、viewAttributedConversions1dOtherSKU、viewAttributedConversions7dOtherSKU、viewAttributedConversions14dOtherSKU、viewAttributedConversions30dOtherSKU、attributedConversions1dOtherSKU、attributedConversions7dOtherSKU、attributedConversions14dOtherSKU、attributedConversions30dOtherSKU.
サンプルリクエスト
リクエストの例をコピーする場合は、実際の地域ごとの正しいURLとアカウントの有効な認証情報を必ず使用してください。
スポンサープロダクト広告[廃止済み]
<p>**注意**: スポンサープロダクト広告のASINレポートには、リクエスト本文の一部として「campaignType」パラメーターが必要です。常に「sponsoredProducts」に設定する必要があります。この例では、キーワードに関連する売上が返されます。購入した製品をすべて確認するには、指標リストに「targetId」を指定し、「keywordId」を省略した2つ目のレポートをリクエストしてください。</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>このサンプルでは、オーディエンスターゲティング(tactic 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 |
注: 広告対象商品レベルでスポンサープロダクト広告とスポンサーディスプレイ広告のパフォーマンスデータを取得するには、[プロダクト広告レポート](../../../ .html)をご覧ください。
利用可能な指標
スポンサーブランド広告(バージョン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>
一致ターゲットレポート
一致ターゲットレポートは、スポンサーディスプレイ広告キャンペーンが表示された商品詳細ページに基づいて、キャンペーンのパフォーマンスを理解するのに役立ちます。一致ターゲットレポートには、少なくとも1回の広告クリックを記録した商品詳細ページのASINのみが含まれます。スポンサーディスプレイ広告の一致ターゲットレポートは、キャンペーン、広告グループ、またはターゲットレベルで分析できます。
スポンサーディスプレイ広告の場合、キャンペーン
レポート、広告グループ
レポート、またはターゲット
レポートをリクエストし、リクエスト本文で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