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

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

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

概要

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

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

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 使用量の割り当てに加えて、検索アナリティクス メソッドでは、 検索タイプ（ウェブ、画像など）ごとに 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
  },
...