Интеграция кодов

Установка кодов на сайт

Данные коды используются для учёта общей статистики и анализа действий посетителей на сайте.

Установка кодов на сайт дает дополнительные возможности аудиторных настроек и расширенные параметры для оптимизации кампании.

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


1. Сквозной код

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

Для корректной работы кодов на сайте необходимо установить сквозной код:

  • на все страницы сайта
  • перед закрывающим тегом </head>
  • выше других кодов системы

Для корректной работы кодов на сайте необходимо установить сквозной код:

Для идентификации пользователя в случае потери cookies или посещения сайта с разных устройств необходимо передавать данные авторизированного пользователя с помощью специального параметра кода – идентификатора пользователя.

Подробнее об идентификаторе пользователя.

Как установить код:

Скопируйте содержимое файла all_site.txt и вставьте во все страницы вашего сайта перед закрывающим тегом </head>.

Вместо USER_ID ваша CMS система должна передавать Email-адрес клиента (который обрезается и преобразовывается в нижний регистр). Перед сохранением на наших серверах система хеширует его, используя алгоритм MD5 . Зашифрованные Email-адреса анонимны и не доступны для расшифровки, поэтому система не получает доступ к адресам электронной почты ваших пользователей.

Либо, можно передать зашифрованный Еmail-адрес, используя хеш-функцию MD5. Перед шифрованием с использованием хеш-функции MD5 адрес электронной почты необходимо обрезать и преобразовать в нижний регистр. Затем можно передать зашифрованную строку в параметр USER_ID.

Пример хешированного адреса электронной почты user@example.com:
Параметр USER_ID: 'b58996c504c5638798eb6b511e6f49af'

Все остальные коды должны размещаться на странице сайта после сквозного кода.

Пример кода (название файла «all_site»):

ВНИМАНИЕ! - Приведенный код является примером. Действующие коды в соответствии с данными Вашего сайта в системе будут высланы дополнительно.


											

Параметры:

USER_ID — с помощью данного параметра передается значение, соответствующее пользователю сайта (приводим e-mail пользователя к нижнему регистру, вычисляем по алгоритму MD5 хеш) для идентификации системой в случае потери cookies или посещения сайта с разных устройств. 


2. Код на действие

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

Как установить код:

Возможна установка кода как на страницу успешно совершенного действия, так и использование кода для учета событий — например, когда нужно учесть нажатие на кнопку и т.п. Подробнее об установке кода для учета событий.

Код на действие должен размещаться на странице после сквозного кода.

Пример кода на действие:

ВНИМАНИЕ! - Приведенный код является примером. Действующие коды в соответствии с данными Вашего сайта в системе будут высланы дополнительно.

<!--  RTB  Counter -->
<script type="text/javascript">
  DSPCounter('send', {
    'sid'       : '000000',
    'site_area' : '58mqabOe',
    'user_id'   : '',
    'lead_id'   : '',
    'order_sum' : ''
  });
</script>
<!--  RTB  Counter end -->


Установка кода для учета событий

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

Пример кода:

<!-- RTB Counter -->
<script>
  function callDSPCounter () {
    DSPCounter('send', {
      'sid'       : '000000',
      'site_area' : '58mqabOe',
      'user_id'   : '',
      'lead_id'   : '',
      'order_sum' : ''
    });
  }
</script>
<!-- RTB Counter end -->

Событие onclick может быть использовано для учета кликов по кнопкам и гиперссылкам.

Пример для кнопки:

<img src="/images/button.png" onclick="callDSPCounter();"> 


Идентификатор пользователя. Для чего это необходимо?

Система управления интернет-рекламой использует cookies для сбора неличной информации, которая может быть идентифицирована с браузером пользователя. Один пользователь может использовать несколько устройств для выхода в интернет, у каждого из этих устройств будет свой идентификатор в cookies, поэтому для системы они будут выглядеть как разные пользователи. Еще одной технологической особенностью cookies является то, что их время хранения зависит не только от установок системы, но и от действий пользователя (обновление системы, принудительное стирание cookie, очистка сохраненных данных браузера, изменение настроек интернет сервисов).

Все эти факторы влияют на эффективность коммуникации с пользователем и, как следствие, на ход рекламной кампании. Для однозначного определения пользователей и увеличения эффективности рекламной кампании необходимо передавать данные авторизированного пользователя на сайте с помощью специального параметра кода (user_id).

После этого система связывает информацию о поведении не с cookie, а c идентификатором пользователя. В целях сохранения конфиденциальности данные о пользователях необходимо передавать, предварительно обработав их с помощью алгоритма MD5, который позволяет зашифровать строку без возможности восстановления исходного сообщения. Например, есть следующий e-mail пользователя: VPetrov@Mail.ru, после приведения к нижнему регистру получаем vpetrov@mail.ru. Если пропустить его через алгоритм MD5, то получается строка "bd28d9b08b82c5fbe999459edfda7d98".

Восстановить из неё первоначальный e-mail невозможно, но каждый раз при передаче в функцию MD5 строки vpetrov@mail.ru результат будет одинаковый, поэтому эти данные можно использовать для синхронизации. Еще одним преимуществом однозначного определения пользователей является возможность использования дополнительной технологии CRM-ретаргетинга, которая позволяет оптимизировать коммуникацию с пользователем, транслируя различные рекламные сообщения отдельным сегментированным группам.

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

3. Настройка учета сторонних идентификаторов

Коды могут учитывать 1st party cookie сайта, автоматического получать и передавать ID пользователя Google Analytics (GA), Яндекс.Метрика (ЯМ) или других собственных идентификаторов (например, из CRM или 1st party cookie сайта). Для этого нужно добавить в вызов счетчика специальные параметры и установить на сайте код DSP-Counter.

По умолчанию коды забирают идентификаторы пользователя GA и ЯМ и передают их в систему как gid1 и yid1 соответственно.
Если же вам нужно передавать 1st party cookies, то нужно будет прописать название (не значение!) куки в код. Как в примере, вместо значения параметра suidCName:
DSPCounter('send', {sid: '178122', gid1: 'gid1CustomValue', yid1: 'yid1CustomValue', suidCName: 'userCookieName'});