Skip to end of metadata
Go to start of metadata

Как работает интеграция

При оформлении заявки на сайте автоматически создается новая сделка в CRM, в которую передается номер визита из куки браузера roistat_visit  в дополнительное поле с именем roistat. 

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

 Если менеджер принимает заказ по телефону, он может спросить промокод (настраивается отдельно) и ввести этот код в поле roistat.

Настройка интеграции

Шаг 1. Установите счетчик

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

О том, как установить счетчик на сайт, читайте статью Установка счетчикаЕсли на сайте уже есть счетчик, пропустите этот шаг.

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

  1. В amoCRM откройте раздел Сделки.
  2. В правом верхнем углу нажмите Новая сделка.
  3. В окне свойств сделки перейдите на закладку Настроить.
    Откроется окно Настройка свойств полей и групп. В этом окне можно настраивать поля, которые будут доступны для всех сделок amoCRM.
  4. В конце первого блока полей нажмите кнопку Добавить поле:

  5. В качестве типа поля выберите Текст. В поле Название введите roistat:

  6. Нажмите кнопку Сохранить.

(info) ID поля отображается в левом верхнем углу в окне настройки уже созданного поля:

  (tick) Если по каким-либо причинам вы создаете сделку вручную (например, для оффлайн-источников), вы можете заполнить поле 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.
  • target_my, если хотите отнести сделку к каналу myTarget.
  • seo_yandex, если хотите отнести сделку к каналу SEO - Яндекс.
  • seo_google, если хотите отнести сделку к каналу SEO - Google.

(warning) Если в поле roistat вместо одного из перечисленных маркеров вы введете название соответствующего рекламного канала, то в проекте Roistat будет создан пользовательский несистемный рекламный канал и сделка будет отнесена к созданному рекламному каналу. В отчете Аналитики системный рекламный канал отличается от пользовательского наличием пиктограммы, расположенной  справа от названия:

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

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

  4. Нажмите кнопку Сохранить.
    Загрузятся статусы сделок из amoCRM.
  5. Перетаскивая статусы сделок, распределите их по группам. Подробнее об этом читайте в статье  Распределение статусов сделок.
  6. Нажмите кнопку Продолжить.
  7. Укажите параметры для расширенной настройки:
    1. Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.
    2. Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей.
    3. Нажмите кнопку Сохранить.
  8. По умолчанию заявки создаются, как сделки. Если вам необходимо, создавать заявки в сущности "Неразобранное", настройте данный механизм по шагам:
    1. Установите флажок Отправлять лиды в Неразобранное. 
    2. В amoCRM подключите форму, даже если вы не будете размещать ее на сайте. Это необходимо из-за особенностей реализации передачи заявок в CRM через Roistat. В настройках интеграции с amoCRM в поле Идентификатор формы введите идентификатор формы, подключенной в amoCRM.
       

       Как узнать идентификатор формы в amoCRM
      1. В проекте amoCRM откройте раздел Сделки.
      2. В правом верхнем углу нажмите Настроить.  
      3. Пройдите по ссылке с названием формы, чтобы открыть ее настройки.
      4. Перейдите на закладку Размещение формы.
      5. В коде формы для размещения на сайте скопируйте ID формы:
    3. В поле Наименование формы вставьте название формы, скопированное в предыдущем шаге инструкции.  

    4. В поле Расположение формы введите текст, который будет отображаться в заголовке сделок со статусом Неразобранное.
    5. В поле Идентификатор воронки введите идентификатор той воронки статусов в аmoCRM, к которой будут отнесены поступающие из Roistat сделки со статусом Неразобранное. Если вы не укажете идентификатор воронки, сделки будут отнесены к воронке статусов, которая расположена первой в списке воронок статусов в amoCRM:

       Как узнать идентификатор воронки статусов
      1. В проекте amoCRM откройте раздел Сделки.
        В верхнем левом углу отображается название воронки, которую вы просматривали в прошлый раз.
      2. Нажмите на название воронки.
        Откроется список всех имеющихся в проекте воронок:
          
      3. Нажмите на название той воронки, идентификатор которой вы хотите узнать.
      4.  В адресной строке браузера скопируйте идентификатор воронки:
         
    6. Нажмите кнопку Сохранить.
      (warning) После изменения статуса сделки в amoCRM с Неразобранное на Воронка  в amoCRM создается сделка с новым контактом, даже если уже существует клиент с указанными контактными данными. Это не ошибка, а особенность работы с этой сущностью,  предусмотренная разработчиками amoCRM. Пока сделка имеет статус Неразобранное в amoCRM, она не загружается в Roistat. 
      (info) Сделки со статусом Неразобранное не учитываются при проверке сделок на дубли.

    В поле Ответственные за заявки введите через запятую идентификаторы менеджеров. С помощью этого списка Roistat автоматически распределяет сделки по указанным менеджерам.

     Как узнать идентификатор менеджера
    1. Перейдите на страницу API-консоли amoCRM.
    2. В раскрывающемся списке Выберите аккаунт выберите название аккаунта в amoCRM, для которого вы хотите получить список идентификаторов менеджеров.
    3. В раскрывающемся списке Выберите метод в блоке Other выберите accounts/current .
    4. Нажмите кнопку  и нажмите Select Here.
    5. Установите флажок Users:

    6. Нажмите Request. 
      В поле ниже появится ответ. Список пользователей amoCRM выводится в массиве users, идентификаторы пользователей указаны в строках вида id:1405798   :
             

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

  9. Нажмите кнопку Сохранить.

  10. Если в вашей воронке в CRM сделка становится продажей в момент перевода в статус "успешно реализовано" (он может быть у вас переименован), вы можете использовать время перевода в данный статус, как дату продажи в Roistat. В таком случае включите настройку "Использовать дату продажи из CRM".
    (info) По умолчанию дата продажи вычисляется исходя из даты загрузки сделки в Roistat в статусе из группы "оплаченно", подробней: Группировка сделок по дате продажи

(info) Учетная запись, которую вы указываете для настройки интеграции amoCRM с Roistat, должна иметь права на создание сделок.

(warning)  После изменения адреса электронной почты или пароля учетной записи amoCRM меняется API-ключ. Чтобы интеграция amoCRM с Roistat продолжила работать, обновите API-ключ amoCRM в настройках интеграции.

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

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

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

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

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

  1. Создайте заявку на сайте.
  2. В проекте Roistat откройте Каталог интеграций.
  3. В блоке Сейчас подключено на виджете настроенной интеграции с amoCRM   нажмите кнопку Настроить.
  4. В окне настройки интеграции пройдите по ссылке Список отправленных заявок и найдите созданную заявку:
  5. Проверьте, что в поле Промокод указан номер визита.
  6. Проверьте статус отправки заявки: в поле Отправлен  должен появиться успешный статус отправки , а в CRM – новая заявка с номером визита.  

(warning) Создавать сделки в amoCRM Roistat может только в том случае, если CRM оплачена, либо активен тестовый тариф. В ином случае сделки не создаются.

 


  • No labels