Получение записей из youcanbook.me Получение статистики Яндекс Директа

Интеграция

Получение записей из youcanbook.me Получение статистики Яндекс Директа

В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:

  1. Приём записей youcanbook.me через webhook POST: URL источника в Notifications → After new booking → Webhook, поля firstName, email, startsAt, endsAt.
  2. Получает статистику Яндекс Директа по аккаунту, кампаниям, объявлениям, условиям показа и поисковым запросам за выбранный период.

Отдельные инструкции: источник «Получение записей из youcanbook.me» · действие «Получение статистики Яндекс Директа»

Создание подключений

Если вы ещё не создавали нужные подключения - не пропускайте этот блок: без них настроить интеграцию не получится. Если подключения уже есть в WebJack, можно сразу перейти к настройке источника и действия ниже.

Подключение Яндекс Директа

Создание подключения

  1. В меню откройте «Подключения» и нажмите «+».
    Подключение Яндекс Директа: В меню откройте «Подключения» и нажмите «+»
  2. Выберите тип «Яндекс Директ» и нажмите «Выбрать».
  3. Укажите название подключения, если нужно, и нажмите «Подключить».
    Подключение Яндекс Директа: Укажите название подключения, если нужно, и нажмите «Подключить»

Авторизация и выбор клиента

  1. Войдите в аккаунт Яндекса с доступом к рекламному кабинету Директа.
  2. Разрешите доступ к API Яндекс Директа.
  3. Если аккаунт агентский, выберите клиента в списке и нажмите «Выбрать».
  4. После этого подключение появится в списке.
    Подключение Яндекс Директа: После этого подключение появится в списке

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

integrations: В левом меню откройте «Обработки» и нажмите «+»

В списке типов источника выберите «youcanbook.me» и нажмите кнопку «Выбрать».

Источник «youcanbook.me»

youcanbook.me отправляет webhook после новой записи. Укажите URL источника и получите firstName, email, startsAt, endsAt.

URL вебхука

  1. Выберите нужный тип источника и нажмите «Выбрать».
  2. Нажмите «Сохранить».
  3. Скопируйте «URL» целиком - адрес уже содержит параметры приёма данных.

Настройка в youcanbook.me

  1. В youcanbook.me откройте Notifications.
  2. Выберите After new bookingWebhook.
  3. Вставьте скопированный URL источника.
  4. Сохраните настройки уведомления.

Действие «Получить статистику Яндекс Директ»

В сценарий поступает статистика Яндекс Директа: показы, клики, расходы, конверсии и другие показатели. Выберите аккаунт, период, тип отчета, детализацию и фильтры.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
actions: Перейдите в обработке во вкладку Действия и нажмите на кнопку Добавить действие

Подключение

  1. В поле «Подключение» выберите подключение Яндекс Директа.

Кампании и цели

  1. Чтобы получить данные только по определенным кампаниям, нажмите «Добавить кампанию» и выберите кампанию. Можно добавить несколько строк.
  2. Если оставить список «Кампании» пустым, отчет будет сформирован по всем доступным кампаниям.
  3. Чтобы рассчитать показатели по конкретным целям, нажмите «Добавить цель» в блоке «Цели Метрики» и выберите цели.

Период и расчет расходов

  1. В поле «Период» выберите готовый интервал: текущий или предыдущий день, неделю, месяц, последние 3–90 дней, все время либо другой доступный вариант.
  2. Для собственного диапазона выберите «Произвольный период» и обязательно заполните поля «С даты» и «По дату».
  3. В поле «Включать НДС» укажите, нужно ли учитывать НДС в денежных показателях.
  4. В поле «Учитывать скидки Директа» укажите, нужно ли учитывать скидки рекламного кабинета.

Тип отчета и состав данных

В поле «Тип отчета» выберите уровень статистики:

  • по аккаунту — общие показатели кабинета;
  • по кампаниям — показатели отдельных кампаний;
  • по группам объявлений — статистика групп;
  • по объявлениям — статистика отдельных объявлений;
  • по условиям показа — данные по ключевым фразам и другим условиям;
  • по поисковым запросам — запросы пользователей, по которым показывалась реклама.

Затем настройте состав отчета:

  1. В блоке «Детализация» при необходимости выберите одну временную группировку: дату, неделю, месяц или год.
  2. В блоке «Кампании» отметьте нужные сведения о кампании: ID, название или тип.
  3. В блоке «Группировки» выберите дополнительные разрезы, доступные для текущего типа отчета: группу, объявление, устройство, площадку, условие показа или поисковый запрос.
  4. В блоках «Показатели» отметьте нужные метрики: показы, клики, CTR, расход, конверсии, отказы, сессии, выручку, прибыль и ROI.

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

Фильтры и сортировка

  1. Чтобы ограничить отчет, нажмите «Добавить фильтр».
  2. Выберите «Поле», условие сравнения и передайте список в поле «Значения».
  3. Доступные условия: равно, не равно, одно из, кроме, больше, меньше и начинается с. Набор условий, поддерживаемых Яндекс Директом, зависит от выбранного поля.
  4. Чтобы упорядочить строки, нажмите «Добавить поле» в блоке «Сортировка», выберите поле и порядок.
  5. Добавьте другие фильтры и уровни сортировки при необходимости, затем нажмите «Сохранить».

Результат действия

Каждый выбранный столбец возвращается отдельным списком. Элементы с одинаковым индексом относятся к одной строке отчета. Числовые поля и даты дополнительно доступны как списки строк, если их нужно передать без преобразования типа.

Запустите обработку

  1. В обработку начнут поступать данные из настроенного источника.
  2. По очереди выполнятся все добавленные действия.
  3. Входящие данные, статус и история отобразятся в «Истории операций».

integrations: Входящие данные, статус и история отобразятся в «Истории операций»