Вы можете быстро запросить данные о производительности и не превысить квоту, выполнив ежедневный запрос данных за один день.
Вы должны выбрать, какую информацию вы хотите включить в свои данные: какие типы поиска (Интернет, изображение, видео и т. д.) и какие параметры (страница, запрос, страна или устройство), а также группировать результаты по страницам или свойствам . При запросе страницы и/или строки запроса некоторые данные могут быть удалены ( вот почему ).
Обзор
- Мы рекомендуем выполнять запрос каждый день для данных за один день, используя один из стилей запроса, описанных ниже . Выполнение ежедневного запроса данных за один день не должно превышать вашу дневную квоту. Данные обычно доступны через 2-3 дня; вы можете узнать, какие самые последние доступные данные, запустив простой запрос, сгруппированный по дате за последние 10 дней. При написании запроса:
- Выберите, следует ли группировать результаты по страницам или свойствам.
- Выберите, хотите ли вы больше полных подсчетов или больше измерений в своем запросе. Примечание. Данные о внешнем виде в поиске (AMP, синяя ссылка, расширенный результат и т. д.) необходимо запрашивать в два этапа .
- Пролистайте результаты, повторно запустив тот же запрос, увеличивая значение
startRow
на 25 000 в запросе, пока не дойдете до последней страницы (ответ с 0 строками). - При необходимости запустите тот же запрос с другим параметром
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
по желанию в отдельном запросе.
Группировка результатов по странице или свойству
Показы, клики, позиция и рейтинг кликов рассчитываются по-разному при группировке результатов по страницам, а не по свойствам. Узнать больше.
Почему я теряю данные, когда запрашиваю дополнительную информацию?
Когда вы группируете по страницам и/или запросам, наша система может отбрасывать некоторые данные, чтобы иметь возможность рассчитать результаты в разумные сроки с использованием разумного количества вычислительных ресурсов.
Получение данных о появлении в поиске
Внешний вид поиска недоступен в виде столбца вместе с любыми другими параметрами. Поэтому, если вы хотите просмотреть информацию о внешнем виде вашего сайта в поиске, вы должны выполнить следующий процесс:
- Укажите
searchAppearance
в качестве единственного измерения, которое будет группировать все данные по типу внешнего вида поиска без каких-либо других измерений. - При необходимости запустите второй запрос, отфильтровав его по одному из типов отображения в поиске, перечисленных на шаге 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 }, ...,
Вы можете быстро запросить данные о производительности и не превысить квоту, выполнив ежедневный запрос данных за один день.
Вы должны выбрать, какую информацию вы хотите включить в свои данные: какие типы поиска (Интернет, изображение, видео и т. д.) и какие параметры (страница, запрос, страна или устройство), а также группировать результаты по страницам или свойствам . При запросе страницы и/или строки запроса некоторые данные могут быть удалены ( вот почему ).
Обзор
- Мы рекомендуем выполнять запрос каждый день для данных за один день, используя один из стилей запроса, описанных ниже . Выполнение ежедневного запроса данных за один день не должно превышать вашу дневную квоту. Данные обычно доступны через 2-3 дня; вы можете узнать, какие самые последние доступные данные, запустив простой запрос, сгруппированный по дате за последние 10 дней. При написании запроса:
- Выберите, следует ли группировать результаты по страницам или свойствам.
- Выберите, хотите ли вы больше полных подсчетов или больше измерений в своем запросе. Примечание. Данные о внешнем виде в поиске (AMP, синяя ссылка, расширенный результат и т. д.) необходимо запрашивать в два этапа .
- Пролистайте результаты, повторно запустив тот же запрос, увеличивая значение
startRow
на 25 000 в запросе, пока не дойдете до последней страницы (ответ с 0 строками). - При необходимости запустите тот же запрос с другим параметром
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
по желанию в отдельном запросе.
Группировка результатов по странице или свойству
Показы, клики, позиция и рейтинг кликов рассчитываются по-разному при группировке результатов по страницам, а не по свойствам. Узнать больше.
Почему я теряю данные, когда запрашиваю дополнительную информацию?
Когда вы группируете по страницам и/или запросам, наша система может отбрасывать некоторые данные, чтобы иметь возможность рассчитать результаты в разумные сроки с использованием разумного количества вычислительных ресурсов.
Получение данных о появлении в поиске
Внешний вид поиска недоступен в виде столбца вместе с любыми другими параметрами. Поэтому, если вы хотите просмотреть информацию о внешнем виде вашего сайта в поиске, вы должны выполнить следующий процесс:
- Укажите
searchAppearance
в качестве единственного измерения, которое будет группировать все данные по типу внешнего вида поиска без каких-либо других измерений. - При необходимости запустите второй запрос, отфильтровав его по одному из типов отображения в поиске, перечисленных на шаге 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 }, ...,
Вы можете быстро запросить данные о производительности и не превысить квоту, выполнив ежедневный запрос данных за один день.
Вы должны выбрать, какую информацию вы хотите включить в свои данные: какие типы поиска (Интернет, изображение, видео и т. д.) и какие параметры (страница, запрос, страна или устройство), а также группировать результаты по страницам или свойствам . При запросе страницы и/или строки запроса некоторые данные могут быть удалены ( вот почему ).
Обзор
- Мы рекомендуем выполнять запрос каждый день для данных за один день, используя один из стилей запроса, описанных ниже . Выполнение ежедневного запроса данных за один день не должно превышать вашу дневную квоту. Данные обычно доступны через 2-3 дня; вы можете узнать, какие самые последние доступные данные, запустив простой запрос, сгруппированный по дате за последние 10 дней. При написании запроса:
- Выберите, следует ли группировать результаты по страницам или свойствам.
- Выберите, хотите ли вы больше полных подсчетов или больше измерений в своем запросе. Примечание. Данные о внешнем виде в поиске (AMP, синяя ссылка, расширенный результат и т. д.) необходимо запрашивать в два этапа .
- Пролистайте результаты, повторно запустив тот же запрос, увеличивая значение
startRow
на 25 000 в запросе, пока не дойдете до последней страницы (ответ с 0 строками). - При необходимости запустите тот же запрос с другим параметром
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
по желанию в отдельном запросе.
Группировка результатов по странице или свойству
Показы, клики, позиция и рейтинг кликов рассчитываются по-разному при группировке результатов по страницам, а не по свойствам. Узнать больше.
Почему я теряю данные, когда запрашиваю дополнительную информацию?
Когда вы группируете по страницам и/или запросам, наша система может отбрасывать некоторые данные, чтобы иметь возможность рассчитать результаты в разумные сроки с использованием разумного количества вычислительных ресурсов.
Получение данных о появлении в поиске
Внешний вид поиска недоступен в виде столбца вместе с любыми другими параметрами. Поэтому, если вы хотите просмотреть информацию о внешнем виде вашего сайта в поиске, вы должны выполнить следующий процесс:
- Укажите
searchAppearance
в качестве единственного измерения, которое будет группировать все данные по типу внешнего вида поиска без каких-либо других измерений. - При необходимости запустите второй запрос, отфильтровав его по одному из типов отображения в поиске, перечисленных на шаге 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 }, ...