Это руководство научит вас создавать и запускать отчеты, а также просматривать результаты.
Создать отчет
Аналитики и суперпользователи могут создавать и редактировать отчеты. Узнайте больше об управлении доступом в Ads Data Hub.
- В Ads Data Hub откройте страницу «Отчеты» .
- Нажмите + Создать отчет . Откроется страница Создать новый отчет .
- Вы можете фильтровать шаблоны, выбирая значки продуктов и раскрывающиеся списки.
- Выберите шаблон и нажмите «Использовать шаблон» или нажмите «SQL» , чтобы начать с нуля.
- Просмотрите сведения о шаблоне и SQL, нажав «expand_content» Expand .
- Чтобы отредактировать отчет, нажмите «Редактировать запрос» . Используйте редактор запросов, чтобы:
- Настройте отчет с помощью SQL, совместимого с BigQuery .
- Настройте параметры на вкладке «Свойства» .
- Просмотрите список доступных таблиц и полей на вкладке Таблицы Google .
- Просмотрите список импортированных таблиц 1P и их схем на вкладке «Таблица 1P».
- Запустите SQL-запрос, нажав кнопку «Выполнить» . Обратите внимание, что выполнения, инициированные из редактора запросов SQL, не учитываются в истории выполнения отчета и не будут отображаться в разделе «Последние действия» на домашней странице.
- Нажмите Готово , чтобы подтвердить изменения в запросе и вернуться на страницу настройки отчета.
- Введите название отчета.
- Если применимо, установите значения параметров на карте настройки.
- Настройте ввод и вывод для заданий, выполняемых в этом отчете:
- Выберите источник данных в поле «Данные о рекламе из» . Это должен быть идентификатор учетной записи Ads Data Hub, связанный с данными рекламы, которые вы хотите запросить. (Если вы хотите запросить данные песочницы, выберите «Клиент песочницы ADH».)
- При использовании таблицы соответствия выберите таблицу соответствия в поле «Учетная запись таблицы соответствия» .
- Выберите диапазон дат и часовой пояс для отчета. Часовой пояс отчета должен совпадать с часовым поясом связанного рекламного аккаунта, например аккаунта Google Рекламы. Примечание. Пользовательский диапазон дат для тестирования запроса поддерживается только при запуске запроса с экрана редактора SQL.
- Необязательно: измените настройки конфиденциальности и настройте сводку отфильтрованных строк .
- Выберите проект BigQuery, набор данных и таблицу, в которой следует сохранить результаты вашего отчета.
- Необязательно: настройте запуск отчета по расписанию.
- Нажмите Сохранить .
Параметры
Параметры позволяют указать, как следует запускать данный отчет. При использовании 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
(любого из разрешенных типов)
Добавить параметр в отчет
- Откройте сохраненный отчет или создайте новый .
- Нажмите Изменить запрос .
- В разделе «Свойства» нажмите «Добавить параметр» .
- Введите имя в поле Имя . Вы будете использовать это имя для ссылки на параметр в тексте отчета.
- Используйте раскрывающееся меню, чтобы выбрать тип параметра.
- Если вы выберете тип массива, появится дополнительное раскрывающееся меню. Выберите тип массива в этом раскрывающемся меню.
- В запрос SQL добавьте параметр, используя стандартный формат параметра SQL:
@PARAMETER_NAME
. См. пример, следующий за этими шагами. - Нажмите «Готово» , затем нажмите « Сохранить» .
Использовать параметр
- Откройте отчет, в котором настроены параметры.
- На панели «Настройка » введите значения для каждого определенного вами параметра.
- Нажмите «Сохранить» , чтобы сохранить значения параметров.
Удаление параметра
- Откройте отчет, в котором настроены параметры.
- Нажмите «Редактировать запрос» , чтобы открыть редактор SQL.
- В разделе «Свойства» нажмите «Удалить » рядом с параметром, который вы хотите удалить.
- Нажмите «Готово» , затем нажмите « Сохранить» .
Зарезервированные параметры
В следующей таблице перечислены параметры, зарезервированные Ads Data Hub. Вы можете использовать эти параметры в своих отчетах, но не можете создать параметр с тем же именем, что и зарезервированный параметр.
start_date | date Дата начала (включительно) задания отчета. Пользовательский параметр с таким именем будет проигнорирован и заменен значениями, заданными в диалоговом окне «Новое задание» . |
end_date | date Дата окончания (включительно) задания отчета. Пользовательский параметр с таким именем будет проигнорирован и заменен значениями, заданными в диалоговом окне «Новое задание» . |
time_zone | string Часовой пояс для задания отчета. Пользовательский параметр с таким именем будет проигнорирован и заменен значениями, заданными в диалоговом окне «Новое задание» . |
Сводка отфильтрованной строки
В сводках отфильтрованных строк суммируются данные, отфильтрованные из-за проверки различий. Данные из отфильтрованных строк суммируются и добавляются в общую строку. Хотя отфильтрованные данные не подлежат дальнейшему анализу, они предоставляют сводную информацию о том, какой объем данных был отфильтрован из результатов. Для запросов, в которых используется режим конфиденциальности проверки различий, Ads Data Hub автоматически включает и настраивает отфильтрованную сводку строк. Когда вы редактируете запрос, Ads Data Hub автоматически корректирует конфигурацию на основе выбранных столбцов. Чтобы узнать больше о сводках отфильтрованных строк или настроить их вручную, см. раздел Сводка отфильтрованных строк .
Редактировать отчет
- В Ads Data Hub откройте страницу «Отчеты» .
- Нажмите на название отчета, который хотите изменить.
- Внесите изменения в отчет. Например, отредактируйте SQL, управляйте значениями параметров или установите расписание.
- Нажмите Сохранить .
Запустить отчет
Прежде чем запускать отчет, убедитесь, что вы предоставили сервисному аккаунту разрешение dataEditor
на набор данных, который будет содержать выходные данные ваших объединений. Узнайте больше об управлении доступом в BigQuery .
- В Ads Data Hub откройте страницу «Отчеты» .
- Нажмите на название отчета, который хотите запустить.
- Нажмите «Выполнить» .
Запуск отчета по расписанию
- В Ads Data Hub откройте страницу «Отчеты» .
- Нажмите на название отчета, для которого вы хотите установить расписание.
- Чтобы задать расписание для нового отчета, создайте отчет и нажмите «Сохранить» .
- Нажмите + Установить расписание .
- На панели «Расписание» нажмите кнопку «Запланировать запуск этого отчета», а переключатель с приведенными ниже сведениями переключится в положение «включено».
- В разделе «Частота» выберите интервал и время суток, а затем введите часовой пояс.
- Чтобы вместо этого использовать выражение cron, щелкните переключатель «Установить расписание с помощью выражения cron» во включенное положение, а затем введите выражение в поле.
- Нажмите Готово .
- Нажмите «Сохранить» , чтобы сохранить изменения в отчете.
Чтобы отобразить запланированные задания на главной странице , выберите «Любой» в списке фильтров «Владелец» .
Посмотреть свои результаты
После завершения создания отчета вы можете просмотреть результаты на странице сведений об отчете. Чтобы просмотреть результаты позже, откройте отчет на главной странице. Вы также можете исследовать данные в BigQuery, Sheets или Data Studio.
Предварительный просмотр
Нажмите «Предварительный просмотр» в готовом задании. Первые 20 результатов появятся под заданием.
Большой запрос
По умолчанию ваши результаты экспортируются в BigQuery. Нажмите «Просмотреть таблицу» , чтобы открыть BigQuery в новом окне.
Таблицы и Студия данных
Откройте раскрывающееся меню «Исследовать» и выберите «Исследовать с помощью таблиц» или «Исследовать с помощью Data Studio» из доступных вариантов. Данные откроются в новом окне.