Получение данных о производительности,Получение данных о производительности,Получение данных о производительности

Вы можете быстро запросить данные о производительности и не превысить квоту, выполнив ежедневный запрос данных за один день.

Вы должны выбрать, какую информацию вы хотите включить в свои данные: какие типы поиска (Интернет, изображение, видео и т. д.) и какие параметры (страница, запрос, страна или устройство), а также группировать результаты по страницам или свойствам . При запросе страницы и/или строки запроса некоторые данные могут быть удалены ( вот почему ).

Обзор

  1. Мы рекомендуем выполнять запрос каждый день для данных за один день, используя один из стилей запроса, описанных ниже . Выполнение ежедневного запроса данных за один день не должно превышать вашу дневную квоту. Данные обычно доступны через 2-3 дня; вы можете узнать, какие самые последние доступные данные, запустив простой запрос, сгруппированный по дате за последние 10 дней. При написании запроса:
    • Выберите, следует ли группировать результаты по страницам или свойствам.
    • Выберите, хотите ли вы больше полных подсчетов или больше измерений в своем запросе. Примечание. Данные о внешнем виде в поиске (AMP, синяя ссылка, расширенный результат и т. д.) необходимо запрашивать в два этапа .
  2. Пролистайте результаты, повторно запустив тот же запрос, увеличивая значение startRow на 25 000 в запросе, пока не дойдете до последней страницы (ответ с 0 строками).
  3. При необходимости запустите тот же запрос с другим параметром type .

Вот пример псевдокода для одного запроса. Вы можете запускать это один раз в день для каждого значения 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, метод Search Analytics предоставляет не более 50 000 строк данных в день для каждого типа поиска (веб-сайт, изображение и т. д., отсортированных по кликам).

Сведения о запросе

Вы можете запрашивать данные, сгруппированные по страницам или свойствам .

Сгруппировано по страницам

Для точного подсчета вы должны опустить параметры страницы и запроса, например:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web",
"aggregationType": "byPage"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : необязательно укажите country и/или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.
  • aggregationType : должен быть byPage .

Для получения более подробной информации, включая информацию о странице и/или запросе , за счет потери некоторых данных выполните следующий запрос:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : Включить page . При желании укажите любую комбинацию query , country или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.

Сгруппировано по свойству

Для точного подсчета вы должны опустить параметры страницы и запроса, например:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : необязательно укажите country и/или device .
  • type : При необходимости перечислите каждое значение type по желанию в отдельном запросе.

Для получения более подробной информации, включая запрос, информацию о стране и/или устройстве за счет потери некоторых данных, выполните следующий запрос:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : при желании можно указать любую комбинацию query , country или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.

Группировка результатов по странице или свойству

Показы, клики, позиция и рейтинг кликов рассчитываются по-разному при группировке результатов по страницам, а не по свойствам. Узнать больше.

Почему я теряю данные, когда запрашиваю дополнительную информацию?

Когда вы группируете по страницам и/или запросам, наша система может отбрасывать некоторые данные, чтобы иметь возможность рассчитать результаты в разумные сроки с использованием разумного количества вычислительных ресурсов.

Получение данных о появлении в поиске

Внешний вид поиска недоступен в виде столбца вместе с любыми другими параметрами. Поэтому, если вы хотите просмотреть информацию о внешнем виде вашего сайта в поиске, вы должны выполнить следующий процесс:

  1. Укажите searchAppearance в качестве единственного измерения, которое будет группировать все данные по типу внешнего вида поиска без каких-либо других измерений.
  2. При необходимости запустите второй запрос, отфильтровав его по одному из типов отображения в поиске, перечисленных на шаге 1, добавив в запрос любые необходимые параметры (страница, страна, запрос и т. д.).

Чтобы получить данные о нескольких типах представления поиска, необходимо выполнить второй шаг один раз для каждого типа представления поиска, указанного в шаге 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
  },...

Второй запрос:

Отфильтруйте по одному из типов внешнего вида поиска, найденных на шаге 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
  },
...

,

Вы можете быстро запросить данные о производительности и не превысить квоту, выполнив ежедневный запрос данных за один день.

Вы должны выбрать, какую информацию вы хотите включить в свои данные: какие типы поиска (Интернет, изображение, видео и т. д.) и какие параметры (страница, запрос, страна или устройство), а также группировать результаты по страницам или свойствам . При запросе страницы и/или строки запроса некоторые данные могут быть удалены ( вот почему ).

Обзор

  1. Мы рекомендуем выполнять запрос каждый день для данных за один день, используя один из стилей запроса, описанных ниже . Выполнение ежедневного запроса данных за один день не должно превышать вашу дневную квоту. Данные обычно доступны через 2-3 дня; вы можете узнать, какие самые последние доступные данные, запустив простой запрос, сгруппированный по дате за последние 10 дней. При написании запроса:
    • Выберите, следует ли группировать результаты по страницам или свойствам.
    • Выберите, хотите ли вы больше полных подсчетов или больше измерений в своем запросе. Примечание. Данные о внешнем виде в поиске (AMP, синяя ссылка, расширенный результат и т. д.) необходимо запрашивать в два этапа .
  2. Пролистайте результаты, повторно запустив тот же запрос, увеличивая значение startRow на 25 000 в запросе, пока не дойдете до последней страницы (ответ с 0 строками).
  3. При необходимости запустите тот же запрос с другим параметром type .

Вот пример псевдокода для одного запроса. Вы можете запускать это один раз в день для каждого значения 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, метод Search Analytics предоставляет не более 50 000 строк данных в день для каждого типа поиска (веб-сайт, изображение и т. д., отсортированных по кликам).

Сведения о запросе

Вы можете запрашивать данные, сгруппированные по страницам или свойствам .

Сгруппировано по страницам

Для точного подсчета вы должны опустить параметры страницы и запроса, например:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web",
"aggregationType": "byPage"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : необязательно укажите country и/или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.
  • aggregationType : должен быть byPage .

Для получения более подробной информации, включая информацию о странице и/или запросе , за счет потери некоторых данных выполните следующий запрос:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : Включить page . При желании укажите любую комбинацию query , country или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.

Сгруппировано по свойству

Для точного подсчета вы должны опустить параметры страницы и запроса, например:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : необязательно укажите country и/или device .
  • type : При необходимости перечислите каждое значение type по желанию в отдельном запросе.

Для получения более подробной информации, включая запрос, информацию о стране и/или устройстве за счет потери некоторых данных, выполните следующий запрос:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : при желании можно указать любую комбинацию query , country или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.

Группировка результатов по странице или свойству

Показы, клики, позиция и рейтинг кликов рассчитываются по-разному при группировке результатов по страницам, а не по свойствам. Узнать больше.

Почему я теряю данные, когда запрашиваю дополнительную информацию?

Когда вы группируете по страницам и/или запросам, наша система может отбрасывать некоторые данные, чтобы иметь возможность рассчитать результаты в разумные сроки с использованием разумного количества вычислительных ресурсов.

Получение данных о появлении в поиске

Внешний вид поиска недоступен в виде столбца вместе с любыми другими параметрами. Поэтому, если вы хотите просмотреть информацию о внешнем виде вашего сайта в поиске, вы должны выполнить следующий процесс:

  1. Укажите searchAppearance в качестве единственного измерения, которое будет группировать все данные по типу внешнего вида поиска без каких-либо других измерений.
  2. При необходимости запустите второй запрос, отфильтровав его по одному из типов отображения в поиске, перечисленных на шаге 1, добавив в запрос любые необходимые параметры (страница, страна, запрос и т. д.).

Чтобы получить данные о нескольких типах представления поиска, необходимо выполнить второй шаг один раз для каждого типа представления поиска, указанного в шаге 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
  },...

Второй запрос:

Отфильтруйте по одному из типов внешнего вида поиска, найденных на шаге 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
  },
...

,

Вы можете быстро запросить данные о производительности и не превысить квоту, выполнив ежедневный запрос данных за один день.

Вы должны выбрать, какую информацию вы хотите включить в свои данные: какие типы поиска (Интернет, изображение, видео и т. д.) и какие параметры (страница, запрос, страна или устройство), а также группировать результаты по страницам или свойствам . При запросе страницы и/или строки запроса некоторые данные могут быть удалены ( вот почему ).

Обзор

  1. Мы рекомендуем выполнять запрос каждый день для данных за один день, используя один из стилей запроса, описанных ниже . Выполнение ежедневного запроса данных за один день не должно превышать вашу дневную квоту. Данные обычно доступны через 2-3 дня; вы можете узнать, какие самые последние доступные данные, запустив простой запрос, сгруппированный по дате за последние 10 дней. При написании запроса:
    • Выберите, следует ли группировать результаты по страницам или свойствам.
    • Выберите, хотите ли вы больше полных подсчетов или больше измерений в своем запросе. Примечание. Данные о внешнем виде в поиске (AMP, синяя ссылка, расширенный результат и т. д.) необходимо запрашивать в два этапа .
  2. Пролистайте результаты, повторно запустив тот же запрос, увеличивая значение startRow на 25 000 в запросе, пока не дойдете до последней страницы (ответ с 0 строками).
  3. При необходимости запустите тот же запрос с другим параметром type .

Вот пример псевдокода для одного запроса. Вы можете запускать это один раз в день для каждого значения 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, метод Search Analytics предоставляет не более 50 000 строк данных в день для каждого типа поиска (веб-сайт, изображение и т. д., отсортированные по кликам).

Сведения о запросе

Вы можете запрашивать данные, сгруппированные по страницам или свойствам .

Сгруппировано по страницам

Для точного подсчета вы должны опустить параметры страницы и запроса, например:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web",
"aggregationType": "byPage"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : необязательно укажите country и/или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.
  • aggregationType : должен быть byPage .

Для получения более подробной информации, включая информацию о странице и/или запросе , за счет потери некоторых данных выполните следующий запрос:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : Включить page . При желании укажите любую комбинацию query , country или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.

Сгруппировано по свойству

Для точного подсчета вы должны опустить параметры страницы и запроса, например:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : необязательно укажите country и/или device .
  • type : При необходимости перечислите каждое значение type по желанию в отдельном запросе.

Для получения более подробной информации, включая запрос, информацию о стране и/или устройстве за счет потери некоторых данных, выполните следующий запрос:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"
  • startDate / endDate : выберите однодневное окно, выбрав ту же дату.
  • dimensions : при желании можно указать любую комбинацию query , country или device .
  • type : Перечислите каждое значение type по желанию в отдельном запросе.

Группировка результатов по странице или свойству

Показы, клики, позиция и рейтинг кликов рассчитываются по-разному при группировке результатов по страницам, а не по свойствам. Узнать больше.

Почему я теряю данные, когда запрашиваю дополнительную информацию?

Когда вы группируете по страницам и/или запросам, наша система может отбрасывать некоторые данные, чтобы иметь возможность рассчитать результаты в разумные сроки с использованием разумного количества вычислительных ресурсов.

Получение данных о появлении в поиске

Внешний вид поиска недоступен в виде столбца вместе с любыми другими параметрами. Поэтому, если вы хотите просмотреть информацию о внешнем виде вашего сайта в поиске, вы должны выполнить следующий процесс:

  1. Укажите searchAppearance в качестве единственного измерения, которое будет группировать все данные по типу внешнего вида поиска без каких-либо других измерений.
  2. При необходимости запустите второй запрос, отфильтровав его по одному из типов отображения в поиске, перечисленных на шаге 1, добавив в запрос любые необходимые параметры (страница, страна, запрос и т. д.).

Чтобы получить данные о нескольких типах представления поиска, необходимо выполнить второй шаг один раз для каждого типа представления поиска, указанного в шаге 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
  },...

Второй запрос:

Отфильтруйте по одному из типов внешнего вида поиска, найденных на шаге 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
  },
...