レポートAPIのバージョン2からバージョン3への移行

以下のような新機能があります。

• すべての広告タイプに対応する単一の統合エンドポイント
• 複数日分のデータを記載した単一のレポート
• 概要レポートと日次レポート
• その他の標準化された指標
• スポンサーブランド広告の購入商品レポート
• 一貫したディメンションデータのレポート
• バグ修正

ヒント

バージョン3のレポートの詳細については、よくある質問をご覧ください。

レポートタイプの比較

バージョン3では、レポートタイプに使用される命名規則が変更されています。次の表に、バージョン2のレポートタイプとバージョン3のレポートタイプの関係を示します。

バージョン2のレポート名	バージョン3のレポート設定
キャンペーン	キャンペーン別にグループ化したキャンペーン*
掲載枠	掲載枠およびキャンペーン別にグループ化したキャンペーン*
広告グループ	広告グループおよびキャンペーン別にグループ化したキャンペーン*
プロダクト広告	広告商品*
ターゲット	keywordTypeでフィルタリングしたターゲティング*
キーワード	keywordTypeでフィルタリングしたターゲティング*
検索ワード	検索ワード*
ASIN	購入商品*
広告	該当なし
一致ターゲット	該当なし

*スポンサープロダクト広告のみ

注

バージョン3では現在、スポンサーディスプレイ広告レポートはサポートされていません。新しいレポートタイプが利用可能になり次第、資料を更新する予定です。

注

バージョン3のクローズドベータに参加した広告主様の一部は、別のspKeywordsレポートを利用できる場合があります。今後、キーワードのパフォーマンスデータを取得するには、フィルターとともにspTargetingを使用することをおすすめします。

新しいレポート： スポンサーブランド広告の購入商品レポート

広告主は、スポンサーブランド広告キャンペーンの広告起因の売上データについて、商品レベルのインサイトを取得できるようになりました。

新しいレポートには、広告掲載商品（広告をクリックした買い物客による広告対象ブランド商品の購入）やブランドハロー効果（Amazonや他の出品者による広告対象ブランド商品の売上）など、広告に起因するすべての売上が記載されます。

詳細はこちら。

指標

バージョン3のレポートAPIでは、広告プロダクト全体の命名を標準化する新しい指標名や列名が導入されました。

指標の比較

| バージョン2の指標名 | バージョン3の列名 | | | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | | asin | advertisedAsin | | attributedConversions1d | purchases1d | | attributedConversions7d | purchases7d | | attributedConversions14d | purchases14d | | attributedConversions30d | purchases30d | | attributedConversions1dSameSKU | purchasesSameSku1d | | attributedConversions7dSameSKU | purchasesSameSku7d | | attributedConversions14dSameSKU | purchasesSameSku14d | | attributedConversions30dSameSKU | purchasesSameSku30d | | attributedUnitsOrdered1d | unitsSoldClicks1d | | attributedUnitsOrdered7d | unitsSoldClicks7d | | attributedUnitsOrdered14d | unitsSoldClicks14d | | attributedUnitsOrdered30d | unitsSoldClicks30d | | attributedSales1d | sales1d | | attributedSales7d | sales7d | | attributedSales14d | sales14d | | attributedSales30d | sales30d | | attributedSales1dSameSKU | attributedSalesSameSku1d | | attributedSales7dSameSKU | attributedSalesSameSku7d | | attributedSales14dSameSKU | attributedSalesSameSku14d | | attributedSales30dSameSKU | attributedSalesSameSku30d | | attributedUnitsOrdered1dSameSKU | unitsSoldSameSku1d | | attributedUnitsOrdered7dSameSKU | unitsSoldSameSku7d | | attributedUnitsOrdered14dSameSKU | unitsSoldSameSku14d | | attributedUnitsOrdered30dSameSKU | unitsSoldSameSku30d | | attributedUnitsOrdered1dOtherSKU | unitsSoldOtherSku1d | | attributedUnitsOrdered7dOtherSKU | unitsSoldOtherSku7d | | attributedUnitsOrdered14dOtherSKU | unitsSoldOtherSku14d | | attributedUnitsOrdered30dOtherSKU | unitsSoldOtherSku30d | | attributedSales1dOtherSKU | salesOtherSku1d | | attributedSales7dOtherSKU | salesOtherSku7d | | attributedSales14dOtherSKU | salesOtherSku14d | | attributedSales30dOtherSKU | salesOtherSku30d | | attributedConversions1dOtherSKU | purchasesOtherSku1d | | attributedConversions7dOtherSKU | purchasesOtherSku7d | | attributedConversions14dOtherSKU | purchasesOtherSku14d | | attributedConversions30dOtherSKU | purchasesOtherSku30d | | attributedKindleEditionNormalizedPagesRead14d | kindleEditionNormalizedPagesRead14d | | attributedKindleEditionNormalizedPagesRoyalties14d | kindleEditionNormalizedPagesRoyalties14d | | keywordText | keyword | | currency | campaignBudgetCurrencyCode | | campaignRuleBasedBudget | campaignRuleBasedBudgetAmount | | applicableBudgetRuleId | campaignApplicableBudgetRuleId | | applicableBudgetRuleName | campaignApplicableBudgetRuleName | | otherAsin | purchasedAsin | | targetingText | targeting | | placement | placementClassification |
| newToBrandOrders14d | newToBrandPurchases14d | | newToBrandOrdersPercentage14d | newToBrandPurchasesPercentage14d | | campaignBudget | campaignBudgetAmount | | biddingStrategy | campaignBiddingStrategy | | sku | advertisedSku | | query | searchTerm | | targetId | keywordId | | keywordStatus | adKeywordStatus | | targetingExpression | keyword | | targetingType | keywordType |

新しい指標

バージョン3では、以下の新しい指標も導入されています。purchaseClickRate1d、purchaseClickRate7d、purchaseClickRate14d、purchaseClickRate30d、costPerClick、acos7d、roas7d、clickThroughRate、impressions1y、clicks1y、spend1y、costPerClick1y、attributionType、productName、productCategory、date、startDate、endDate、acosClicks7d、acosClicks14d、roasClicks7d、roasClicks14d。

注

バージョン3では、bidPlus指標はサポートされません。この機能は2019年に廃止されました。

レポート期間の延長

• レポートタイプの多くが95日間（バージョン2では最大60日間）のレポート期間をサポートするようになりました。
• 日別レポートまたは概要レポートから選択できます。
• レポートには複数日分のデータが含まれる場合があります。日数はレポートタイプによって決まります。詳細は、レポートタイプを参照してください。

ディメンションレポートデータ

バージョン2の一部のレポートタイプでは、リクエストした日に特定のエンティティのパフォーマンスデータが存在するかどうかにかかわらず、過去のキャンペーンエンティティがすべて含まれます。バージョン3のレポートでは、指定した期間にパフォーマンスアクティビティ（クリック、インプレッション、広告起因の購入など）が存在するレコードのみがレポートに含まれます。

スポンサープロダクト広告のデータ品質に関する解決済みの問題

バージョン2には、スポンサープロダクト広告のデータ品質に関する既知の問題が2つありました。

1. ごく一部ですが、スポンサープロダクト広告レポートにスポンサーディスプレイ広告のパフォーマンスデータが含まれていることがありました。
2. ごく一部ですが、スポンサープロダクト広告レポートにキャンペーンデータの一部が含まれていないことがありました。

バージョン3のレポートAPIでは、これらの問題は解決されています。