開発者ガイドの概要

Amazon Ads APIの概要

このガイドでは、バージョン3のレポートに使用可能なすべての列について解説します。

ヒント

バージョン2とバージョン3の指標の比較については、移行ガイドをご覧ください。

acosClicks14d

タイプ: Double

説明: 広告のクリックから14日以内に行われた購入に基づく広告費売上高比率。

レポートタイプターゲティング広告対象商品検索用語

acosClicks7d

タイプ: Double

説明: 広告のクリックから7日以内に行われた購入に基づく広告費売上高比率。

レポートタイプターゲティング広告対象商品検索用語

adGroupId

タイプ: Integer

説明: 広告グループ固有の数値ID。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

adGroupName

タイプ: String

説明: 広告主様が入力した広告グループの名前。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

adId

タイプ: Integer

説明: 広告固有の数値ID。

レポートタイプ広告対象商品

adKeywordStatus

タイプ: String

説明: キーワードの現在のステータス。

レポートタイプターゲティング検索用語

adStatus

タイプ: String

説明: 広告グループのステータス。

レポートタイプキャンペーン

advertisedAsin

タイプ: String

説明: 広告対象商品に紐づけられたASIN。

レポートタイプ広告対象商品購入商品

advertisedSku

タイプ: String

説明: 広告掲載されているSKU。お取引企業様はご利用いただけません。

レポートタイプ広告対象商品購入商品

attributedSalesSameSku14d

タイプ: Double

説明: 購入されたSKUが広告掲載されたSKUと同一場合で、広告のクリックから14日以内に発生した売上の合計金額。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

attributedSalesSameSku1d

タイプ: Double

説明: 購入されたSKUが広告掲載されたSKUと同一の場合で、広告のクリックから1日以内に発生した売上の合計金額。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

attributedSalesSameSku30d

タイプ: Double

説明: 購入されたSKUが広告掲載されたSKUと同一の場合で、広告のクリックから30日以内に発生した売上の合計金額。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

attributedSalesSameSku7d

タイプ: Double

説明: 購入されたSKUが広告掲載されたSKUと同一の場合で、広告のクリックから7日以内に発生した売上の合計金額。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

attributionType

タイプ: String

説明: 購入が広告掲載商品によるものか、ブランドハロー効果によるものかを示します。

レポートタイプ購入商品

campaignApplicableBudgetRuleId

タイプ: String

説明: キャンペーンのアクティブな予算ルールに紐づけられているID。

レポートタイプキャンペーン

campaignApplicableBudgetRuleName

タイプ: String

説明: キャンペーンの有効な予算ルールに紐づけられている名称。

レポートタイプキャンペーン

campaignBiddingStrategy

タイプ: String

説明: キャンペーンに紐づけられている入札戦略。

レポートタイプキャンペーン

campaignBudgetAmount

タイプ: Decimal

説明: キャンペーンに割り当てられた予算合計。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

campaignBudgetCurrencyCode

タイプ: String

説明: キャンペーンに紐づけられている通貨コード。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

campaignBudgetType

タイプ: String

説明dailyまたはlifetimeのいずれか。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

campaignId

タイプ: Integer

説明: キャンペーンに紐づけられているID。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

campaignName

タイプ: String

説明: キャンペーンに紐づけられている名前。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

campaignRuleBasedBudgetAmount

タイプ: Decimal

説明: キャンペーンのルールベースの予算金額。

レポートタイプキャンペーン

campaignStatus

タイプ: String

説明: キャンペーンのステータス。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

clicks

タイプ: Integer

説明: 広告クリックの合計数。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

clickThroughRate

タイプ: Decimal

説明: クリック数をインプレッション数で割った値。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

cost

タイプ: Decimal

説明: 広告クリックの合計コスト。spendと同じです。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

costPerClick

タイプ: Decimal

説明: 合計コストを合計クリック数で割った値。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

date

タイプ: String

説明: 広告アクティビティが発生した日付(YYYY-MM-DD形式)。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

endDate

タイプ: String

説明: レポートの概要期間の終了日(YYYY-MM-DD形式)。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

impressions

タイプ: Integer

説明: 広告インプレッションの合計数。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

keyword

タイプ: String

説明: キーワードのテキストまたはターゲティングエクスプレッションの表現。ターゲットの場合、同じ値がtargeting指標で返されます。

レポートタイプターゲティング購入商品検索用語

keywordBid

タイプ: Decimal

説明: キーワードまたはターゲティングエクスプレッションに紐づけられている入札。

レポートタイプターゲティング検索用語

keywordId

タイプ: Integer

説明: キーワードまたはターゲティングエクスプレッションに紐づけられているID。

レポートタイプターゲティング購入商品検索用語

keywordType

タイプ: String

説明: 入札に使用されたキーワードと一致するタイプ。キーワードの場合、 BROADPHRASE、またはEXACTのいずれかです。ターゲティングエクスプレッションの場合、TARGETING_EXPRESSIONまたはTARGETING_EXPRESSION_PREDEFINEDのいずれかです。matchTypeと同じです

レポートタイプターゲティング購入商品検索用語

kindleEditionNormalizedPagesRead14d

タイプ: Integer

説明: 広告のクリックから14日以内に読まれた広告起因のKindle Edition Normalized Pagesの数。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

kindleEditionNormalizedPagesRoyalties14d

タイプ: Decimal

説明: 広告のクリックから14日以内に広告起因で読まれた、推定Kindle Edition Normalized Pagesのロイヤリティの推定値。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

matchType

タイプ: String

説明: 入札に使用されたキーワードと一致するタイプ。キーワードの場合、 BROADPHRASE、またはEXACTのいずれかです。ターゲティングエクスプレッションの場合、TARGETING_EXPRESSIONまたはTARGETING_EXPRESSION_PREDEFINEDのいずれかです。keywordTypeと同じです。

レポートタイプターゲティング購入商品検索用語

newToBrandPurchases14d

タイプ: Integer

説明: 過去1年のルックバックウィンドウにおける新規顧客によるブランド商品の注文数。書籍のお取引企業様はご利用いただけません。

レポートタイプ購入商品

newToBrandPurchasesPercentage14d

タイプ: Decimal

説明: ブランド新規顧客による注文合計の割合(%)。書籍のお取引企業様はご利用いただけません。

レポートタイプ購入商品

newToBrandSales14d

タイプ: Decimal

説明: 広告のクリックから14日以内に発生したブランド新規顧客による売上の合計金額。書籍のお取引企業様はご利用いただけません。

レポートタイプ購入商品

newToBrandSalesPercentage14d

タイプ: Decimal

説明: 総売上に占めるブランド新規顧客による購入の割合。書籍のお取引企業様はご利用いただけません。

レポートタイプ購入商品

newToBrandUnitsSold14d

タイプ: Integer

説明: 広告のクリックから14日以内に発生したブランド新規顧客の売上の一部として注文された広告起因の商品点数の合計数。書籍のお取引企業様はご利用いただけません。

レポートタイプ購入商品

newToBrandUnitsSoldPercentage14d

タイプ: Decimal

説明: 広告のクリックから14日以内に注文された、ブランド新規顧客の購入の一部である広告起因の合計商品点数の割合。書籍のお取引企業様はご利用いただけません。

レポートタイプ購入商品

orders14d

タイプ: Integer

説明: 過去14日以内の注文。

レポートタイプ購入商品

placementClassification

タイプ: String

説明: 広告が表示されたページの中の位置。

レポートタイプキャンペーン

portfolioId

タイプ: Integer

説明: キャンペーンが紐づけられているポートフォリオ。

レポートタイプターゲティング広告対象商品購入商品検索用語

productCategory

タイプ: String

説明: Amazon内に商品が紐づけられているカテゴリー。

レポートタイプ購入商品

productName

タイプ: String

説明: 商品の名前。

レポートタイプ購入商品

purchasedAsin

タイプ: String

説明: 購入された商品のASIN。

レポートタイプ購入商品

purchases14d

タイプ: Integer

説明: 広告のクリックから14日以内に発生した広告起因のコンバージョンイベント数。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

purchases1d

タイプ: Integer

説明: 広告のクリックから1日以内に発生したASIN別コンバージョンイベント数。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

purchases30d

タイプ: Integer

説明: 広告のクリックから30日以内に発生した広告起因のコンバージョンイベント数。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

purchases7d

タイプ: Integer

説明: 広告のクリックから7日以内に発生したASIN別コンバージョンイベント数。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

purchasesOtherSku14d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから14日以内に発生したASIN別コンバージョンイベント数。

レポートタイプ購入商品

purchasesOtherSku1d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから1日以内に発生したASIN別コンバージョンイベント数。

レポートタイプ購入商品

purchasesOtherSku30d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから30日以内に発生したASIN別コンバージョンイベント数。

レポートタイプ購入商品

purchasesOtherSku7d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから7日以内に発生したASIN別コンバージョンイベント数。

レポートタイプ購入商品

purchasesSameSku14d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと同じ場合で、広告のクリックから14日以内に発生した広告起因のコンバージョンイベント数。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

purchasesSameSku1d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと同じ場合で、広告のクリックから1日以内に発生したASIN別コンバージョンイベント数。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

purchasesSameSku30d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと同じ場合で、広告のクリックから30日以内に発生した広告起因のコンバージョンイベント数。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

purchasesSameSku7d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと同じ場合で、広告のクリックから7日以内に発生したASIN別コンバージョンイベント数。

レポートタイプキャンペーンターゲティング広告対象商品検索用語

roasClicks14d

タイプ: Decimal

説明: 広告のクリックから14日以内に行われた購入に基づく広告費用対効果。

レポートタイプターゲティング広告対象商品検索用語

roasClicks7d

タイプ: Decimal

説明: 広告のクリックから7日以内に行われた購入に基づく広告費用対効果。

レポートタイプターゲティング広告対象商品検索用語

sales14d

タイプ: Decimal

説明: 広告のクリックから14日以内に発生した売上の合計金額。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

sales1d

タイプ: Decimal

説明: 広告のクリックから1日以内に発生した売上の合計金額。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

sales30d

タイプ: Decimal

説明: 広告のクリックから30日以内に発生した売上の合計金額。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

sales7d

タイプ: Decimal

説明: 広告のクリックから7日以内に発生した売上の合計金額。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

salesOtherSku14d

タイプ: Decimal

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから14日以内に発生した売上の合計金額。

レポートタイプ購入商品

salesOtherSku1d

タイプ: Decimal

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから1日以内に発生した売上の合計金額。

レポートタイプ購入商品

salesOtherSku30d

タイプ: Decimal

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから30日以内に発生した売上の合計金額。

レポートタイプ購入商品

salesOtherSku7d

タイプ: Decimal

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから7日以内に発生した売上の合計金額。

レポートタイプ購入商品ターゲティング広告対象商品検索用語

searchTerm

タイプ: String

説明: お客様が使用した検索用語。

レポートタイプ検索用語

spend

タイプ: Decimal

説明: 広告クリックの合計コスト。costと同じです。

レポートタイプキャンペーン広告対象商品

startDate

タイプ: String

説明: レポートの概要期間の開始日(YYYY-MM-DD形式)。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

targeting

タイプ: String

説明: targeting句で使用されるエクスプレッションオブジェクトの文字列表現。targetingエクスプレッションは、keywordでも返されます。

レポートタイプターゲティング購入商品検索用語

topOfSearchImpressionShare

タイプ: Decimal

説明: 特定の期間において対象となったすべての検索結果上部のインプレッションのうち、獲得した検索結果上部のインプレッション数の割合。インプレッションの適格性は、キャンペーンステータスやターゲティングステータスなど、さまざまな要因によって決まります。

レポートタイプキャンペーンターゲティング

unitsSold14d

タイプ: Integer

説明: 広告のクリックから14日以内に注文された広告起因の商品点数。unitsSoldClicks14dと同じです。スポンサーブランド広告バージョン3のキャンペーンに対してのみ有効であり、スポンサーブランド動画広告やマルチ広告グループ(バージョン4)のキャンペーンに対しては有効ではありません。

レポートタイプ購入商品

unitsSoldClicks14d

タイプ: Integer

説明: 広告のクリックから14日以内に注文された商品の合計点数。unitsSold14dと同じです

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

unitsSoldClicks1d

タイプ: Integer

説明: 広告のクリックから1日以内に注文された商品点数の合計数。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

unitsSoldClicks30d

タイプ: Integer

説明: 広告のクリックから30日以内に注文された商品点数の合計数。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

unitsSoldClicks7d

タイプ: Integer

説明: 広告のクリックから7日以内に注文された商品点数の合計数。

レポートタイプキャンペーンターゲティング広告対象商品購入商品検索用語

unitsSoldOtherSku14d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから14日以内に注文された商品点数の合計数。

レポートタイプ購入商品

unitsSoldOtherSku1d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから1日以内に注文された商品点数の合計数。

レポートタイプ購入商品

unitsSoldOtherSku30d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから30日以内に注文された商品点数の合計数。

レポートタイプ購入商品

unitsSoldOtherSku7d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと異なっていた場合で、広告のクリックから7日以内に注文された商品点数の合計数。

レポートタイプ購入商品購入商品ターゲティング広告対象商品検索用語

unitsSoldSameSku14d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと同じ場合で、広告のクリックから14日以内に注文された商品点数の合計数。

レポートタイプターゲティング広告対象商品購入商品検索用語

unitsSoldSameSku1d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと同じ場合で、広告のクリックから1日以内に注文された商品点数の合計数。

レポートタイプターゲティング広告対象商品購入商品検索用語

unitsSoldSameSku30d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと同じ場合で、広告のクリックから30日以内に注文された商品点数の合計数。

レポートタイプターゲティング広告対象商品購入商品検索用語

unitsSoldSameSku7d

タイプ: Integer

説明: 購入されたSKUが広告掲載されたSKUと同じ場合で、広告のクリックから7日以内に注文された商品点数の合計数。

レポートタイプターゲティング広告対象商品購入商品検索用語