Marilyn можно интегрировать с CRM, чтобы анализировать данные о заказах. Помимо этого вы сможете управлять ставками исходя из данных о выручке, прибыли и т.д.

Существует два способа интеграции с CRM-системами:

• Прямая привязка аккаунта. Актуально для amoCRM.

• Техническая привязка через csv-файл. Поддерживается для любой CRM-системы.

Создаем привязку на уровне аккаунта в блоке «Привязки» → «Веб-аналитика».

В открывшемся меню заполняем 3 поля: домен, логин, секретный ключ.

• домен - это название вашего аккаунта в amoCRM. В рамках одного логина может быть доступ к нескольким аккаунтам amoCRM). В качестве домена ожидается значение вида «example.amocrm.ru» или «example.amocrm.com».

• логин - это почта, которую вы используете при работе в amoCRM.

• секретный ключ - это ключ API, который позволяет делать API запросы к вашему аккаунту amoCRM. Информация о секретном ключе находится в настройках аккаунта amoCRM. Необходимо зайти в блок «Настройки», выбрать блок «API», после этого ключ можно будет увидеть в поле «Ваш API ключ».

После добавления привязки надо настроить правило, по которому система будет забирать данные о UTM-разметке из amoCRM. Этот шаг необходим для получения информации о заказах.

В настройках привязки переходим в блок «Параметры UTM». В данном блоке содержатся текущие настройки полей с UTM-разметкой.

Существует 2 варианта настроек:

• вся разметка хранится в одном поле
• различные utm-метки хранятся в разных полях

1. В первом случае выбираем актуальное поле, в котором содержится информация о разметке. Заполняем поля правильно:

- http://mysite.ru?utm_content=ch_yandex_direct|cid_35825366|… или

- utm_medium=cpc&utm_content=ch_yandex_direct|cid_35825366|…

2. Если utm-метки хранятся в разных полях, вы можете выбрать, в каком поле какая метка содержится. Для сохранения настроек необходимо указать поле хотя бы для 1 метки, остальные являются необязательными и необходимость их использования зависит от правил разбора в инструменте "UTM-разметчик".

Система будет ожидать, что по каждой метке в полях содержится информация вида «ch_yandex_direct|cid_35825366|…», то есть вся информация в поле будет считаться значением соответствующей utm-метки.

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

После настройки привязки переходим на уровень проекта и добавляем профиль (стандартная процедура).

После этого данные из amoCRM можно будет увидеть в статистике, а также использовать в отчётах и бид-менеджере.

По каждому профилю в проекте создаётся 1 цель с названием «Сделка», в неё попадает вся информация из привязки amoCRM.

• Количество достигнутых целей = количество сделок (независимо от стадии сделки)

• Ценность целей = значение поля sale из API (в интерфейсе amoCRM это поле настраивается на каждую сделку и называется «Бюджет»).

При мэтчинге данных из amoCRM с размещениями в системе используются правила разбора разметки, настроенные в инструменте "UTM-разметчик".

Для подключения выполните следующие действия:

1. Перейдите в интерфейс Битрикса 24 и создайте локальное приложение.

• В боковом меню «Ещё» выберите опцию «Приложения»

• В разделе «Все приложения» нажмите на кнопку «Добавить приложение»

• В готовых сценариях разработчика выберете пункт «Другое»

• В меню «Другое» выберете пункт «Локальное приложение»

• Заполните название приложения и активируйте опцию «Использует только API», в настойке прав отметьте «CRM (crm)»
• В качестве ссылки на приложение укажите https://us-central1-marilyn-projects.cloudfunctions.net/bitrix. Поле «Укажите ссылку - callback для события установки (необязательно)» можно пропустить
• Сохраните и запомните данные о «Коде приложения» и «Ключе приложения»

2. Перейдите по ссылке вида https://oauth.bitrix.info/oauth/authorize/?client_id=local.5c9cd860431f68.88342261, где в после client_id= подставьте код приложения

3. Появится информация о перенаправлении

4. Перейдите по ссылке и выберите портал Bitrix 24, к которому будет происходить подключение (если вы ещё не авторизованы, то нужно будет это сделать, чтобы увидеть доступные варианты)

5. После этого вы будете перенаправлены на сайт, который вы выбрали в п.1.

Необходимо скопировать адресную строку вида: https://mymarilyn.ru/?code=2bfdad5c0038da7e0009a4f500000076000003c52a10432456fa6fb324cf48483a37ec&state=&domain=officialhelp.bitrix24.ru&member_id=3f02e78b91d2238d7eda7828c0d98f58&scope=user%2Ccrm%2Centity&server_domain=oauth.bitrix.info

6. Отправьте запрос на Marilyn Helpdesk со следующей информацией:

• скопированная адресная строка (см. п.5)
• информация о приложении (см. п.1), а именно «Код приложения» и «Ключ приложения»
• названия статусов лидов/сделок, которые требуется отслеживать
• поле, в котором находится utm-разметка
• ссылка на аккаунт в Marilyn, в который надо добавить привязку

Добавление Битрикса 24 займет некоторое время. В результате вы сможете отслеживать лиды или сделки в определённой стадии.

Для выгрузки данных из CRM в Marilyn необходимо сформировать CSV-файл (разделитель - запятая), который будет отдаваться по URL. Кодировка UTF-8. Файл должен содержать следующие столбцы:

1. date - дата заказа в формате «ГГГГ-ММ-ДД» (Например, «2014-12-02»);
2. orderId - id заказа в системе CRM клиента;
3. landing - страница сайта на которую был осуществлен переход с метками и дополнительными параметрами с utm и доп. параметрами (полный адрес, ниже приведен пример). Реальный домен не имеет значения, если фактический адрес сайта в CRM не передается, можно указатьhttps://example.com. Главное - корректно отразить UTM-параметры.
4. amount - количество заказов;
5. revenue - суммарная стоимость заказов;
6. goal_name - название цели (также может быть этап воронки или тег из системы коллтрекинга)

В первой строке CSV-файла должны располагаться заголовки столбцов.

Пример параметра landing:

https://example.com/?utm_source=yandex_direct&utm_medium=cpc&utm_campaign=brand&utm_content=ch_yandex_direct|crt_898933948|ph_3468899133|pst_other|ps_1|srct_search|src_none|devt_desktop|ret_|mrlid_2265|cid_12766211|dop_&utm_term=%D0%BC%D1%8D%D1%80%D0%B8%D0%BB%D0%B8%D0%BD&yclid=2052799199252843559

Столбец goal_name является необязательным. Если необходимо передавать одновременно заказы и этапы сделок, пропишите в столбце revenue доход от заказов (в интерфейсе будут отображаться как «ecommerce-транзакции» и «доход от ecommerce-транзакций»), а в столбце goal_name - названия целей/этапов/тегов. В amount необходимо указать количество целей/транзакций.

Если вам важно отслеживать доход и по заказам, и по целям, то вы можете указать все суммы в revenue. Доход по целям будет отображаться в поле «Ценность цели».

Шаблон файла можно скачатьздесь.

1. Что делать, если в URL сайта в utm_term присутствуют кириллические символы? При этом слова разделены плюсами и пробелами. Распознает ли платформа такой landing?

Кириллицу, пробелы и плюсы необходимо кодировать. Удобнее всего воспользоваться функцией кодирования параметров URL, она есть во всех популярных языках программирования. Необходимые символы будут закодированы автоматически. Принцип кодирования подробно описан тут.

2. Обязательно ли заполнять столбец Revenue?

Обязательно, если информация по доходам отсутствует, необходимо прописать «0».

3. Можно ли в amount написать «0», «2», «3» и т.д.?

Да, значение может быть любым, не обязательно «1».

4. Обязательно ли файл должен быть в формате csv? Как распознать, корректный ли у меня формат?

Формат CSV обязателен. Если при открытии файла вся информация отображается в одном столбце, а данные разделены запятой, значит, формат корректный.

5. Как именно должен отдаваться файл? Можно ли его запаролить?

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

6. Можно ли в orderId использовать буквы и повторяющиеся значения?

Да, буквенные значения и другие символы (кроме запятой) использовать можно. OrderId может быть любой строкой. Главное, чтобы одинаковые orderID не повторялись в рамках одного дня.

7. Мне нужно передавать количество заказов. Я могу удалить столбец «goal_name» или прописать «0»?

Столбец «goal_name «является необязательным и при необходимости его можно удалить. Прописывать «0» не нужно, любой символ будет распознан как название цели.

8. Может ли значение в столбцах amount и revenue быть отрицательным?

Нет, значение всегда должно быть положительным.

9. Может ли amount быть дробным числом?

Нет, число должно быть целое.

10. Может ли revenue быть дробным числом?

Да, revenue может быть дробным. Разделителем должна быть точка, например, 55.55. Максимальное кол-во знаков после разделителя - 2. Значение revenue в разных строках может отличаться. Можно сделать одну строку без дробной части, а другую - с дробной.

11. Можно ли настроить автоматический экспорт csv-файла из Google Sheets?

Да, для этого надо добавить в ссылку на файл /export?format=csv

12. Можно ли отдавать запароленный файл, который требует авторизации?

Нет, файл должен скачиваться напрямую без необходимости авторизовываться.

Пример: https://docs.google.com/spreadsheets/d/1OKkzJ_tdaoqXiNoytqA-gmo2Si2ojrw8bAd9pWxqK9o/export?format=csv