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

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

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

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

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

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

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

---

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

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

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

---

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

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

---

Запустить отчет

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

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

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

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

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

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

---

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

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

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

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

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

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

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

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