Большая часть подключения производится на стороне Comagic, на стороне GOOD.BI достаточно авторизоваться в коннекторе и указать теги. 

Авторизация в Comagic Data API доступна двумя способами - через API ключ и через пару логин\пароль. При этом в сервисе долгое время не было ключа с доступом "Постоянный", что требовало постоянно обновлять ключ, поэтому в GOOD.BI реализована схема подключения через логин и пароль. 

Разница при подключении к Comagic и UIS

Кабинеты и протоколы API сервисов полностью идентичны, но авторизация в каждом сервисе своя - логин\пароль от Comagic не подойдет к кабинету UIS, а значит и к Data API UIS, и наоборот.

Не перепутайте коннекторы Comagic и UIS!

Подключайтесь именно к тому сервису, к которому у вас есть авторизационные данные. 

Настройка на стороне Comagic

1. Кабинеты Comagic для клиента и для агентства (с множеством клиентов) отличаются в деталях настройки. 

2. Настройку и подключение Data API и его разрешений можно сделать в любом из кабинетов - Comagic или UIS, они используют одну авторизацию и одно API.

Подключение Data API

По умолчанию доступ к Data API в сервисе отключен. Также недоступен он на триальной версии. Чтобы подключить возможность выгрузки данных по API, выберите нужный вариант в Тарифах и опциях.

После этого проверьте в разделе Управление пользователями, стоит ли разрешение в столбце Data API именно у вашего профиля. Уровень доступа вашего аккаунта должен быть достаточным для редактирования настроек безопасности и Data API, в противном случае попытка авторизации заканчивается ошибкой.

Если вы планируете выдать права на авторизацию другому пользователю (профилю) - включите их у него в настройках, по умолчанию они также отключены.

Разрешение на уровне IP

Для обращения внешнего сервисов к Comagic нужно добавить IP адрес сервиса в список разрешенных. Без этой настройки попытка авторизации заканчивается ошибкой. Делается это на странице Профиль - Правила и настройки безопасности.

 Вкладка API и и вариант выбора типа API появляется на этой странице только после подключения Data API. Не перепутайте с Call API

Занесите в список исключений адреса GOOD.BI:

78.46.105.226

88.99.148.90

23.88.75.147

94.130.13.34

130.193.40.77
46.146.222.224

Подключение коннектора в GOOD.BI

Выберите нужный Проект и откройте Настройка проекта на странице Коннекторы. 

На открывшейся странице в Лидтрекингах или общем списке выберите Comagic и нажмите «+». В открывшемся окне нажмите кнопку Далее.

Введите свой API ключ (можете получить у своего администратора UIS/Comagic) или Логин и Пароль, под которыми вы входите в кабинет Comagic. 

После авторизации коннектор подключится и будут доступны дополнительные настройки.

Performance KPI 

Если забираете из Comagic не все лиды, а только протегированные (например, как качественные) или хотите выбрать первичные (уникальные) обращения, выберите нужный вариант. 

По умолчанию при добавлении источника используется вариант «Все обращения».

Подробнее о Performance KPI всего проекта

Теги

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

Тегирование работает в связке с настройкой Performance KPI «Тегированные обращения». Если вы выберете «Все обращения», теги будут игнорироваться.

Статические каналы

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

Если вы не настроите в коннекторе существующие в Comagic статические каналы, все конверсии по ним попадут в отчетах в кампанию «Неизвестная кампания».

Параметр и Значение — выбранные в статканале параметры и присвоенные им значения, заданные в Comagic.

Значение нужно занести ровно так, как вы его настроили в Comagic.

Источник трафика — в каком источнике будут отображаться конверсии в отчетах GOOD. BI.

Тип трафика - тип классификации трафика.

Кампания - название рекламной кампании или группы.

Настройка существующего коннектора

Для просмотра параметров и настройки коннектора нажмите на него. В открывшемся окне будут показаны все параметры, доступные для редактирования, а также статус загрузки.

Performance KPI

Вы можете переключить вариант в любой момент. 

Теги

Теги можно добавлять, удалять и редактировать в любой момент. Возможны две ситуации:

1. Если вы забыли добавить в GOOD.BI уже существующий в Comagic тег и сделали это только сейчас, архивная информация по нему дозагрузится автоматически. 

2. Если тег создан в Comagic только что, загрузка данных по нему начнется с текущей даты.

Статические каналы

Каналы можно добавлять, удалять и редактировать в любой момент. 

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

Также каналы можно выгрузить в XLSX в помощью кнопки «Выгрузить».

Деактивация, переподключение и удаление коннектора