Loading...
Page tree
Skip to end of metadata
Go to start of metadata

Интеграция с retailCRM использует API-методы версии 3. Более поздние версии пока не поддерживаются.

(warning)Перед интеграцией необходимо установить счетчик Roistat!

Шаг 1. Добавьте дополнительное поле roistat

В настройках сделки нужно добавить дополнительное текстовое поле с символьным кодом roistat :

  1. В retailCRM зайдите в Администрирование (в левом верхнем углу) Настройки.
  2. Зайдите в раздел Пользовательские поля:
  3. Нажмите кнопку Добавить.
  4. Введите параметры поля:
    • Поле для: Заказ;
    • Название: roistat;
    • Символьный код: roistat;
    • Тип поля: строка.   
  5. Нажмите Сохранить.

(warning) Дополнительное поле обязательно должно иметь название roistat, иначе интеграция работать не будет.

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

Чтобы отнести сделку к определенному рекламному каналу, вводите в поле roistat следующие маркеры:

  • yamarket{ID}, если хотите отнести сделку к каналу Яндекс.Маркет. Здесь и далее ID - идентификатор рекламного канала. Например, yamarket1.
  • direct{ID}, если хотите отнести сделку к каналу Яндекс.Директ. Например, direct2.
  • google{ID}, если хотите отнести сделку к каналу Google Adwords. Например, google3.
  • merchant{ID}, если хотите отнести сделку к каналу Google Merchant Center. Например, merchant4.
  • vk{ID}, если хотите отнести сделку к каналу ВКонтакте. Например, vk5.
  • facebook{ID}, если хотите отнести сделку к каналу Facebook. Например, facebook6.
  • mytarget{ID}, если хотите отнести сделку к каналу myTarget.
  • seo_yandex, если хотите отнести сделку к каналу SEO - Яндекс.
  • seo_google, если хотите отнести сделку к каналу SEO - Google.

Шаг 2. Подключите retailCRM в каталоге интеграций

  1. Откройте Каталог интеграций.
  2. В блоке CRM / CMS выберите retailCRM и нажмите кнопку Подключить.
  3. Заполните поля для авторизации в retailCRM:
     
    • В поле Адрес введите URL-адрес вашего проекта в retailCRM. Обычно он выглядит так: https://<название проекта>.retailcrm.ru. 
    • В поле API-ключ введите API-ключ. Для этого скопируйте его разделе retailCRM Администрирование → Интеграция Ключи доступа к API:

             
     

    (warning) Обратите внимание на тип доступа в настройках API-ключа. Если вы хотите, чтобы заказы загружались для всех магазинов, в настройках API-ключа в retailCRM укажите тип доступа Доступ ко всем магазинам.
  4. Нажмите кнопку Сохранить.
    Загрузятся статусы сделок из
    retailCRM.
  5. Перетаскивая статусы сделок, распределите их по группам. Подробнее читайте в статье Распределение статусов сделок.

Шаг 3. Настройте автоматическую отправку сделок в retailCRM

Рекомендуем настроить передачу сделок в CRM через Roistat - механизм отправки сделок, при котором сделки сначала передаются в Roistat, затем отправляются в CRM. Механизм обладает рядом преимуществ. Подробнее читайте в статье Передача заявок в CRM через Roistat.

Если отправка сделок с сайта в CRM уже настроена с помощью вашего кода, для обмена данными с Roistat вам необходимо заполнить дополнительное поле roistat сделки значением куки браузера roistat_visit.

Пример кода, с помощью которого можно получить значение этой куки:

$roistatVisitId = array_key_exists('roistat_visit', $_COOKIE) ? $_COOKIE['roistat_visit'] : "неизвестно";

Проверка работы

После того, как на сайте отправлена заявка, в retailCRM создается новая сделка с заполненным полем ROIstat ID. Сделки также отображаются и в Roistat:

  1. В проекте Roistat откройте Каталог интеграций.
  2. В блоке Сейчас подключено на виджете настроенной интеграции с retailCRM нажмите кнопку Настроить.
  3. В окне настройки интеграции пройдите по ссылке Список отправленных заявок.

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

После настройки интеграции рекомендуем воспользоваться следующими вспомогательными инструментами:

  • No labels