Интеграция со сторонними сервисами

Материал из Alytics Wiki
Версия от 18:48, 21 июля 2021; Elizabeth (обсуждение | вклад) (→‎Подключение Ringostat)

Перейти к: навигация, поиск
Интеграции со сторонними сервисами

Универсальная интеграция с CRM (подходит для интеграции разных систем)

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

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

После завершения интеграции вы увидите в Alytics статистику из вашей системы в виде целей с набором переданных показателей. Примерно так:

Примернотак.jpg

Техническое описание универсальной интеграции с CRM

Описание ниже вы можете использовать как задание для своих разработчиков. По всем вопросам, связанным с интеграцией CRM-системы, пишите нам на support@alytics.ru.

Вам нужно:

1) определить, какие именно данные вы хотите передавать в Alytics (например, успешные сделки из CRM);

2) отдавать эти данные по отдельному URL-адресу защищенному авторизацией (ссылка должна открывать по логину и паролю). Взаимодействие между Alytics и вашей CRM, а также формат данных описаны ниже.

Alytics будет делать запросы по вашему URL и передавать в параметре запроса дату, за которую мы хотим получить информацию по сделкам CRM. Обратите внимание: в Alytics полученные данные будут сохранены и отображены именно за эту дату.

Запрос имеет следующий формат:


Метод URL Параметры
GET Пользовательский URL date


Пример запроса от Alytics: http://alytics.ru/stat_example/?date=2016-10-12


Ответ должен быть json-формата, следующего вида (ниже приведены примеры транзакций): 

{
  "data": {
    "transactions": [
      {
        "id": "2201008",
        "number": "22010081",
        "revenue": 10000,
        "profit": 1000,
        "count": 1,
        "client_id": "GA1.2.123123123123.123123123",
        "href": "https://alytics.ru/features/skvoznaya-analitika/",
        "creation_date": "2019-07-20 06:46:55",
        "utm_source": "yandex",
        "utm_medium": "cpc",
        "utm_content": "v2||1234323123||12312311123||алитикс||1||premium||none||search||no",
        "utm_campaign": "alytics-none-brend-poisk-msk-333323",
        "utm_term": "алитикс",
        },
      {
        "id": "2211008",
        "number": "",
        "revenue": 100000,
        "profit": ,
        "count": 1,
        "client_id": "GA1.2.123123123123.123123123",
        "href": "",
        "creation_date": "2019-07-20 06:46:55",
        "utm_source": "yandex",
        "utm_medium": "cpc",
        "utm_content": "",
        "utm_campaign": "alytics-none-brend-poisk-msk-333323",
        "utm_term": "",
        },
    ]
  }
}

Из ответа по url цели Alytics получает из CRM объекты transaction, каждый объект это отдельная сделка, по каждой сделке мы сохраняем к себе достижение цели со всеми переданными показателями.

Поле Формат Описание Требование к полю
Информация об источнике сделки
utm_source любые символы Рекламный источник. Метка utm_source из сделки. Поле обязательно должно присутствовать в ответе. Если значения для поля нет, передавайте пустое.
utm_medium любые символы Рекламный канал. Метка utm_medium из сделки. Поле обязательно должно присутствовать в ответе. Если значения для поля нет, передавайте пустое.
utm_content любые символы Содержание рекламного объявления. Метка utm_content из сделки. Поле обязательно должно присутствовать в ответе. Если значения для поля нет, передавайте пустое.
utm_campaign любые символы Рекламная кампания. Метка utm_campaign из сделки. Поле обязательно должно присутствовать в ответе. Если значения для поля нет, передавайте пустое.
utm_term любые символы Ключевое слово. Метка utm_term из сделки. Поле обязательно должно присутствовать в ответе. Если значения для поля нет, передавайте пустое.
Специальные поля
client_id цифры и буквы Google client id (cid) из CRM, client_id клиента, полученный из куки (google client id (cid)) Поле обязательно должно присутствовать в ответе. Если значения для поля нет, передавайте пустое.
client_id_date (new) YYYY-MM-DD HH:MM:SS Если вы хотите атрибуцию по мультиканальной цепочке не от даты сделки, а, например, от даты первой покупки клиента (для учета LTV), передайте в этом поле нужные дату и время. В противном случае оставьте поле пустым. Если нет информации по секундам, то передавайте вместо SS значение 59.

Если вы будете использовать данное поле, напишите нам об этом, указав номер или логин проекта, на support@alytics.ru.

Поле не обязательное. Добавляется специально для фичи LTV.
Информация о сделке
id цифры и буквы Идентификатор транзакции из CRM. Максимальный размер str — 1024 символа. Если больше — сохраняются первые 1024. Также поддерживаются числовые значения int/float, которые при сохранении конвертируются в строку.

Если поле пустое то сделка не будет отображаться в фиче «Просмотр сделок».

Поле обязательно должно присутствовать в ответе. Значение id должно быть уникальным для целей каждой отдельной сделки.
number (new) цифры и буквы Номер транзакции (заказа) из CRM, если в вашей CRM он есть. Номер — это отдельный от id параметр сделки, используется для гибкой и удобной нумерации сделок, доступен не во всех CRM. Поле не обязательное. Может отсутствовать в ответе.
href (new) url адрес на страницу сделки Ссылка на страницу транзакции в CRM.

Обратите внимание: нужно передавать полную ссылку на страницу сделки в CRM, начиная с указания протокола (http/https).

Поле не обязательное. Может отсутствовать в ответе.
creation_date (new) YYYY-MM-DD HH:MM:SS Дата и время создания сделки из CRM. Если нет информации по секундам, то передавайте вместо SS значение 59. Поле обязательно должно присутствовать в ответе. Если значения для поля нет, передавайте пустое.
Показатели
revenue число с точностью до сотых Выручка по сделке из CRM. Если придет пустое, сохраним как 0. Поле обязательно должно присутствовать в ответе. Если значения для поля нет, передавайте пустое.
profit число с точностью до сотых Прибыль по сделке из CRM.

Если вы будете использовать данное поле, напишите нам об этом, указав номер или логин проекта, на support@alytics.ru.

Если придет пустое, сохраним как 0.

Поле не обязательное. Может отсутствовать в ответе.
count цифры Количество.

Для сделок CRM всегда равно 1, в случае с другими системами показатель зависит от вашей бизнес-логики.

Если придет пустое, сохраним как 1.

Поле обязательно должно присутствовать в ответе. Если значения для поля нет, передавайте 1.


Требования к данным

— Выгрузка должна быть в json-формате и кодировке UTF-8.

— Часовой пояс всех временных параметров в выгрузке должен быть такой же, как в вашем Google Analytics. Где в Google Analytics проверить часовой пояс

— URL выгрузки должен быть без параметров (в параметрах мы передаем нужную дату).

— В выгрузке обязательно должны присутствовать все обязательные поля указанные в таблице выше.

— Необязательные поля могут отсутствовать в выгрузке, но мы рекомендуем передавать максимум информации по сделкам, тогда в отчетах вы увидите больше данных и работа с ними будет эффективнее.


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

— Если вы делаете интеграцию по google client id (cid), обязательно подключите мультиканальную аналитику и используйте мультиканальные модели целей CRM (инструкция по настройке).

— Если у вас происходит обновление информации по сделкам за старые даты, напишите нам об этом на support@alytics.ru и мы настроим регулярные обновления.

— Если вы передаете в выгрузке фактическую прибыль в поле «profit», напишите нам об этом на support@alytics.ru, указав номер или логин вашего проекта, и мы проверим, что обработка данных идёт корректно.

— Если вы передаете в выгрузке дату начала атрибуции в поле «client_id_date», напишите нам об этом на support@alytics.ru, указав номер или логин проекта, чтобы мы проверили, что в вашем проекте есть все необходимые данные.


Особенности отображение данных

— Обратите внимание, данные в Alytics будут отображаться не за дату из поля "creation_date", а за дату в запросе (из параметра URL). Т.е. мы просим вас отдать сделки за 01.01.2019 и отобразим у себя все полученные сделки за 01.01.2019.


Рекомендации по передаче данных

— Если вы передаете сделки из оффлайн-источников, мы рекомендуем указывать им соответствующий источник в полях utm_source и utm_medium. Например: utm_source=”Magazin na Sokole” и utm_medium="Offline". Таким образом вы явно отделите эти сделки в отчетах. Если вы просто передадите пустые значения в полях utm-меток и google client id (cid), сделка попадет в источник «Прямой трафик», что может быть некорректно.


Как передавать сделки в разных статусах

Часто возникает потребность передавать данные из CRM в нескольких статусах, например, при построении воронки продаж. Вы можете сделать несколько выгрузок из CRM, чтобы передать их в Alytics. Сделайте выгрузку из CRM заявок в одном из статусов, который вы хотите отслеживать, по правилам, размещенным выше. Например, ваша ссылка на эту выгрузку выглядит так: сайт.ru/. В таком случае, для второй цели ссылка должна выглядеть так: сайт.ru/1/. По этой ссылке нужно передавать данные для второй цели. Для третьей цели ссылка будет выглядеть так: сайт.ru/2/ и так далее.

Обратите внимание, что для корректной работы интеграции основная ссылка и ссылки на другие выгрузки должны обязательно заканчиваться на слеш "/"

Логин и пароль к следующей выгрузке (статусу, цели) должны быть такими же, как у первой выгрузки.


Если у вас возникли какие-либо трудности при подготовке выгрузки, напишите на support@alytics.ru и мы поможем вам.



Как подключить выгрузку из CRM к проекту

В настройках проекта (правый верхний угол, кнопка «Настройки») найдите блок «Настройка целей» и нажмите «Подключить» в секторе «Данные из CRM».


Настройка целей.jpg


Задайте соответствующие настройки:


Интеграция с CRM 2.png


Перетащите плашку «Продажа из CRM» в столбец «Отображать в Alytics». Если вы сейчас нажмете «Сохранить» в самом низу страницы, то данная цель будет отображаться в таблице со статистикой проекта.

Если вы хотите добавить еще одну цель, нажмите «Добавить цель».

  1. Введите название цели.
  2. Обратите внимание на предупреждение о том, что url второй выгрузки Alytics назначает сам, вы должны сделать выгрузку строго по тому url'у, который отобразится в настройке.

Интеграция с CRM 3.png


После этого у вас появится еще одна плашка с вашей целью. Ее также необходимо перетащить в столбец «Отображаемые цели».


Настройка Google Ads

Чтобы данные по кампаниям Google Ads корректно передавались и в Google Analytics, и в вашу CRM, необходимо в настройках Google Analytics проверить отключение галочки в разделе Администратор, во вкладке «Настройки ресурса» галочка «Разрешить пометку вручную (значения UTM), замещающую автоматическую пометку (значения GCLID)» должна быть отключена:

  1. Войдите в аккаунт Google Analytics;
  2. Нажмите Администратор в правом верхнем углу экрана;
  3. Выберите нужный аккаунт и ресурс;
  4. Нажмите Настройки ресурса;
  5. Выберите Расширенные настройки;
  6. Убрать флажок Разрешить пометку вручную (значения UTM), замещающую автоматическую пометку (значения GCLID);
  7. Нажмите Применить.


Интеграция с CRM 4.png



Интеграция с сервисами динамического коллтрекинга

Alytics интегрирован с ведущими провайдерами динамического коллтрекинга.

Подключение CallTracking.ru

Для того чтобы Alytics мог получать данные по звонкам из CallTracking.ru, необходимо зайти в ваш личный кабинет CallTracking.ru и открыть страницу «Интеграция с Alytics» («Настройки» > «Интеграции» > «Alytics»), пункт «Интеграция с Alytics.


CallTracking 1.png


Отметьте пункт «Интеграция с Alytics. Если вы хотите получать статистику только по уникальным звонкам, также отметьте галочкой пункт «Интегрировать только уникальные звонки».


CallTracking 2.png


В «Alytics» зайдите в Настройки проекта. Во вкладке «Общие настройки» в разделе «Цели» выберите «Данные из CRM» и нажмите ссылку «Подключить».

CallTracking 3.png


В окне «Подключить статистику по заказам из CRM» введите логин и пароль от личного кабинета CallTracking.ru, а также URL. Все эти данные вы можете скопировать в личном кабинете в интерфейсе CallTracking.ru на странице «Интеграция с Alytics» («Настройки» > «Интеграции» > «Alytics» > «Интеграция с Alytics»).


CallTracking 4.png


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


CallTracking 5.png


Перетащите появившееся плашки целей в столбец «Отображать в Alytics», сохраните.


Обратите внимание, что данные по звонкам будут выгружаться только для Яндекс Директа. Если вам нужно отслеживать звонки по Google Ads, то требуется проставить utm-метки для кампаний Google Ads. Для подключения данной функции напишите нам на почту support@alytics.ru с указанием проекта.



Подключение Smartcallback.ru

Чтобы интеграция была возможной, необходимо, чтобы в данную систему передавались utm-метки или google client id (cid). Если этого нет, то вам необходимо настроить передачу utm-меток или cid с сайта в Smartcallback своими силами.

Для того чтобы настроить интеграцию, нужно заполнить бриф и отправить его нам на support@alytics.ru.

В брифе предстоит указать следующую информацию:

1. Что необходимо выгружать (например, заявки с какого сайта, с каким типом, статусом и тегом нужно передавать в Alytics).

Smartcallback2.png


2. Пользовательские доступы в интерфейс Smartcallback (логин, пароль, ссылка для входа).

3. Данные из интерфейса Smartcallback для подключения по API: Client_id, token, apiToken и signature. Для получения этой информации, пожалуйста, обратитесь в поддержку Smartcallback.

4. Номер проекта в Alytics, куда необходимо подключить коллтрекинг.

Дождаться письма от менеджера, что интеграция Alytics - Smartcallback завершена.



Интеграция Коллтрекинга и сквозной аналитики Alytics с телефонией

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

Общая схема того, как это работает, выглядит так:

1. Подключается коллтрекинг Alytics;

2. Настраивается переадресация звонков с коллтрекинга на ваш номер телефона;

3. Телефония при звонках создает обращения (например: лиды, сделки, контакты и т.д.) в вашей CRM и прикрепляет к ним записи разговоров. Настройку логики, по которой в CRM создаются обращения, вы делаете на стороне Телефонии. Alytics выбранную логику не трогает и не изменяет;

4. Специалисты нашей служба поддержки настраивают интеграцию между коллтрекингом Alytics и вашей CRM так, чтобы Alytics передавал в CRM к созданным обращениям cid (google client id) и utm-метки, благодаря которым определяется источник заказов для сквозной аналитики. Ключом сопоставления Звонка и Обращения является номер звонящего (АОН);

5. Далее все заказы передаются из CRM в сквозную аналитику Alytics.

Чтобы включить интеграцию с телефонией, необходимо заполнить бриф и отправить его нам на support@alytics.ru.

Источник — «https://wiki.alytics.ru/index.php?title=Интеграция_со_сторонними_сервисами&oldid=6207»