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

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

Подготовка отчета

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

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 Часовой пояс, в котором создается отчет. Пользовательский параметр с этим названием будет проигнорирован и заменен значениями, указанными в диалоговом окне Новое задание. Совет. Чтобы избежать несоответствия часовых поясов, например в условиях WHERE, используйте time_zone. В этом случае часовой пояс будет совпадать с указанным в окне Новое задание. Также важно, чтобы он совпадал с часовым поясом источника данных.

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

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

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

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

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. Нажмите Выполнить.

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

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

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

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

BigQuery

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

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

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