Как создавать запросы
- Откройте в Ads Data Hub вкладку Запросы.
- Нажмите + Создать запрос. Откроется страница Шаблоны запроса анализа.
- Вы можете просмотреть шаблон SQL, нажав Развернуть.
- Чтобы выбрать шаблон, нажмите Использовать шаблон, или нажмите Пустой шаблон, чтобы создать запрос с нуля.
- Введите название отчета.
- Составьте или измените запрос, используя код SQL, совместимый с BigQuery. Вы можете найти доступные таблицы и поля на вкладке Таблицы Google и вставить их в код SQL.
- При необходимости настройте параметры.
- При необходимости настройте сводку по отфильтрованным строкам.
- Нажмите Сохранить.
Параметры
Параметры делают запросы более гибкими. Предположим, вам нужно выполнить один и тот же запрос в разных кампаниях. Вместо того чтобы копировать запрос или перед каждой его отправкой менять идентификатор кампании, вы можете настроить параметр, который позволит указывать более одного идентификатора на карточке выполнения. Параметры помогают упростить код и избежать ошибок при редактировании, а также позволяют повторно использовать запросы без изменения. Параметры действуют только для того запроса, для которого созданы, поэтому название параметра, созданного для одного запроса, можно использовать повторно в другом.
Типы параметров
Допускаются следующие типы параметров:
int64float64boolstringdatetimestamparray(любой из разрешенных типов)
Как создавать параметры
- Откройте сохраненный запрос или создайте новый.
- Нажмите Свойства > Параметры > Добавить параметр.
- Введите название параметра. Оно будет использоваться в тексте запроса.
- Выберите тип параметра в раскрывающемся меню.
- При выборе массива раскроется дополнительное меню. Укажите тип массива.
- Чтобы добавить другие параметры, повторите шаги 2–4.
- Нажмите "Сохранить".
Как использовать параметры
Используйте в тексте запроса стандартный SQL-формат. Названию параметра должен предшествовать символ @. В примере ниже запрос содержит параметр @campaign_ids.
/* Parameters:
* @campaign_ids (ARRAY of INT64): A list of campaign IDs
* to conduct analysis on */
WITH user_reach AS (
SELECT
user_id,
count(*) AS num_views
FROM
adh.google_ads_impressions
WHERE
campaign_id in UNNEST(@campaign_ids)
GROUP BY
user_id
)
SELECT
COUNT(*) AS unique_users,
COUNTIF(num_views = 1) AS one_view,
COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
COUNTIF(num_views > 5) AS more_than_five_views
FROM
user_reach
При выполнении запроса диалоговое окно Новое задание будет содержать поле Параметры. Введите в него значения параметров, которые вы определили.
Как удалять параметры
- Откройте запрос с параметром, который требуется удалить.
- Перейдите на вкладку Свойства.
- На карточке Параметры рядом с нужным параметром нажмите Удалить.
- Нажмите "Сохранить".
Зарезервированные параметры
В таблице ниже перечислены параметры, зарезервированные в Ads Data Hub. Вы можете использовать эти параметры в запросах, однако создавать параметры с такими же названиями нельзя.
start_date
|
date
Дата начала (включительно) выполнения запроса. Пользовательский параметр с этим названием будет проигнорирован и заменен значениями, указанными в диалоговом окне Новое задание. |
end_date
|
date
Дата окончания (включительно) выполнения запроса. Пользовательский параметр с этим названием будет проигнорирован и заменен значениями, указанными в диалоговом окне Новое задание. |
time_zone
|
string
Часовой пояс, в котором выполняется запрос. Пользовательский параметр с этим названием будет проигнорирован и заменен значениями, указанными в диалоговом окне Новое задание. |
Сводка по отфильтрованным строкам
Сводки по отфильтрованным строкам содержат общие сведения о том, какие данные были отфильтрованы в результате проверок конфиденциальности. Для этого данные из отфильтрованных строк суммируются и добавляются в агрегированную строку. Такие данные невозможно проанализировать подробно, но они дают представление о том, какой объем информации был отфильтрован.
Как изменять запросы
- Откройте в Ads Data Hub вкладку Запросы.
- Нажмите на название запроса, который нужно изменить.
- Измените запрос.
- Нажмите Сохранить.
Как выполнять запросы
Прежде чем выполнять запрос, убедитесь, что у сервисного аккаунта есть разрешение dataEditor для набора данных, в котором будет содержаться результат объединения.
Подробнее об управлении доступом в BigQuery…
- Откройте в Ads Data Hub вкладку Запросы.
- Нажмите на название запроса, который нужно выполнить.
- Нажмите
Выполнить.
- В верхней части страницы будет показано, сколько байтов предположительно понадобится для запроса.
- В раскрывающемся списке Источник данных рекламы выберите идентификатор. Убедитесь, что вы выбрали тот, который связан с нужными данными. Если вы хотите выполнить запрос для тестовых данных, выберите ADH Sandbox Customer.
- Если вы используете таблицу соответствий, выберите нужный вариант в раскрывающемся списке Источник таблицы соответствий.
- В поле Целевая таблица укажите, где нужно сохранить результаты запроса.
- Укажите даты начала и окончания, чтобы определить диапазон дат для запроса.
- Введите часовой пояс. Он должен соответствовать часовому поясу сервиса покупки.
- При необходимости укажите значения других параметров.
- Нажмите Выполнить.
Как просматривать результаты
Когда запрос будет выполнен, вы сможете посмотреть результаты на странице "Задания". Также вы сможете проанализировать данные в BigQuery, Google Таблицах или Студии данных.
Предварительный просмотр
В выполненном задании нажмите Предварительный просмотр. Под заданием будут показаны первые 20 строк.
BigQuery
Результаты выполнения запроса по умолчанию экспортируются в BigQuery. Чтобы открыть BigQuery в новом окне, нажмите Открыть таблицу.
Google Таблицы и Студия данных
Нажмите на раскрывающееся меню Обзор и выберите Открыть в Google Таблицах или Открыть в Студии данных. Данные откроются в новом окне.