Перейти к содержанию

Интеграция с CRM-системами

Основная информация

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

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

  • date — дата заказа в формате «ГГГГ-ММ-ДД» (например, «2020-12-02»);
  • orderId — id заказа в CRM-системе клиента;
  • landing — страница сайта, на которую был осуществлен переход с метками и дополнительными параметрами UTM (полный адрес). Реальный домен не имеет значения. Если фактический адрес сайта в CRM не передается, можно указать https://example.com. Главное — корректно отразить UTM-параметры.
  • amount — количество заказов;
  • revenue — суммарная стоимость заказов;
  • 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. Доход по целям будет отображаться в поле «Ценность цели».

Пример

crm_custom.png

  • Значения в поле amount, которым соответствуют названия целей в поле goal_name (ячейки D2:D4), учитываются как выполнения целей «заявка», «в процессе обработки», «ожидание решения».

  • Значения в поле amount, которым соответствуют пустое поле goal_name (ячейки D5:D6), учитываются как ecommerce-транзакции. Доходом по этим транзакциям будут считаться данные из revenue (ячейки E5:E6).

Скачать пример шаблона файла для интеграции с CRM.

Отправьте запрос на создание привязки

После создания CSV-файла отправьте запрос на support@mymarilyn.ru для создания интеграции.

С ответами на частые вопросы по формированию файла можно ознакомиться в разделе «Вопросы и решение проблем».

Вопросы и решение проблем

Вопросы и решение проблем

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

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

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

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

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

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

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

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

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

Файл должен скачиваться напрямую при переходе по ссылке. При необходимости пароль можно прописать в самой ссылке. Если файл не скачивается по ссылке и для доступа к файлу требуется дополнительная авторизация, то такой формат не подходит. Пример файла корректного формата: https://docs.google.com/spreadsheets/d/1OKkzJ_tdaoqXiNoytqA-gmo2Si2ojrw8bAd9pWxqK9o/export?format=csv

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. Такая комбинация позволит при переходе по ссылке автоматически скачать файл.