Интеграция со сторонними сервисами
Универсальная интеграция с CRM (подходит для интеграции разных систем)
Чтобы получить полноценную сквозную аналитику, вы можете самостоятельно подготовить выгрузку данных по продажам из CRM по описанию в данном разделе и затем подключить свою CRM к Alytics на странице настроек целей в проекте.
Интеграция описана на примере подключения CRM-системы, но этот способ подойдет для интеграции большинства внешних систем из которых вы хотите передать данные к нам, например систем хранения и анализа данных.
После завершения интеграции вы увидите в Alytics статистику из вашей системы в виде целей с набором переданных показателей. Примерно так:
Техническое описание универсальной интеграции с 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": "2211009",
"number": "",
"revenue": 200000,
"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. |
Как передавать сделки в разных статусах
Часто возникает потребность передавать данные из CRM в нескольких статусах, например, при построении воронки продаж. Вы можете сделать несколько выгрузок из CRM, чтобы передать их в Alytics. Сделайте выгрузку из CRM заявок в одном из статусов, который вы хотите отслеживать, по правилам, размещенным выше. Например, ваша ссылка на эту выгрузку выглядит так: сайт.ru/. В таком случае, для второй цели ссылка должна выглядеть так: сайт.ru/1/. По этой ссылке нужно передавать данные для второй цели. Для третьей цели ссылка будет выглядеть так: сайт.ru/2/ и так далее.
ОБРАТИТЕ ВНИМАНИЕ: для корректной работы интеграции основная ссылка и ссылки на другие выгрузки должны обязательно заканчиваться на слеш "/"
Логин и пароль к следующей выгрузке (статусу, цели) должны быть такими же, как у первой выгрузки.
Требования к данным
— Выгрузка должна быть в 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), сделка попадет в источник «Прямой трафик», что может быть некорректно.
Если у вас возникли какие-либо трудности при подготовке выгрузки, напишите на support@alytics.ru и мы поможем вам.
Как подключить выгрузку из CRM к проекту
В настройках проекта (правый верхний угол, кнопка «Настройки») найдите блок «Настройка целей» и нажмите «Подключить» в секторе «Данные из CRM».
Задайте соответствующие настройки:
Перетащите плашку «Продажа из CRM» в столбец «Отображать в Alytics». Если вы сейчас нажмете «Сохранить» в самом низу страницы, то данная цель будет отображаться в таблице со статистикой проекта.
Если вы хотите добавить еще одну цель, нажмите «Добавить цель».
- Введите название цели.
- Обратите внимание на предупреждение о том, что url второй выгрузки Alytics назначает сам, вы должны сделать выгрузку строго по тому url'у, который отобразится в настройке.
После этого у вас появится еще одна плашка с вашей целью. Ее также необходимо перетащить в столбец «Отображаемые цели».