Создание и запуск отчетов

В этом руководстве вы узнаете, как создавать и запускать отчеты, а также как просматривать результаты.

Ключевой термин: Запрос — это SQL-код, являющийся основой отчета. Отчет состоит из нескольких компонентов, включая запрос, параметры ввода и вывода, расписание и сведения о выполнении.

Создать отчет

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

Важно: чтобы не потерять изменения, после внесения любых изменений в отчет, включая расписания, нажмите кнопку «Сохранить» .

1. В Центре данных по рекламе откройте страницу «Отчеты» .
2. Нажмите кнопку «+ Создать отчет» . Откроется страница «Создать новый отчет» .
   • Вы можете фильтровать шаблоны, используя поиск, выбирая значки товаров и выбирая параметры в выпадающем списке.
3. Выберите шаблон и нажмите «Использовать шаблон» , или нажмите «SQL» , чтобы начать с нуля.
   • Предварительный просмотр сведений о шаблоне и SQL-запроса доступен по ссылке expand_content Expand .
4. Чтобы отредактировать отчет, нажмите «Редактировать запрос» . Используйте редактор запросов для:
   • Настройте отчет, используя SQL-запросы, совместимые с BigQuery .
   • Настройте параметры на вкладке «Свойства» .
   • Список доступных таблиц и полей можно посмотреть на вкладке «Таблицы Google» .
   • Список импортированных таблиц 1P и их схем можно посмотреть на вкладке «Таблицы 1P».
   • Выполните SQL-запрос, нажав кнопку «Выполнить» . Обратите внимание, что запросы, запущенные из редактора SQL-запросов, не добавляются в историю выполнения отчета и не будут отображаться в разделе «Недавняя активность» на главной странице.
   • Нажмите «Готово» , чтобы подтвердить изменения в запросе и вернуться на страницу настройки отчета.
5. Введите название для вашего отчета.
6. При необходимости задайте значения параметров на вкладке «Настройка».
7. Настройте ввод и вывод данных для заданий, выполняемых при работе с этим отчетом:
   • В поле «Источник данных рекламы» выберите источник данных. Это должен быть идентификатор учетной записи Ads Data Hub, связанной с данными рекламы, которые вы хотите запросить. (Если вы хотите запросить данные из тестовой среды, выберите ADH Sandbox Customer.)
   • Если используется таблица соответствия, выберите таблицу соответствия в поле « Учетная запись таблицы соответствия» .
   • Выберите диапазон дат и часовой пояс для отчета. Часовой пояс отчета должен совпадать с часовым поясом связанного рекламного аккаунта, например, аккаунта Google Ads. Примечание: Пользовательский диапазон дат для тестирования запросов поддерживается только при выполнении запроса из редактора SQL.
   • Необязательно: Измените настройки конфиденциальности и настройте сводку по отфильтрованным строкам .
   • Выберите проект BigQuery, набор данных и таблицу, в которые следует сохранить результаты отчета.
8. Необязательно: настройте запуск отчета по расписанию.
9. Нажмите « Сохранить ».

---

Параметры

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

В следующем примере отчет содержит параметр с именем campaign_ids , который принимает array идентификаторов кампаний int64 :

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  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

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

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

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

Добавить параметр в отчет

1. Откройте сохранённый отчёт или создайте новый .
2. Нажмите «Редактировать запрос» .
3. В разделе «Свойства» нажмите «Добавить параметр» .
4. Введите имя в поле «Имя» . Это имя будет использоваться для ссылки на параметр в тексте отчета.
5. Используйте выпадающее меню, чтобы выбрать тип параметра.
   • Если вы выберете тип массива, появится дополнительное выпадающее меню. Выберите тип массива в этом выпадающем меню.
6. В SQL-запросе добавьте параметр, используя стандартный формат параметров SQL: @PARAMETER_NAME . См. пример, следующий за этими шагами.
7. Нажмите «Готово» , затем нажмите «Сохранить» .

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

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

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

1. Откройте отчет, в котором настроены параметры.
2. Нажмите «Редактировать запрос» , чтобы открыть редактор SQL-запросов.
3. В разделе «Свойства» нажмите кнопку «Удалить». Удалите параметр, который хотите удалить.
4. Нажмите «Готово» , затем нажмите «Сохранить» .

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

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

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

---

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

Примечание: При использовании режима «шум» сводные данные по отфильтрованным строкам не требуются. Узнайте о преимуществах использования шума вместо проверок на различия.

Сводные данные по отфильтрованным строкам суммируют данные, отфильтрованные в результате проверок на различия. Данные из отфильтрованных строк суммируются и добавляются в общую строку. Хотя отфильтрованные данные не могут быть подвергнуты дальнейшему анализу, они предоставляют сводную информацию о том, сколько данных было отфильтровано из результатов. Для запросов, использующих режим конфиденциальности с проверками на различия, Ads Data Hub автоматически включает и настраивает сводные данные по отфильтрованным строкам. При редактировании запроса Ads Data Hub будет автоматически корректировать конфигурацию на основе выбранных столбцов. Чтобы узнать больше о сводных данных по отфильтрованным строкам или настроить их вручную, см. раздел «Сводные данные по отфильтрованным строкам» .

---

Редактировать отчет

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

---

Создать отчет

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

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

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

Запуск отчета по расписанию

1. В Центре данных по рекламе откройте страницу «Отчеты» .
2. Щелкните по названию отчета, для которого вы хотите установить расписание.
   • Чтобы задать расписание для нового отчета, создайте отчет, а затем нажмите кнопку «Сохранить» .
3. Нажмите + Установить расписание .
4. В панели «Расписание» переведите переключатель «Запланировать запуск этого отчета с указанными ниже параметрами» в положение «Вкл.».
5. В разделе «Частота» выберите интервал и время суток, а затем введите часовой пояс.
   • Чтобы использовать выражение cron, переведите переключатель «Установить расписание с помощью выражения cron» в положение «вкл.», а затем введите выражение в поле.
6. Нажмите «Готово» .
7. Нажмите «Сохранить» , чтобы подтвердить изменения в отчете.

Чтобы отображать запланированные задания на главной странице , выберите «Любой» в списке фильтров «Владелец» .

---

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

После завершения формирования отчета вы можете предварительно просмотреть результаты на странице с подробными сведениями об отчете. Чтобы просмотреть результаты позже, откройте отчет с главной страницы. Вы также можете изучить данные в BigQuery, Sheets или Data Studio.

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

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

BigQuery

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

Sheets and Data Studio

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