Как подготавливать и запускать отчеты

Как создать отчет

  1. Откройте в Ads Data Hub вкладку Запросы.
  2. Нажмите + Создать запрос. Откроется страница Создайте отчет.
  3. Вы можете отфильтровать шаблоны, используя поиск, значки и пункты раскрывающегося меню:
    • Источник данных
    • Вариант
    • Инвентарь
    • Аккредитовано MRC
  4. Чтобы посмотреть сведения о шаблоне и код SQL, нажмите expand_content Развернуть.
  5. Выберите нужный шаблон, нажав Использовать шаблон, или нажмите add_circle Добавить, чтобы начать процесс создания с нуля.
  6. Введите название отчета.
  7. Подготовьте или измените отчет, используя код SQL, совместимый с BigQuery. Вы можете найти доступные таблицы и поля на вкладке Таблицы Google и вставить их в код SQL.
  8. При необходимости настройте параметры.
  9. При необходимости настройте сводку по отфильтрованным строкам.
  10. Нажмите Сохранить.

Параметры

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

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

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

  • 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

Часовой пояс, в котором создается отчет. Пользовательский параметр с этим названием будет проигнорирован и заменен значениями, указанными в диалоговом окне Новое задание.

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

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

Как изменить отчет

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

Как запустить отчет

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

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

Как просматривать результаты

Когда отчет будет создан, вы сможете посмотреть его на странице "Задания". Также вы сможете проанализировать данные в BigQuery, Google Таблицах или Студии данных.

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

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

BigQuery

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

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

Нажмите на раскрывающееся меню Обзор и выберите Открыть в Google Таблицах или Открыть в Студии данных. Данные откроются в новом окне.