パフォーマンス データを取得しています

1 日分のデータに対してクエリを毎日実行することで、割り当てを超過することなく、パフォーマンス データを素早くクエリできます。

どの検索タイプ（ウェブ、画像、動画など）でデータに含めるかを選択する必要があります。ディメンション（ページ、クエリ、国、デバイス）や、ページまたはプロパティで結果をグループ化するかどうかを選択できます。ページやクエリ文字列をクエリすると、一部のデータが破棄されることがあります（理由）。

概要

  1. 後述するクエリスタイルのいずれかを使用して、1 日分のデータに対するクエリを毎日実行することをおすすめします。1 日分のデータに対して毎日クエリを実行すると、1 日の割り当てを超えないようにする必要があります。通常、データは 2 ～ 3 日後に利用可能になります。過去 10 日間の日付でグループ化されたシンプルなクエリを実行すると、最新の利用可能なデータを確認できます。クエリの作成中:
    • 検索結果をページ別とプロパティ別のどちらでグループ化するかを選択します。
    • クエリで完全なカウントとディメンションの増加のどちらを使用するかを選択します。注: 検索での見え方に関するデータ（AMP、青色のリンク、リッチリザルトなど）は、2 段階のプロセスでクエリする必要があります。
  2. 最後のページ（0 行のレスポンス）が表示されるまで、同じクエリを再実行し、リクエストの startRow 値を 25,000 増やして、結果をページ分割します。
  3. 必要に応じて、別の type パラメータを指定して同じクエリを実行します。

以下に、単一クエリの擬似コードの例を示します。この操作は、データを取得する type 値ごとに 1 日に 1 回実行できます。

int maxRows = 25000; // Current max response size
int i = 0;
do {
  response = Request(startDate = 3_days_ago,
                     endDate = 3_days_ago,
                     ... add dimensions, type ...
                     rowLimit = maxRows,
                     startRow = i * maxRows);
  i++;
  …  // Do something with the response data.
} while (response.rows.count() != 0); // Page through all result rows

データ制限

API 使用量の割り当てに加えて、Search Analytics メソッドでは、検索タイプ（ウェブ、画像など、クリック数で並べ替えられたもの）ごとに 1 日あたり最大 5 万行のデータを公開できます。

クエリの詳細

ページまたはプロパティでグループ化されたデータに対してクエリを実行できます。

ページでグループ化

正確にカウントするには、次のようにページとクエリのディメンションを省略する必要があります。

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web",
"aggregationType": "byPage"
  • startDate / endDate: 同じ日付を選択して、1 日の期間を選択します。
  • dimensions: 必要に応じて country や device を含めます。
  • type: 必要に応じて、個別のクエリで 各 type 値を列挙します。
  • aggregationType: byPage にする必要があります。

ページやクエリの情報などの詳細情報を取得する場合、データは一部失われますが、次のようなクエリを実行します。

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"
  • startDate / endDate: 同じ日付を選択して、1 日の期間を選択します。
  • dimensions: page を含めます。必要に応じて、query、country、device の任意の組み合わせを含めます。
  • type: 必要に応じて、個別のクエリで 各 type 値を列挙します。

プロパティでグループ化

正確にカウントするには、次のようにページとクエリのディメンションを省略する必要があります。

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"
  • startDate / endDate: 同じ日付を選択して、1 日の期間を選択します。
  • dimensions: 必要に応じて country や device を含めます。
  • type: 必要に応じて、個別のクエリで 各 type 値を列挙します。

クエリ、国、デバイス情報などの詳細を確認するには、一部のデータが失われますが、次のようなクエリを実行します。

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"
  • startDate / endDate: 同じ日付を選択して、1 日の期間を選択します。
  • dimensions: 必要に応じて、query、country、device の任意の組み合わせを含めます。
  • type: 必要に応じて、個別のクエリで 各 type 値を列挙します。

ページまたはプロパティごとに結果をグループ化する

結果をプロパティ別ではなくページ別にグループ化した場合、インプレッション数、クリック数、掲載順位、クリック率の算出方法が異なります。詳細

詳細情報を尋ねるとデータが失われてしまうのはなぜですか？

ページまたはクエリでグループ化した場合、妥当な量のコンピューティング リソースを使用して妥当な時間で結果を計算できるようにするために、一部のデータが削除されることがあります。

検索での見え方のデータを取得する

検索での見え方を、他のディメンションとともに列として指定することはできません。そのため、サイトの検索での見え方に関する情報を確認するには、次の手順を行う必要があります。

  1. 唯一のディメンションとして searchAppearance を指定します。これにより、検索での見え方のタイプ別にすべてのデータがグループ化され、他のディメンションはグループ化されません。
  2. 必要に応じて 2 つ目のクエリを実行し、ステップ 1 で示した検索での見え方のタイプでフィルタして、クエリに必要なディメンション（ページ、国、クエリなど）を追加します。

複数の検索での見え方のタイプに関するデータを取得するには、ステップ 1 に示した検索での見え方のタイプごとに 2 つ目の手順を 1 回実行する必要があります。

最初のクエリ:

サイトでの検索での見え方のタイプのリストを取得します。

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "searchAppearance"
  ]
}

結果:

サイトのタイプが INSTANT_APP、AMP_BLUE_LINK などである。

 "rows": [
  {
   "keys": [
    "INSTANT_APP"
   ],
   "clicks": 443024.0,
   "impressions": 4109826.0,
   "ctr": 0.10779629113251997,
   "position": 1.088168452873674
  },
  {
   "keys": [
    "AMP_BLUE_LINK"
   ],
   "clicks": 429887.0,
   "impressions": 1.7090884E7,
   "ctr": 0.025152999692701676,
   "position": 7.313451603790653
  },...

2 番目のクエリ:

ステップ 1 で見つけた検索での見え方のタイプと任意のディメンション（ページ、デバイスなど）でフィルタします。ここでは AMP_BLUE_LINK でフィルタします。

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "device" // and/or page, country, ...
  ],
  "dimensionFilterGroups": [
    {
      "filters": [
        {
          "dimension": "searchAppearance",
          "operator": "equals",
          "expression": "AMP_BLUE_LINK"
        }
      ]
    }
  ]
}

結果:

デバイスタイプ別の AMP_BLUE_LINK の内訳。

"rows": [
  {
   "keys": [
    "MOBILE"
   ],
   "clicks": 429887.0,
   "impressions": 1.7090783E7,
   "ctr": 0.025153148337323107,
   "position": 7.31339517914422
  },
  {
   "keys": [
    "DESKTOP"
   ],
   "clicks": 0.0,
   "impressions": 66.0,
   "ctr": 0.0,
   "position": 12.257575757575758
  },
...