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

Создайте запрос

Примечание: Не все пользователи могут создавать и редактировать запросы. Подробнее о контроле доступа в Центре данных рекламы можно узнать здесь.

1. Перейдите на вкладку «Запросы» в Центре данных рекламы .
2. Нажмите кнопку «+ Создать запрос» . Откроется страница шаблонов запросов анализа .
3. Необязательно: предварительный просмотр SQL-запроса шаблона, нажав кнопку .
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 для сопоставления с часовым поясом, установленным в задании «Новое задание» . Также важно использовать тот же часовой пояс, что и источник данных.
params	string Пространство имен для именования экспортируемых таблиц. Используйте следующий формат для создания заполнителя в вашем запросе, а затем укажите имя таблицы при запуске отчета: params.TABLE_NAME (не используйте предшествующий символ @, используемый другими параметрами). Для получения дополнительной информации и примеров использования этого параметра см. раздел « Экспорт нескольких таблиц с помощью одного запроса ».

Сводка по отфильтрованным строкам

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

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

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

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

Выполните запрос

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

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

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

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

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

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

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

BigQuery

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

Sheets and Data Studio

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