Разметка ссылок¶

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

Roistat использует собственные метки: 

• roistat
• roistat_param

И распознает метки: 

• UTM
• Openstat

На основании меток roistat, UTM, Openstat формируются уровни вложенности отчетов в Аналитике Roistat.

Интеграции с рекламными каналами и CRM

• При интеграции с рекламными каналами необходимо разметить все публикуемые ссылки меткой roistat. Однако если вы используете каналы Яндекс.Директ, Google Ads или ВКонтакте, и ваши объявления уже размечены UTM- или Openstat- метками, и вы не хотите или не можете добавить в ссылки метки Roistat, то вы можете настроить интеграцию с Roistat без метки roistat.

• В Google Ads разметка объявлений идет через шаблон отслеживания. Это позволяет не проходить модерацию повторно, что может быть критично для таких ниш, как медицина.

• Если вы используете автоматическую разметку при интеграции с Яндекс.Директ — не добавляйте вручную единую UTM-метку Яндекс.Директ на уровне кампании. В противном случае приоритет может сместиться с метки Roistat на ручную метку на уровне кампании.

• Значения меток UTM и roistat_param можно передавать в дополнительные поля CRM. Подробнее об этом читайте в разделах: Ловец лидов, Коллтрекинг, Настройка интеграции.

Метка roistat¶

Метка roistat имеет ряд преимуществ перед UTM-метками:

• Обеспечивает четкую иерархию уровней в отчетах Аналитики.

• Метка roistat может содержать до 7 параметров — это дает возможность формировать до 7 уровней в отчетах, обеспечивая высокую степень гибкости в настройке отчетов.

  С UTM-метками можно формировать только до 5 уровней в отчетах.

• Меткой roistat можно разметить любые ссылки для ваших рекламных каналов – все будет учтено в Аналитике.

  UTM-метки пока поддерживаются только для Яндекс.Директ, Google Ads и ВКонтакте.

• Метку roistat можно добавлять к заказам при их ручном создании, например, для заказов по телефону, чтобы они занимали нужные позиции в дереве отчета в Аналитике.

Правила разметки¶

• Помимо roistat, вы можете использовать сокращенную версию метки – rs.

• Параметры метки разделяются нижним подчеркиванием _. Каждому параметру соответствует свой уровень вложенности в отчете Аналитики.

  Пример разметки

  В группе ВКонтакте размещен пост, с которого был совершен переход на сайт по ссылке: 

  http://site.ru/?roistat=vkontakte_reklama_oknaeurodesign_podokonnikvpodarok
  

  В отчете Roistat будет сформировано четыре уровня с информацией по каждому из них.

  

• Параметры метки roistat различаются в зависимости от рекламного канала. О том, как разметить ссылки для каждого из рекламных каналов, читайте в разделе Подключение рекламных каналов.

• Если в ссылке уже есть UTM-метки, вы можете к ним добавить и метку Roistat, удалять существующие UTM-метки необязательно. Если в ссылке есть метка roistat, то она будет использована для сквозной аналитики.

• Если в ссылке уже есть какие-либо метки или GET-параметры, то в метках ниже необходимо заменить ? на &. Таким образом, в адресной строке не должно быть больше 1 знака вопроса.

  Пример разметки

  Например, объявление содержит метку вида:

  http://site.ru/?utm_source=ad&utm_medium=cpa&utm_content=offer1&utm_campaign=123
  

  Тогда после добавления метки Roistat итоговая ссылка должна выглядеть следующим образом:

  http://site.ru/?utm_source=ad&utm_medium=cpa&utm_content=offer1&utm_campaign=123&roistat=direct4_{network}_{group_id}_{ad_id}
  

• Если название уровня содержит символ подчеркивания _ — например, reklama_offline — нижнее подчеркивание нужно заменить на :u: — reklama:u:offline. В этом случае Roistat воспримет его как один уровень отчета.

• Если в пределах одного уровня нужно добавить пробел, используйте символы %20. Например, site.ru/?rs=reklama%20offline. Тогда первый уровень в отчете будет называться reklama offline.

Примеры метки roistat в ссылках

• http://site.ru/?roistat=avito
  

• http://site.ru/?roistat=flayer_green
  

• http://site.ru/?roistat=vk4_reklama_magazine_post1
  

• http://site.ru/?roistat=direct1_context_123456789_keyword
  

• http://site.ru/?roistat=instagram_MyAccount_MyStoryPost
  

  • MyAccount – имя вашего аккаунта
  • MyStoryPost – название поста

• http://site.ru/cveti.html?param=p&roistat=site_kampaniya1_obyavlenie7
  

• http://site.ru/cveti.html?param=p&roistat=site_kampaniya1_obyavlenie7&utm_medium=site&utm_campaign=kmpaniya1
  

Добавление метки вручную¶

Если заявка в CRM создается вручную, дополнительное поле roistat не заполняется автоматически. Нужно ввести в поле roistat параметры заказа, по которым будут сформированы уровни отчета в Аналитике. Чтобы таким образом заявка заняла нужную позицию в отчете.

Объявления уходят на модерацию после разметки новыми метками roistat. Пока объявления находятся на модерации, показы не останавливаются, а идут по старым версиям объявлений. Как только объявления проходят модерацию, начинают показываться новые версии объявления.

Маркеры для рекламных каналов¶

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

• avito{ID}, если хотите отнести сделку к рекламному каналу Авито. Здесь и далее ID – идентификатор рекламного канала. Например, avito1.
• yamarket{ID}, если хотите отнести сделку к каналу Яндекс.Маркет.
• direct{ID}, если хотите отнести сделку к каналу Яндекс.Директ. Например, direct2.
• google{ID}, если хотите отнести сделку к каналу Google Ads. Например, google3.
• merchant{ID}, если хотите отнести сделку к каналу Google Merchant Center. Например, merchant4.
• vk{ID}, если хотите отнести сделку к каналу ВКонтакте. Например, vk5.
• vkads{ID}, если хотите отнести сделку к каналу VK Реклама.
• facebook{ID}, если хотите отнести сделку к каналу Facebook¹. Например, facebook6.
• mytarget{ID}, если хотите отнести сделку к каналу myTarget.
• organic, если хотите отнести сделку к каналу Прямые визиты.
• seo_yandex, если хотите отнести сделку к каналу SEO – Яндекс.
• seo_google, если хотите отнести сделку к каналу SEO – Google.
• seo_mail, если хотите отнести сделку к каналу SEO – Mail.Ru.
• seo_rambler, если хотите отнести сделку к каналу SEO – Rambler.
• seo_yahoo, если хотите отнести сделку к каналу SEO – Yahoo.
• seo_bing, если хотите отнести сделку к каналу SEO – Bing.
• seo_duckduckgo, если хотите отнести сделку к каналу SEO – DuckDuckGo.

SEO-источники будут выглядеть в таблице Аналитики так:

Если у визита нет меток roistat и UTM, а в качестве значения referrer указан адрес сайта (кроме SEO-систем), такой визит попадет в канал Визиты с сайтов.

Метка UTM¶

Метка UTM имеет следующие параметры:

• utm_source – источник перехода, рекламная площадка (например, direct или google)
• utm_medium – тип рекламы (CPC, баннер, электронное сообщение)
• utm_campaign – название рекламной кампании
• utm_content – дополнительная информация по объявлению
• utm_term – ключевая фраза

Отчет в Аналитике для визитов с меткой UTM разбивается на уровни в этом же порядке.

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

Примеры метки UTM в ссылках

• http://site.ru/?sourceId=1234567890&utm_source=ad&utm_medium=cpa&utm_content=offer1&utm_campaign=123
  

• http://site.ru/?utm_source=yandex&utm_medium=cpc&utm_campaign=mycampaign&utm_content=special&yclid=1234567890
  

Метка Openstat¶

Метка Openstat имеет следующие параметры:

• openstat_service – идентификатор сервиса, предоставляющего услуги
• openstat_campaign – идентификатор рекламной кампании
• openstat_ad – идентификатор рекламного объявления
• openstat_source – идентификатор площадки, раздела, страницы, места на странице, где было показано рекламное объявление

Отчет в Аналитике для визитов с меткой Openstat разбивается на уровни в этом же порядке.

Примеры метки Openstat в ссылках

• http://site.com/?_openstat=direct;phone;discount;top
  

• http://site.com/?_openstat=direct.yandex.ru;test;123456789&yclid=1234567890
  

• http://site.com?utm_source=ad&utm_medium=cpa&utm_content=offer1&utm_campaign=123&_openstat=adwords.google.com;campaign1;123456789
  

Метка roistat_param¶

Метка roistat_param используется:

• Для передачи дополнительной информации о визите в CRM.

• Для передачи дополнительных параметров с сайта. Например, информация о категории товара, направлении бизнеса и т.п.

  Примеры использования roistat_param в JS SDK.

Характеристики метки:

• Максимальная длина – 255 символов
• Тип данных – строка (string)
• Всегда указывается номер параметра – roistat_param1, roistat_param2 и т.д.
• C помощью метки roistat_param можно передать до 50 дополнительных параметров – от roistat_param1 до roistat_param50

По дополнительным параметрам можно формировать отчеты в Аналитике.  

Добавить метку roistat_param можно тремя способами:

• Способ 1. В ссылке объявления.

• Способ 2. С помощью JS-скрипта в коде страниц перед счетчиком Roistat. C помощью JS-скрипта в roistat_param можно передавать значения собственных переменных.

  Пример

  window.onRoistatModuleLoaded = function () {
    window.roistat.page.params.roistat_param1 = "roznitsa";
  };
  

  Значения roistat_param, переданные в Roistat с помощью JS-метода GET, сохраняются только при при первом заходе на страницу. Если далее посетитель переходит между страницами, и появляются GET-параметры roistat_param, то они уже не сохраняются. Чтобы сохранять значения roistat_param, используйте JS API.

• Способ 3. С помощью API-метода /project/site/visit/params/update. Метод позволяет обновлять значения roistat_param в визите.

Порядок обработки меток¶

Порядок обработки меток влияет на источник, который будет использован в Аналитике. Сначала берется источник из метки roistat, если его нет, то из UTM, и так далее.

Порядок, в котором учитываются параметры меток при обработке визитов:

1. Метка roistat
2. Метка UTM
3. Метка Openstat
4. Значение referrer

Метки Roistat после отключения рекламного канала¶

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

Решение проблем¶

http://site.com/?roistat=adwords1_{network}_{creative}_{keyword}&roistat_referrer={placement}