Method: accounts.reports.search

検索クエリで定義されたレポートを取得します。レスポンスに含まれる行数は、pageSize で指定された行数より少ない場合があります。リクエストする行がさらにあるかどうかを判断するには、nextPageToken を使用します。

HTTP リクエスト

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。呼び出し元のアカウントの ID。スタンドアロン アカウントまたは MCA サブアカウントである必要があります。形式: accounts/{account}

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
フィールド
query

string

必須。取得するレポートを定義するクエリ。

クエリの作成方法の詳細については、クエリ言語ガイドをご覧ください。使用可能なテーブルとフィールドの一覧については、「使用可能なフィールド」をご覧ください。

pageSize

integer

省略可。1 ページで取得する ReportRows の数。デフォルトは 1,000 です。5,000 を超える値は 5,000 に強制変換されます。

pageToken

string

省略可。取得するページのトークン。指定しない場合、結果の最初のページが返されます。結果の次のページをリクエストするには、前のレスポンスの nextPageToken から取得した値を使用する必要があります。

レスポンスの本文

ReportService.Search メソッドに対するレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
フィールド
results[]

object (ReportRow)

検索クエリに一致した行。

nextPageToken

string

次のページを取得するために pageToken として送信できるトークン。省略すると、後続のページはなくなります。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/content

詳しくは、OAuth 2.0 の概要をご覧ください。

ReportRow

検索クエリから返された結果の行。

クエリされたテーブルに対応するメッセージのみがレスポンスに入力されます。入力されたメッセージ内では、クエリで明示的にリクエストされたフィールドのみが入力されます。

JSON 表現
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
フィールド
productPerformanceView

object (ProductPerformanceView)

productPerformanceView テーブルのクエリに使用できるフィールド。

nonProductPerformanceView

object (NonProductPerformanceView)

nonProductPerformanceView テーブルのクエリに使用できるフィールド。

productView

object (ProductView)

productView テーブルのクエリに使用できるフィールド。

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

priceCompetitivenessProductView テーブルのクエリに使用できるフィールド。

priceInsightsProductView

object (PriceInsightsProductView)

priceInsightsProductView テーブルのクエリに使用できるフィールド。

bestSellersProductClusterView

object (BestSellersProductClusterView)

bestSellersProductClusterView テーブルのクエリに使用できるフィールド。

bestSellersBrandView

object (BestSellersBrandView)

bestSellersBrandView テーブルのクエリに使用できるフィールド。

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

competitiveVisibilityCompetitorView テーブルのクエリに使用できるフィールド。

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

competitiveVisibilityTopMerchantView テーブルのクエリに使用できるフィールド。

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

competitiveVisibilityBenchmarkView テーブルのクエリに使用できるフィールド。

ProductPerformanceView

productPerformanceView テーブルのクエリに使用できるフィールド。

アカウントの商品のパフォーマンス データ。パフォーマンス指標(例: clicks)や、パフォーマンス指標の分割項目(例: offerId)が含まれます。商品ディメンションの値(offerId など)は、インプレッション発生時の商品の状態を反映します。

クエリでセグメント フィールドを選択するには、指標フィールドを 1 つ以上選択する必要があります。

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

JSON 表現
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
フィールド
date

object (Date)

指標が適用される販売者のタイムゾーンの日付。セグメント。

WHERE 句には date の条件が必要です。

week

object (Date)

販売者のタイムゾーンでの指標の日付の週の初日(月曜日)。セグメント。

conversionValue

object (Price)

コンバージョンの日付でレポートされた、商品に起因するコンバージョンの値。指標。

FREE トラフィック ソースでのみ使用できます。

marketingMethod

enum (MarketingMethodEnum)

指標が適用されるマーケティング方法。セグメント。

customerCountryCode

string

イベントの開催時点でお客様が居住している国のコード。ISO 3166 形式で表されます。セグメント。

顧客の国を特定できない場合は、特殊な「ZZ」コードが返されます。

offerId

string

販売者が指定した商品 ID。セグメント。

title

string

商品のタイトル。セグメント。

brand

string

商品のブランド。セグメント。

categoryL1

string

商品カテゴリ(第 1 レベル): Google の商品分類。セグメント。

categoryL2

string

商品カテゴリ(第 2 レベル): Google の商品分類。セグメント。

categoryL3

string

商品カテゴリ(第 3 レベル): Google の商品分類。セグメント。

categoryL4

string

Google の商品分類の商品カテゴリ(第 4 レベル)。セグメント。

categoryL5

string

商品カテゴリ(第 5 レベル): Google の商品分類。セグメント。

productTypeL1

string

商品カテゴリ(第 1 レベル): 販売者独自の商品分類。セグメント。

productTypeL2

string

商品カテゴリ(第 2 レベル): 販売者独自の商品分類。セグメント。

productTypeL3

string

商品カテゴリ(第 3 レベル): 販売者独自の商品分類。セグメント。

productTypeL4

string

商品カテゴリ(第 4 レベル): 販売者独自の商品分類。セグメント。

productTypeL5

string

商品カテゴリ(第 5 レベル): 販売者独自の商品分類。セグメント。

customLabel0

string

カスタムラベル 0: 商品のカスタムグループ化に使用します。セグメント。

customLabel1

string

商品のカスタム グループ用のカスタムラベル 1。セグメント。

customLabel2

string

カスタムラベル 2(商品のカスタム グループ用)。セグメント。

customLabel3

string

カスタムラベル 3: 商品のカスタム グループ。セグメント。

customLabel4

string

カスタムラベル 4: 商品のカスタム グループ。セグメント。

clicks

string (int64 format)

クリック数。指標。

impressions

string (int64 format)

販売者の商品が表示された回数。指標。

clickThroughRate

number

クリック率 - 販売者の商品が獲得したクリック数(クリック数)を、商品が表示された回数(インプレッション数)で割った値。指標。

conversions

number

商品に起因するコンバージョンの数で、コンバージョンの日付でレポートされます。アトリビューション モデルによっては、コンバージョンが複数のクリックに分配され、各クリックに独自の貢献度が割り当てられます。この指標は、すべてのクレジットの合計です。指標。

FREE トラフィック ソースでのみ使用できます。

conversionRate

number

コンバージョン数をクリック数で割った値。インプレッションの日付でレポートされます。指標。

FREE トラフィック ソースでのみ使用できます。

MarketingMethodEnum

マーケティング方法の値。

列挙型
MARKETING_METHOD_ENUM_UNSPECIFIED 指定されていません。
ORGANIC オーガニック マーケティング
ADS 広告ベースのマーケティング。

NonProductPerformanceView

nonProductPerformanceView テーブルのクエリに使用できるフィールド。

商品以外のページにつながる画像やオンライン ショップのリンクのパフォーマンス データ。これには、掲載結果の指標(例: clicks)や、パフォーマンス指標の分割方法に応じたディメンション(例: date)が含まれます。

クエリでセグメント フィールドを選択するには、指標フィールドを 1 つ以上選択する必要があります。

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

JSON 表現
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
フィールド
date

object (Date)

指標が適用される販売者のタイムゾーンの日付。セグメント。

WHERE 句には date の条件が必要です。

week

object (Date)

販売者のタイムゾーンでの指標の日付の週の初日(月曜日)。セグメント。

clicks

string (int64 format)

商品以外のページにつながる画像やオンライン ショップのリンクがクリックされた回数。指標。

impressions

string (int64 format)

商品以外のページにつながる画像やオンライン ショップのリンクが表示された回数です。指標。

clickThroughRate

number

クリック率 - クリック数(clicks)を、商品以外のページにつながる画像およびオンライン ショップ リンクのインプレッション数(impressions)で割った値。指標。

ProductView

productView テーブルのクエリに使用できるフィールド。

現在の在庫の商品。この表の商品は Products サブ API のものと同じですが、Products サブ API のすべての商品属性がこの表のクエリに使用できるわけではありません。Products サブ API とは対照的に、この表では、返される商品のリストを商品属性でフィルタできます。id で単一の商品を取得したり、すべての商品を一覧表示するには、Products サブ API を使用する必要があります。

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

JSON 表現
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
フィールド
price

object (Price)

商品の価格です。商品の価格に関する情報が利用できない場合は省略します。

gtin[]

string

商品の国際取引商品番号(GTIN)のリスト。

creationTime

string (Timestamp format)

販売者が商品を作成した時刻のタイムスタンプ(秒)。

expirationDate

object (Date)

挿入時に指定された商品の有効期限。

itemIssues[]

object (ItemIssue)

商品の商品アイテムに関する問題の一覧。

このフィールドは、結果の並べ替えには使用できません。

このフィールドで選択した属性(itemIssues.severity.aggregated_severity など)のみを、結果のフィルタリングに使用できます。

clickPotential

enum (ClickPotential)

販売者の最もパフォーマンスの高い商品と比較した場合の、見込まれる成果。

id

string

プロダクトの REST ID(channel~languageCode~feedLabel~offerId の形式)。商品を操作する Merchant API メソッドは、このパラメータを name パラメータとして受け取ります。

SELECT 句では必須。

channel

enum (ChannelEnum)

商品のチャネル。ONLINE または LOCAL のいずれかです。

languageCode

string

商品の言語コード(BCP 47 形式)。

feedLabel

string

商品のフィードラベル。

offerId

string

販売者が指定した商品 ID。

title

string

商品のタイトル。

brand

string

商品のブランド。

categoryL1

string

Google の商品分類の商品カテゴリ(第 1 レベル)。

categoryL2

string

Google の商品分類の商品カテゴリ(第 2 レベル)。

categoryL3

string

Google の商品分類の商品カテゴリ(第 3 レベル)。

categoryL4

string

Google の商品分類の商品カテゴリ(第 4 レベル)。

categoryL5

string

Google の商品分類の商品カテゴリ(第 5 レベル)。

productTypeL1

string

販売者独自の商品分類の商品カテゴリ(第 1 レベル)。

productTypeL2

string

販売者独自の商品分類の商品カテゴリ(第 2 レベル)。

productTypeL3

string

販売者独自の商品分類の商品カテゴリ(第 3 レベル)。

productTypeL4

string

販売者独自の商品分類の商品カテゴリ(第 4 レベル)。

productTypeL5

string

販売者独自の商品分類の商品カテゴリ(第 5 レベル)。

condition

string

商品の状態

availability

string

商品の在庫状況

shippingLabel

string

データソースで指定された正規化された送料ラベル

itemGroupId

string

バリエーションをグループ化するために販売者が指定する商品グループ ID。

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

集計ステータス。

clickPotentialRank

string (int64 format)

クリックの可能性に基づく商品のランク。clickPotentialRank 1 の商品は、検索クエリの条件を満たす販売者の商品の中で、クリックの可能性が最も高い商品です。

AggregatedReportingContextStatus

すべてのレポート コンテキストについて集計された商品のステータス。

集計ステータスの計算方法の例を次に示します。

無料リスティング ショッピング広告 ステータス
承認しました 承認しました 有効
承認しました 保留 有効
承認しました 不承認 ELIGIBLE_LIMITED
保留 保留 保留中
不承認 不承認 NOT_ELIGIBLE_OR_DISAPPROVED
列挙型
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED 指定されていません。
NOT_ELIGIBLE_OR_DISAPPROVED すべてのレポートにおいて、商品が無効であるか、不承認となっています。
PENDING すべての報告のコンテキストで、商品のステータスが保留になっています。
ELIGIBLE_LIMITED プロダクトは一部の(すべてではない)報告コンテキストの対象です。
ELIGIBLE プロダクトはすべてのレポート コンテキストで有効です。

ItemIssue

商品に関連する商品アイテムの問題。

JSON 表現
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
フィールド
type

object (ItemIssueType)

商品アイテムに関する問題の種類。

severity

object (ItemIssueSeverity)

商品アイテムの問題の重大度。

resolution

enum (ItemIssueResolution)

アイテムの問題解決。

ItemIssueType

問題の種類。

JSON 表現
{
  "code": string,
  "canonicalAttribute": string
}
フィールド
code

string

問題のエラーコード。プロダクトの問題code に相当します。

canonicalAttribute

string

属性固有の問題に対する正規の属性名。

ItemIssueSeverity

問題が商品の配信にどのように影響するか。

JSON 表現
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
フィールド
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

レポート コンテキストごとの問題の重大度。

aggregatedSeverity

enum (AggregatedIssueSeverity)

影響を受けるすべてのレポート コンテキストにおける問題の集約された重大度。

このフィールドは、結果のフィルタリングに使用できます。

IssueSeverityPerReportingContext

レポート コンテキストごとの問題の重大度。

JSON 表現
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
フィールド
disapprovedCountries[]

string

レポートのコンテキストにおける不承認の国のリスト(ISO 3166 形式)。

demotedCountries[]

string

レポートのコンテキストで降格された国のリスト(ISO 3166 形式)。

reportingContext

enum (ReportingContextEnum)

問題に該当する報告のコンテキスト。

AggregatedIssueSeverity

すべてのレポート コンテキストについて集計した問題の重大度。

列挙型
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED 指定されていません。
DISAPPROVED 問題により、少なくとも 1 つの報告コンテキストで商品が不承認となっています。
DEMOTED 問題により、影響を受けるすべての報告のコンテキストで商品の順位が下がります。
PENDING 問題の解決策は PENDING_PROCESSING です。

ItemIssueResolution

問題の解決方法。

列挙型
ITEM_ISSUE_RESOLUTION_UNSPECIFIED 指定されていません。
MERCHANT_ACTION 販売者がこの問題を修正する必要があります。
PENDING_PROCESSING 問題は自動的に(画像のクロールなど)か、Google の審査によって解決されます。現時点で、販売者による対応は必要ありません。解決策が別の問題につながる可能性があります(クロールの失敗など)。

ClickPotential

商品のクリックの可能性は、販売者の最もパフォーマンスの高い商品と比較した場合の、パフォーマンスの可能性を示すものです。商品のクリックの可能性によって、修正すべき商品に優先順位を付け、商品が本来のポテンシャルに照らしてどの程度のパフォーマンスを発揮しているかを把握できます。

列挙型
CLICK_POTENTIAL_UNSPECIFIED 予測されるクリック数への影響が不明です。
LOW 販売者の最もパフォーマンスの高い商品と比較して、クリック数が少ない可能性があります。
MEDIUM 販売者の最もパフォーマンスの高い商品と比較すると、そこそこのクリック数が得られる可能性があります。
HIGH 販売者の最もパフォーマンスの高い商品と同程度のクリック数が得られる可能性があります。

PriceCompetitivenessProductView

priceCompetitivenessProductView テーブルのクエリに使用できるフィールド。

価格競争力レポート。

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

JSON 表現
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
フィールド
price

object (Price)

商品の現在の価格。

benchmarkPrice

object (Price)

ベンチマーク対象の国での商品のカタログで利用可能な最新の価格ベンチマーク。

reportCountryCode

string

価格ベンチマークの国。ISO 3166 形式で表されます。

SELECT 句では必須。

id

string

プロダクトの REST ID(channel~languageCode~feedLabel~offerId の形式)。データを productView テーブルと結合するために使用できます。

SELECT 句では必須。

offerId

string

販売者が指定した商品 ID。

title

string

商品のタイトル。

brand

string

商品のブランド。

categoryL1

string

Google の商品分類の商品カテゴリ(第 1 レベル)。

categoryL2

string

Google の商品分類の商品カテゴリ(第 2 レベル)。

categoryL3

string

Google の商品分類の商品カテゴリ(第 3 レベル)。

categoryL4

string

Google の商品分類の商品カテゴリ(第 4 レベル)。

categoryL5

string

Google の商品分類の商品カテゴリ(第 5 レベル)。

productTypeL1

string

販売者独自の商品分類の商品カテゴリ(第 1 レベル)。

productTypeL2

string

販売者独自の商品分類の商品カテゴリ(第 2 レベル)。

productTypeL3

string

販売者独自の商品分類の商品カテゴリ(第 3 レベル)。

productTypeL4

string

販売者独自の商品分類の商品カテゴリ(第 4 レベル)。

productTypeL5

string

販売者独自の商品分類の商品カテゴリ(第 5 レベル)。

PriceInsightsProductView

priceInsightsProductView テーブルのクエリに使用できるフィールド。

価格分析レポート

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

JSON 表現
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
フィールド
price

object (Price)

商品の現在の価格。

suggestedPrice

object (Price)

商品の最新の提案価格。

effectiveness

enum (Effectiveness)

バケット化した価格提案の適用によって予測される効果。

id

string

プロダクトの REST ID(channel~languageCode~feedLabel~offerId の形式)。データを productView テーブルと結合するために使用できます。

SELECT 句では必須。

offerId

string

販売者が指定した商品 ID。

title

string

商品のタイトル。

brand

string

商品のブランド。

categoryL1

string

Google の商品分類の商品カテゴリ(第 1 レベル)。

categoryL2

string

Google の商品分類の商品カテゴリ(第 2 レベル)。

categoryL3

string

Google の商品分類の商品カテゴリ(第 3 レベル)。

categoryL4

string

Google の商品分類の商品カテゴリ(第 4 レベル)。

categoryL5

string

Google の商品分類の商品カテゴリ(第 5 レベル)。

productTypeL1

string

販売者独自の商品分類の商品カテゴリ(第 1 レベル)。

productTypeL2

string

販売者独自の商品分類の商品カテゴリ(第 2 レベル)。

productTypeL3

string

販売者独自の商品分類の商品カテゴリ(第 3 レベル)。

productTypeL4

string

販売者独自の商品分類の商品カテゴリ(第 4 レベル)。

productTypeL5

string

販売者独自の商品分類の商品カテゴリ(第 5 レベル)。

predictedImpressionsChangeFraction

number

提案価格の導入後に予測される、現在の有効な価格に対するインプレッション数の変化の割合。たとえば、0.05 はインプレッション数の予測増加率が 5% であることを表します。

predictedClicksChangeFraction

number

提案価格の導入後に予測されるクリック数の変化を、現在の有効な価格と比較したものです。たとえば、0.05 はクリック数の予測増加率が 5% であることを表します。

predictedConversionsChangeFraction

number

提案価格の導入後に予測されるコンバージョン数の変化を、現在の有効な価格と比較したものです。たとえば、0.05 はコンバージョン数の増加が 5% であると予測されます)。

有効性

有効性の予測値。

有効性は、価格変更のメリットが最も大きい商品を示します。この評価では、セール価格を調整することで予測されるパフォーマンスの向上と、現在の価格と提案価格の差額が考慮されます。有効性が HIGH の価格提案は、パフォーマンスの向上に最も大きく貢献すると予測されています。

列挙型
EFFECTIVENESS_UNSPECIFIED 有効性は不明です。
LOW 有効性が低い。
MEDIUM 効果は中程度。
HIGH 効果は高い。

BestSellersProductClusterView

bestSellersProductClusterView テーブルのクエリに使用できるフィールド。

上位の商品クラスタを含むベストセラー レポート。商品クラスタとは、同じ商品(Google Pixel 7 など)を表すさまざまなオファーやバリエーションのグループです。

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

JSON 表現
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
フィールド
reportDate

object (Date)

レポートの日付。このフィールドの値には、次のいずれかのみを指定できます。

  • 週次レポートの場合は 週の初日(月曜日)です
  • 月次レポートの月の初日。

SELECT 句では必須。reportDateWHERE 条件がクエリで指定されていない場合は、利用可能な最新の週次または月次レポートが返されます。

variantGtins[]

string

商品クラスタのバリエーションのサンプルの GTIN。

reportGranularity

enum (ReportGranularityEnum)

レポートの粒度。ランキングは、1 週間または 1 か月単位で行えます。

SELECT 句では必須。WHERE 句には reportGranularity の条件が必要です。

reportCountryCode

string

ランキングを計算する国。ISO 3166 形式で表されます。

SELECT 句では必須。WHERE 句には reportCountryCode の条件が必要です。

reportCategoryId

string (int64 format)

ランキングを計算するための Google 商品カテゴリ ID。Google の商品分類で表されます。

SELECT 句では必須。reportCategoryIdWHERE 条件がクエリで指定されていない場合は、すべての最上位カテゴリのランキングが返されます。

title

string

商品クラスタのタイトル。

brand

string

商品クラスタのブランド。

categoryL1

string

商品クラスタの商品カテゴリ(第 1 レベル)。Google の商品分類で表されます。

categoryL2

string

商品クラスタの商品カテゴリ(第 2 レベル)。Google の商品分類で表されます。

categoryL3

string

商品クラスタの商品カテゴリ(第 3 レベル)。Google の商品分類で表されます。

categoryL4

string

商品クラスタの商品カテゴリ(第 4 レベル)。Google の商品分類で表されます。

categoryL5

string

商品クラスタの商品カテゴリ(第 5 レベル)。Google の商品分類で表されます。

inventoryStatus

enum (InventoryStatus)

少なくとも 1 つの国の商品データソースで商品クラスタが IN_STOCK、すべての国の商品データソースで OUT_OF_STOCK、または NOT_IN_INVENTORY のいずれであるかを指定します。

この項目にはベストセラー レポートの国のフィルタが適用されていません。

brandInventoryStatus

enum (InventoryStatus)

少なくとも 1 つの国で商品データソースに現在IN_STOCKされているブランドの商品が 1 つ以上あるかどうかにかかわらず、すべての国の商品データソースですべての商品が OUT_OF_STOCK であるか、NOT_IN_INVENTORY になります。

この項目にはベストセラー レポートの国のフィルタが適用されていません。

rank

string (int64 format)

選択したカテゴリと国における、推定販売数に基づく、広告とオーガニック サーフェスでの商品クラスタの人気度。

previousRank

string (int64 format)

先週または先月の人気度の順位です。

relativeDemand

enum (RelativeDemandEnum)

同じカテゴリと国で最も人気ランクの高い商品クラスタと比較した予測される需要。

previousRelativeDemand

enum (RelativeDemandEnum)

前週または前月に同じカテゴリと国で最も人気ランクの高い商品クラスタと比較した予測需要。

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

推定需要の変化。上昇したのか、沈んだのか、あるいは横ばいのままだったのか。

ReportGranularityEnum

レポートの粒度の値。

列挙型
REPORT_GRANULARITY_ENUM_UNSPECIFIED 指定されていません。
WEEKLY レポートは 1 週間の期間で計算されます。
MONTHLY レポートは 1 か月単位で計算されます。

InventoryStatus

在庫内の商品クラスタまたはブランドのステータス。

列挙型
INVENTORY_STATUS_UNSPECIFIED 指定されていません。
IN_STOCK この商品クラスタまたはブランドの商品の在庫があります。
OUT_OF_STOCK この商品クラスタまたはブランドの商品は在庫がありますが、現在在庫切れです。
NOT_IN_INVENTORY この商品クラスタまたはブランドの商品が在庫にありません。

RelativeDemandEnum

相対的な需要値。

列挙型
RELATIVE_DEMAND_ENUM_UNSPECIFIED 指定されていません。
VERY_LOW 需要とは、最もランクの高い商品クラスタまたはブランドの需要の 0 ~ 5% である。
LOW 需要は、最もランクの高い商品クラスタまたはブランドの需要の 6 ~ 10% です。
MEDIUM 需要は、最もランクの高い商品クラスタまたはブランドの需要の 11 ~ 20% です。
HIGH 需要は、最もランクの高い商品クラスタまたはブランドの需要の 21 ~ 50% です。
VERY_HIGH 需要は、最もランクの高い商品クラスタまたはブランドの需要の 51 ~ 100% です。

RelativeDemandChangeTypeEnum

相対的な需要の変化タイプの値。

列挙型
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED 指定されていません。
SINKER 相対的な需要が前の期間を下回っています。
FLAT 相対的な需要は前の期間と同じになります。
RISER 相対的な需要が前の期間よりも多くなっています。

BestSellersBrandView

bestSellersBrandView テーブルのクエリに使用できるフィールド。

人気ブランドに関するベストセラー レポート。

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

JSON 表現
{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
フィールド
reportDate

object (Date)

レポートの日付。このフィールドの値には、次のいずれかのみを指定できます。

  • 週次レポートの場合は 週の初日(月曜日)です
  • 月次レポートの月の初日。

SELECT 句では必須。reportDateWHERE 条件がクエリで指定されていない場合は、利用可能な最新の週次または月次レポートが返されます。

reportGranularity

enum (ReportGranularityEnum)

レポートの粒度。ランキングは、1 週間または 1 か月単位で行えます。

SELECT 句では必須。WHERE 句には reportGranularity の条件が必要です。

reportCountryCode

string

ランキングを計算する国。ISO 3166 形式で表されます。

SELECT 句では必須。WHERE 句には reportCountryCode の条件が必要です。

reportCategoryId

string (int64 format)

ランキングを計算するための Google 商品カテゴリ ID。Google の商品分類で表されます。

SELECT 句では必須。reportCategoryIdWHERE 条件がクエリで指定されていない場合は、すべての最上位カテゴリのランキングが返されます。

brand

string

ブランドの名前。

rank

string (int64 format)

選択したカテゴリと国における、推定販売数に基づく、広告とオーガニック サーフェスでのブランドの人気度。

previousRank

string (int64 format)

先週または先月の人気度の順位です。

relativeDemand

enum (RelativeDemandEnum)

同一のカテゴリと国において最も人気ランクの高いブランドと比較した予測される需要。

previousRelativeDemand

enum (RelativeDemandEnum)

前週または前月に同じカテゴリと国で最も人気ランクの高いブランドと比較した予測される需要。

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

推定需要の変化。上昇したのか、沈んだのか、あるいは横ばいのままだったのか。

CompetitiveVisibilityCompetitorView

competitiveVisibilityCompetitorView テーブルのクエリに使用できるフィールド。

認知度が同程度のビジネスを含む、競合視認性レポート。

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

JSON 表現
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
フィールド
date

object (Date)

この行の日付。

WHERE 句には date の条件が必要です。

domain

string

競合他社または自社ドメイン(「isYourDomain」の場合)真実だ。

SELECT 句では必須。「WHERE」でフィルタすることはできません句を使用します。

isYourDomain

boolean

この行にドメインのデータが含まれている場合は true に設定します。

「WHERE」でフィルタすることはできません句を使用します。

reportCountryCode

string

インプレッションが発生した国。

SELECT 句では必須。WHERE 句には reportCountryCode の条件が必要です。

reportCategoryId

string (int64 format)

レポートを計算する Google 商品カテゴリ ID。Google の商品分類で表されます。

SELECT 句では必須。WHERE 句には reportCategoryId の条件が必要です。

trafficSource

enum (TrafficSourceEnum)

インプレッションのトラフィック ソース。

SELECT 句では必須。

rank

string (int64 format)

インプレッション数に基づいて、選択されたキー(datereportCategoryIdreportCountryCodetrafficSource)の類似ビジネス ランキングにおけるドメインの位置。1 が最高です。

「WHERE」でフィルタすることはできません句を使用します。

adsOrganicRatio

number

広告とオーガニックの比率は、当該ドメインがオーガニック トラフィックと比較した場合のショッピング広告からのインプレッションの割合を示します。数値は四捨五入され、バケット化されます。

「WHERE」でフィルタすることはできません句を使用します。

pageOverlapRate

number

ページ重複率は、競合する販売店の商品が同じページに同時に表示される頻度を示します。

「WHERE」でフィルタすることはできません句を使用します。

higherPositionRate

number

上位掲載率は、競合他社の商品が貴社の商品よりも上位に掲載された割合を表します。

「WHERE」でフィルタすることはできません句を使用します。

relativeVisibility

number

相対的な視認性は、貴社の商品と比較して競合他社の商品が表示された頻度を表します。つまり、選択した商品カテゴリと国において、特定の期間における競合他社の販売店の表示回数をお客様の表示回数で割った値です。

「WHERE」でフィルタすることはできません句を使用します。

TrafficSourceEnum

トラフィック ソースの値。

列挙型
TRAFFIC_SOURCE_ENUM_UNSPECIFIED 指定されていません。
ORGANIC オーガニック トラフィック。
ADS 広告からのトラフィックです。
ALL オーガニック検索と広告のトラフィック

CompetitiveVisibilityTopMerchantView

competitiveVisibilityTopMerchantView テーブルのクエリに使用できるフィールド。

視認性が最も高いビジネスを含む競合視認性レポート。

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

JSON 表現
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
フィールド
date

object (Date)

この行の日付。

SELECT 句では選択できません。WHERE 句には date の条件が必要です。

domain

string

競合他社または自社ドメイン(「isYourDomain」の場合)真実だ。

SELECT 句では必須。「WHERE」でフィルタすることはできません句を使用します。

isYourDomain

boolean

この行にドメインのデータが含まれている場合は true に設定します。

「WHERE」でフィルタすることはできません句を使用します。

reportCountryCode

string

インプレッションが発生した国。

SELECT 句では必須。WHERE 句には reportCountryCode の条件が必要です。

reportCategoryId

string (int64 format)

レポートを計算する Google 商品カテゴリ ID。Google の商品分類で表されます。

SELECT 句では必須。WHERE 句には reportCategoryId の条件が必要です。

trafficSource

enum (TrafficSourceEnum)

インプレッションのトラフィック ソース。

SELECT 句では必須。

rank

string (int64 format)

インプレッション数に基づく、選択したキー(datereportCategoryIdreportCountryCodetrafficSource)のトップ販売者ランキングにおけるドメインの位置。1 が最高です。

「WHERE」でフィルタすることはできません句を使用します。

adsOrganicRatio

number

広告とオーガニックの比率は、当該ドメインがオーガニック トラフィックと比較した場合のショッピング広告からのインプレッションの割合を示します。数値は四捨五入され、バケット化されます。

「WHERE」でフィルタすることはできません句を使用します。

pageOverlapRate

number

ページ重複率は、競合する販売店の商品が同じページに同時に表示される頻度を示します。

「WHERE」でフィルタすることはできません句を使用します。

higherPositionRate

number

上位掲載率は、競合他社の商品が貴社の商品よりも上位に掲載された割合を表します。

「WHERE」でフィルタすることはできません句を使用します。

CompetitiveVisibilityBenchmarkView

competitiveVisibilityBenchmarkView テーブルのクエリに使用できるフィールド。

カテゴリのベンチマークを含む競合視認性レポート。

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

JSON 表現
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
フィールド
date

object (Date)

この行の日付。

SELECT 句では必須。WHERE 句には date の条件が必要です。

reportCountryCode

string

インプレッションが発生した国。

SELECT 句では必須。WHERE 句には reportCountryCode の条件が必要です。

reportCategoryId

string (int64 format)

レポートを計算する Google 商品カテゴリ ID。Google の商品分類で表されます。

SELECT 句では必須。WHERE 句には reportCategoryId の条件が必要です。

trafficSource

enum (TrafficSourceEnum)

インプレッションのトラフィック ソース。

SELECT 句では必須。

yourDomainVisibilityTrend

number

選択した期間の初日(または表示回数が 0 以外の最初の日)を基準とした、ドメインのインプレッション数に基づいて視認性が変化します。

「WHERE」でフィルタすることはできません句を使用します。

categoryBenchmarkVisibilityTrend

number

選択した期間の初日(または表示回数が 0 以外の最初の日)における、市場付近の視認性が最も高い販売者の組み合わせにおける、インプレッション数に基づく視認性の変化。

「WHERE」でフィルタすることはできません句を使用します。