パフォーマンス データを取得する

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

データに含める情報(検索タイプ(ウェブ、画像、動画など))を選択する必要があります。 ディメンション(ページ、クエリ、国、デバイス)や、ページまたはプロパティ別に結果をグループ化するかどうかも設定します。ページまたはクエリ文字列をクエリすると、一部のデータが削除される場合があります(理由についてはこちらをご覧ください)。

概要

  1. 以下で説明するクエリスタイルのいずれかを使用して、1 日分のデータに対して毎日クエリを実行することをおすすめします。1 日のデータに対して 1 日のクエリを実行する場合、1 日の割り当てを超えることはできません。データは通常 2 ~ 3 日後に利用可能になります。直近 10 日間の日付別にグループ化された単純なクエリを実行すると、利用可能な最新のデータを確認できます。クエリの作成中:
    • ページまたはプロパティ別に結果をグループ化するかどうかを選択します。
    • クエリに完全な数とディメンションのどちらを含めるかを選択します。注: 検索での見え方のデータ(AMP、青いリンク、リッチリザルトなど)は、2 ステップのプロセスでクエリする必要があります。
  2. 同じクエリを再実行して結果のページ分割を行います。最後のページ(0 行を含むレスポンス)に到達するまで、リクエストで startRow の値が 25,000 増加します。
  3. 必要に応じて、別の type パラメータを使用して同じクエリを実行します。

1 つのクエリの疑似コードの例を次に示します。これは、データを取得する 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 使用量の割り当てに加え、検索分析のメソッドでは、検索タイプ(ウェブ、画像など)ごとに 1 日あたり最大 50,000 行がデータ別に表示されます(クリック順)。

クエリの詳細

ページまたはプロパティごとにグループ化されたデータをクエリできます。

ページでグループ化

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

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

ページやクエリ情報など、より詳しい情報が必要な場合は、データの損失を犠牲にして、次のクエリを実行します。

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

プロパティでグループ化

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

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

クエリ、国、デバイス情報などの詳細を確認するには、データを失いますが、次のようなクエリを実行してください。

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

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

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

詳細を要求してもデータが失われるのはなぜですか?

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

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

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

  1. 唯一のディメンションとして searchAppearance を指定すると、すべてのデータが検索での見え方でグループ化され、他のディメンションは含まれません。
  2. 必要に応じて、ステップ 1 にある検索での見え方のタイプのいずれかでフィルタし、クエリに目的のディメンション(ページ、国、クエリなど)を追加して、2 番目のクエリを実行します。

複数の検索での見え方のタイプに関するデータを取得するには、ステップ 1 に記載されている検索での見え方のタイプごとに 2 つ目のステップを実行する必要があります。

最初のクエリ:

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

{
  "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
  },
...