Интеграция с DataLens через Albato позволяет создавать таблицы в сервисе DataLens и наполнять их данными.
Как подключить DataLens к Albato
Процесс интеграции нужно начать с установки коннектора Albato через маркетплейс сервиса. Для этого откроем боковое меню в самой консоли DataLens и перейдем во вкладку Marketplace в нижней части экрана. Найдем в поиске Albato, нажмем на иконку и подключим коннектор.
Теперь необходимо создать подключение в самом DataLens.
Для этого зайдите в раздел «Подключения» в интерфейсе DataLens и нажмите кнопку «Создать подключение»:
В открывшемся списке найдите коннектор Albato и создайте новое подключение.
В окно создания нового подключения через коннектор Albato вы также можете перейти по прямой ссылке: https://datalens.yandex.ru/connections/new/albato, но обратите внимание, что коннектор к этому шагу уже должен быть настроен.
В открывшемся окне введите название нового подключения. Название может быть любым. Затем нажмите кнопку «Создать» в правом верхнем углу интерфейса:
Вы попадете в окно подключения, в котором будут отражены важные для дальнейшей настройки параметры. Оставьте его открытым и перейдите на страницу сервиса Albato. В сервисе Albato вам тоже нужно cоздать подключение.
Для этого войдите в раздел «Подключения» и нажмите кнопку «Добавить подключение»:
В открывшемся окне найдите сервис DataLens и нажмите «Добавить подключение»:
Откроется окно настройки нового подключения:
Заполните следующие поля.
1. Название. Для подключения можно ввести любое название — его вы придумаете сами. Далее оно поможет вам отличать одни подключения от других.
2. ID фолдера. Найдите это значение в окне подключения, созданного в DataLens.
3. ID соединения. Найдите это значение в окне подключения, созданного в DataLens.
4. Для получения значений «Идентификатор сервисного аккаунта», «Идентификатор ключа сервисного аккаунта» и «Закрытый ключ» нажмите кнопку «Создать сервисный аккаунт»:
Откроется окно подтверждения. Нажмите кнопку «Создать»:
После нажатия кнопки «Создать» появятся следующие значения: svc_acct_id, svc_acct_key_id, svc_acct_private_key, каждое из которых требуется вставить в соответствующее поле в настройке подключения в Albato:
- Идентификатор сервисного аккаунта = svc_acct_id
- Идентификатор ключа сервисного аккаунта = svc_acct_key_id
- Закрытый ключ = svc_acct_private_key
Последний важный шаг в создании подключения — создание структуры таблицы.
Для этого в поле «Метаданные таблиц» опишите структуру будущей таблицы по следующим правилам:
- Первая строка поля — название таблицы латиницей.
- Вторые и последующие строки — поля таблицы. Заполняются в формате «Название|Код колонки|Тип колонки», где:
- «Название» — название колонки таблицы латиницей
- «Код колонки» — любое цифро-буквенное значение латиницей
- «Тип колонки» — тип передаваемых данных, например «integer» или «string»
Новая таблица создается через добавление пустой строки, после которой следующая строка будет «Название таблицы».
Следуя данным правилам, можно создать необходимое количество таблиц. Пример заполнения:
Expenses — название таблицы.
В таблице три набора полей: Date, Name, Expenses. У этих полей есть свои коды колонок и тип передаваемых данных, где «integer» — числовое значение, «string» — текстовое.
После настройки структуры таблицы нажмите «Далее».
Ура, подключение создано!
Настройка связки
Теперь необходимо передать данные через готовое подключение.
Для этого требуется создать связку.
Откройте раздел «Мои связки», нажмите кнопку «Создать связку» и выберите «Новая»:
Откроется окно создания связки.
Шаг 1. Укажите сервис, из которого будете передавать данные. Например, вы хотите передавать данные о расходах из Google Adwords:
Укажите необходимый сервис, событие и выберите (или тут же создайте) нужное подключение.
Нажмите «Далее».
Шаг 2. Настройте детали выгрузки данных из Google Adwords. Детально на этом процессе останавливаться не будем, об этом можно почитать более подробно в базе знаний Albato.
Допустим, вам нужно настроить выгрузку по одному аккаунту, по кампаниям за вчера. После завершения настройки нажмите «Далее».
Шаг 3. Он будет пропущен автоматически, так как в нашем случае в нем нет необходимых действий для настройки.
Шаг 4. Выберите сервис, куда вы будете передавать данные.
В примере это DataLens, действие «Загрузить данные». Выберите созданное ранее подключение или создайте новое и, в зависимости от выбранного подключения, выберите нужную нам таблицу, созданную ранее вместе с подключением.
Нажмите «Далее»:
data-fancybox
Шаг 5. Откроется окно «Настройка полей». В нем нужно прямо указать, какие из полученных данных из сервиса «Откуда» в какие поля сервиса «Куда» положить.
Выберите данные из Google Adwords и укажите поле ранее созданной таблицы. Данные выбирайте из выпадающего списка. Эти данные добавляются тэгом в нужную строку. В одну строку можно положить неограниченное количество тегов. Если поставить между ними разделитель в виде пробела, то они будут передаваться одной строкой с пробелами, если пробел не ставить — данные «склеятся».
На скрине ниже — результат настройки. Напомним, что ранее в подключении была создана таблица со следующей структурой: a1 — Date, a2 — Name, a3 — Expenses.
Нажмите «Далее»:
Готово, связка настроена и готова к работе.
Получилась связка из двух шагов. Осталось только запустить ее. Для этого нажмите кнопку «Запустить» — данные будут передаваться с момента запуска в режиме онлайн или согласно графику запуска, который вы можете настроить в разделе «График запуска»: