Как составлять и выполнять запросы

Создать запрос

Примечание. Не все пользователи могут создавать и редактировать запросы. Узнайте больше об управлении доступом в Ads Data Hub.

1. Перейдите на вкладку «Запросы» в Ads Data Hub .
2. Нажмите + Создать запрос . Откроется страница шаблонов запросов анализа .
3. Необязательно: просмотрите шаблон SQL, нажав Expand .
4. Выберите шаблон, который вы хотите использовать, нажав «Использовать шаблон» или нажмите «Пустой», чтобы начать с нуля.
5. Введите название отчета.
6. Напишите или отредактируйте запрос, используя SQL , совместимый с BigQuery . Вы можете найти доступные таблицы и поля и вставить их в свой SQL на вкладке Таблицы Google .
7. Необязательно: Настройте параметры .
8. Необязательно: Настройте отфильтрованную сводку строк .
9. Нажмите Сохранить .

Параметры

Параметры делают запросы более гибкими. Например, вы можете запустить один и тот же запрос для разных кампаний. Вместо создания дублирующих запросов или жесткого кодирования идентификаторов кампаний перед каждым выполнением вы можете настроить параметр, который принимает один или несколько идентификаторов кампании, которые будут вводиться из карточки «Выполнить» при выполнении запроса. Использование параметров сохраняет ваш код чистым, снижает вероятность появления ошибок при редактировании и позволяет повторно использовать запрос без редактирования. Область действия параметров ограничена запросом, в котором они созданы, поэтому вы можете повторно использовать имя параметра в другом запросе.

Типы параметров

Допускаются следующие типы параметров:

• int64
• float64
• bool
• string
• date
• timestamp
• array любого из разрешенных типов

Создать параметр

1. Откройте сохраненный запрос или создайте новый .
2. Нажмите «Свойства» > «Параметры» > «Добавить параметр» .
3. Введите имя в поле Имя . Вы будете использовать это имя для ссылки на параметр в тексте запроса.
4. Используйте раскрывающееся меню, чтобы выбрать тип параметра.
   • Если вы выберете массив, появится дополнительное раскрывающееся меню. Выберите тип массива в раскрывающемся меню.
5. Необязательно: повторяйте шаги 2–4, пока не добавите все нужные параметры.
6. Нажмите «Сохранить».

Использовать параметр

В тексте запроса используйте стандартный формат параметров 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

При выполнении запроса диалоговое окно «Новое задание» будет содержать поле «Параметры» . Введите значения для каждого определенного вами параметра.

Удаление параметра

1. Откройте запрос, содержащий параметр, который вы хотите удалить.
2. Откройте вкладку «Свойства» .
3. На карточке «Параметры » нажмите «Удалить » рядом с параметром, который вы хотите удалить.
4. Нажмите «Сохранить».

Зарезервированные параметры

В следующей таблице перечислены параметры, зарезервированные Ads Data Hub. Вы можете использовать эти параметры в своих запросах, но не можете создать параметр с тем же именем, что и зарезервированный параметр.

start_date	date Дата начала (включительно) задания запроса. Пользовательский параметр с таким именем будет проигнорирован и заменен значениями, заданными в диалоговом окне «Новое задание» .
end_date	date Дата окончания (включительно) задания запроса. Пользовательский параметр с таким именем будет проигнорирован и заменен значениями, заданными в диалоговом окне «Новое задание» .
time_zone	string Часовой пояс для задания запроса. Пользовательский параметр с таким именем будет проигнорирован и заменен значениями, заданными в диалоговом окне «Новое задание» . Совет: Чтобы предотвратить несоответствия при использовании часовых поясов в вашем запросе, например, в предложениях WHERE , вы можете использовать time_zone для соответствия часовому поясу, установленному в New job . Также важно использовать тот же часовой пояс, что и источник данных.

Сводка отфильтрованной строки

В сводках отфильтрованных строк суммируются данные, отфильтрованные в результате проверок конфиденциальности. Данные из отфильтрованных строк суммируются и добавляются в строку сбора всех данных. Хотя отфильтрованные данные не подлежат дальнейшему анализу, они предоставляют сводную информацию о том, какой объем данных был отфильтрован из результатов.

Примечание. Требования к агрегированию применяются к самим отфильтрованным сводкам строк. Если результирующая сводка отфильтрованных строк не соответствует требованиям агрегирования, сама сводка отфильтрованных строк будет отфильтрована.

Редактировать запрос

1. Перейдите на вкладку «Запросы» в Ads Data Hub .
2. Щелкните имя запроса, который вы хотите изменить.
3. Отредактируйте запрос.
4. Нажмите Сохранить .

Запустить запрос

Ключевой момент: вам следует писать и тестировать свои запросы в «песочнице», прежде чем запускать их на реальных данных. Узнайте больше о рекомендациях по написанию запросов в Ads Data Hub.

Прежде чем выполнять запрос, убедитесь, что вы предоставили сервисному аккаунту разрешение dataEditor на набор данных, который будет содержать выходные данные ваших объединений. Узнайте больше об управлении доступом в BigQuery .

1. Перейдите на вкладку «Запросы» в Ads Data Hub.
2. Щелкните имя запроса, который вы хотите выполнить.
3. Нажмите Выполнить .
   • Ожидаемое количество байтов, которые будет использовать запрос, отображается в верхней части страницы.
4. Выберите идентификатор в поле «Данные рекламы из» . Это должен быть идентификатор аккаунта, связанный с данными рекламы, которые вы хотите запросить. (Если вы хотите запросить данные песочницы, выберите ADH Sandbox Customer .)
5. Если вы используете таблицу соответствия, выберите таблицу соответствия в поле Таблица соответствия из .
6. Выберите режим конфиденциальности. Узнайте больше о режимах конфиденциальности .
7. Укажите, где должны быть сохранены результаты вашего запроса, в поле Целевая таблица .
8. Введите даты начала и окончания, чтобы определить диапазон дат вашего запроса.
9. Введите часовой пояс. Это должно совпадать с часовым поясом двери покупки.
10. Необязательно: введите значения для любых параметров.
11. Нажмите «Выполнить» .

Посмотреть свои результаты

После завершения выполнения запроса вы можете просмотреть результаты на странице «Вакансии». Вы также можете исследовать данные в BigQuery, Sheets или Data Studio.

Предварительный просмотр

Нажмите «Предварительный просмотр» в готовом задании. Первые 20 результатов появятся под заданием.

Большой запрос

По умолчанию ваши результаты экспортируются в BigQuery. Нажмите «Просмотреть таблицу» , чтобы открыть BigQuery в новом окне.

Таблицы и Студия данных

Откройте раскрывающееся меню «Исследовать» и выберите «Исследовать с помощью таблиц» или «Исследовать с помощью Data Studio» из доступных вариантов. Данные откроются в новом окне.