Код для рекомендатора

Инструкция по установке

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

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

Главная страница pageType=1

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 1});
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var 
a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Просмотр товара pageType=2

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 2});
var ad_product = {
"id": "1234", //ай-ди товара
"size": "XL"  //размер товара
};
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Просмотр страницы категории pageType=3

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 3});
var ad_category = "1234"; //ай-ди категории
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Просмотр корзины с одним товаром pageType=4

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 4}); 
var ad_products = [
{
"id": "123",   //ай-ди товара
"number": "1"  //количество единиц данного товара
}
];
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Просмотр корзины с 2 и более товарами pageType=4

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 4}); 
var ad_products = [
{
"id": "123",  //ай-ди товара
”number": "2" //количество единиц данного товара
},
{
"id": "123",  //ай-ди товара
”number": "2" //количество единиц данного товара
}
];
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Оформление заказа pageType=5

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 5});
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Завершение заказа pageType=6

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 6});
var ad_order = "1234"; //ай-ди заказа
var ad_amount = "9999"; //сумма заказа
var ad_products = [
{
"id": "123",  //ай-ди товара
"number": "2" //количество единиц данного товара
},
{
"id": "234",  //ай-ди товара
"number": "1" //количество единиц данного товара
}
];
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Быстрый просмотр товара pageType=7

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 7});
var ad_product = {
"id": "1234" //ай-ди товара
};
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Положить в корзину 1 товар pageType=8

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 8});
var ad_products = [
{
"id": "123",  //ай-ди товара
"number": "1" //количество единиц данного товара
}
];
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Положить в корзину 2 и более товара pageType=8

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 8}); var
ad_products = [
{
"id": "123",  //ай-ди товара
"number": "1" //количество единиц данного товара
},
{
"id": "234",  //ай-ди товара
"number": "5" //количество единиц данного товара
}
];
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Удалить из корзины 1 товар pageType=9

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 9});
var ad_products = [
{
"id": "123",  //ай-ди товара
"number": "1" //количество единиц данного товара
}
];
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Удалить из корзины 1 товар pageType=9

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 9});
var ad_products = [
{
"id": "123",  //ай-ди товара
"number": "1" //количество единиц данного товара
},
{
"id": "234",  //ай-ди товара
"number": "5" //количество единиц данного товара
}
];
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Удалить из корзины 2 и более товара pageType=9

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 9});
var ad_products = [
{
"id": "123",  //ай-ди товара
"number": "1" //количество единиц данного товара
},
{
"id": "234",  //ай-ди товара
"number": "5" //количество единиц данного товара
}
];
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Отложить товар pageType=20

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 20});
var ad_product = "1234"; //ай-ди товара
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Отправить лид pageType=30

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 30});
var ad_order = "1234"; //ай-ди заказа
var ad_amount = "9999"; //сумма заказа
var ad_payment = "999"; //сумма начисленная партнеру или источнику
var ad_company = "mediasniper"; //Название партнера или источника которому будет присвоен лид

(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

Прочие страницы pageType=0

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 0});
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

2. Установка кодов ретаргетинга через Google Tag Manager

Описание Google Tag Manager

Google Tag Manager (GTM) — это сервис, который позволяет маркетологам и аналитикам гибко управлять тегами отслеживания на сайте без привлечения разработчиков.

Для подключения и настройки внешних сервисов необходимо разместить на сайте специальные теги или фрагменты JavaScript-кода. Для настройки тегов отслеживания требуется время программистов, что может приводить к:

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

GTM позволяет разместить универсальный код (dataLayer), а после этого добавлять, удалять и редактировать различные теги в интерфейсе GTM без помощи программистов.

В свою очередь, это позволяет маркетологам и веб-мастерам оперативно, а главное, самостоятельно вносить изменения по текущим кампаниям.

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

Чтобы начать пользоваться Диспетчером тегов Google:

  • перейдите на страницу google.com/tagmanager?hl=ru и создайте новый аккаунт (или войдите в уже существующий);
  • создайте контейнер для своего сайта;
  • разместите фрагмент контейнера на сайте, одновременно удалив с него все другие теги.

Теперь можно добавлять теги (например, тег отслеживания конверсий AdWords или Google Analytics) на свой сайт через интерфейс Диспетчера тегов Google.

Создание аккаунта

Аккаунт – это самый верхний уровень иерархии в Диспетчере тегов Google. Как правило, для одной компании достаточно одного аккаунта, с помощью которого можно управлять тегами всех ее сайтов.

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

При входе в Диспетчер тегов отображается список аккаунтов этой службы, к которым у вашего аккаунта Google есть доступ.

  1. Нажмите Новый аккаунт на странице "Все аккаунты" в Диспетчере тегов Google.
  2. Введите название аккаунта и нажмите Далее.
  3. Выполните инструкции из раздела "Создание контейнера".

Создание контейнера

При создании аккаунта в Диспетчере тегов Google необходимо создать контейнер. В нем будут содержатся все теги отдельного веб-сайта, поэтому рекомендуется дать контейнеру соответствующее название. Например, контейнер для сайта example.com можно назвать "example".

Если вы приступаете к управлению тегами на новом сайте, создайте для него отдельный контейнер. Чтобы создать новый контейнер:

  1. Выберите аккаунт в Диспетчере тегов Google. Откроется страница "Контейнеры".
  2. Нажмите кнопку Новый контейнер.
  3. Введите название, выберите вариант "Веб-страницы" в разделе "Где будет использоваться контейнер" и нажмите кнопку Сохранить. Если контейнер создается вместе с аккаунтом, выберите Создать аккаунт и контейнер.

Размещение фрагмента контейнера

Создав контейнер, вы получите фрагмент кода. Скопируйте этот код и разместите его на каждой странице своего сайта сразу же после открывающего тега . Не забудьте при этом удалить все остальные теги (например, теги Google Analytics или отслеживания конверсий AdWords).

Чтобы получить фрагмент контейнера, выполните следующие действия:

  1. Выберите аккаунт в Диспетчере тегов Google. Откроется страница "Контейнеры".
  2. Выберите нужный контейнер из списка.
  3. На панели навигации слева выберите Пользователи и настройки > Настройки.
  4. Чтобы проверить, правильно ли вы вставили код, воспользуйтесь специальным расширением для Chrome – Tag Assistant.

Добавление, обновление и публикация тегов

Первый созданный вами контейнер будет пустым, поэтому в него необходимо добавить теги.
В первую очередь, поместите в него теги, которые вы удалили со своего сайта на предыдущем этапе. Например, если вы удалили с сайта тег отслеживания конверсий AdWords, добавьте его в Диспетчер тегов Google. После того, как вы создадите контейнер и разместите на сайте контейнерный тег, можно будет добавлять и обновлять все теги на странице "Теги".

  1. Выберите аккаунт в Диспетчере тегов Google. Откроется страница "Контейнеры".
  2. Нажмите нужное название контейнера в списке. Откроется страница "Теги".

Чтобы добавить тег:
Нажмите Создать > Тег. Выберите тип тега, например Google Analytics, и укажите правила его активации.

Чтобы изменить тег, например, обновить правила его активации:
Выберите нужный тег из списка. Внесите изменения на странице "Изменение тега".

Чтобы удалить тег:
Выберите нужный тег из списка. Нажмите Удалить этот тег на странице "Изменение тега".

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

На любой странице раздела Черновик контейнера нажмите Создать версию на панели навигации, затем – *Просмотреть > Просмотр и отладка.

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

Мы рекомендуем публиковать только ту версию контейнера, которую вы предварительно просмотрели. Однако вы можете создавать и публиковать версии контейнера и без просмотра. Нажмите Создать версию на странице "Теги", а затем – Опубликовать.

Пример установки кода в GTM

Для примера установим код:

<script type="text/javascript">
window.ad_retag = window.ad_retag || [];
window.ad_retag.push({level: 5});
(function () {
var s=document.createElement("script");
s.async=true;
s.src=(document.location.protocol=="https:"?"https:":"http:")+"//static.bumlam.com/engine/rcmd4.js";
var a=document.getElementsByTagName("script")[0]
a.parentNode.insertBefore(s, a);
})();
</script>

В поле Имя тега вводим название нового тега. Тип тега - для наших кодов выбираем пункт Пользовательский тег HTML. После этого появится поле HTML, куда мы и вносим наш код (См. рис.1).

1400

Рисунок 1. Создание тега.

Далее необходимо выбрать существующий триггер или добавить новый, который будет активировать добавленный выше тег.
Для этого необходимо кликнуть на любое место в секции Триггеры.
Затем нажать на символ "+" для добавления нового триггера(см.рисунок 2.)
После этого в появившемся окне ввести имя триггера и сконфигурировать его.
Для этого необходимо кликнуть в любое место секции Настройка триггера
Затем выбрать Тип триггера, например Окно загружено.
Следующим шагом нужно выбрать условия активации триггера. Например Некоторые события "Окно загружено". В конце выбираем при каком событии нужно активировать триггер
Для сохранения нажимаем на кнопку Сохранить и триггер добавится для этого тега

1413

Рисунок 2.

1389

3. Товарный фид. Описание формата

Товарный каталог или фид — это список товаров, которые будут рекламироваться .
Каждый товар в списке имеет свои атрибуты, которые используются для генерации объявлений: id товара, название, описание, цена и т.д.
Мы используем формат товарного каталога — YML (Yandex Market Language), который разработан Яндексом и основан на стандарте XML.

Требования к YML-файлу

  • В YML нельзя использовать непечатаемые символы с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки).
  • Символы " & > < ' нужно заменять на эквивалентные коды:
293

📘

Примечание

Вы можете использовать символы " & > < ' в блоке CDATA в описании предложения.

  • Допустимые кодировки YML-файла: UTF-8, windows-1251.

Пример YML-файла

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2017-02-05 17:22">
    <shop>
    <name>BestSeller</name>
    <company>Tne Best inc.</company>
    <url>http://best.seller.ru</url>
    <currencies>
      <currency id="RUR" rate="1"/>
      <currency id="USD" rate="60"/>
    </currencies>
    <categories>
      <category id="1">Бытовая техника</category>
      <category id="10" parentId="1">Мелкая техника для кухни</category>
      <category id="101" parentId="10">Сэндвичницы и приборы для выпечки</category>
      <category id="102" parentId="10">Мороженицы</category>
    </categories>
    <offers>
      <offer id="12346" available="true" bid="80" cbid="90" fee="325">
        <url>http://best.seller.ru/product_page.asp?pid=12348</url>
        <price>1490</price>
        <oldprice>1620</oldprice>
        <currencyId>RUR</currencyId>
        <categoryId>101</categoryId>
        <picture>http://best.seller.ru/img/large_12348.jpg</picture>
        <store>false</store>
        <pickup>true</pickup>
        <delivery>true</delivery>
        <delivery-options>
          <option cost="300" days="0" order-before="12"/>
        </delivery-options>
        <name>Вафельница First FA-5300</name>
        <vendor>First</vendor>
        <vendorCode>A1234567B</vendorCode>
        <description>
        <![CDATA[
          <p>Отличный подарок для любителей венских вафель.</p>
        ]]>
        </description>
        <sales_notes>Необходима предоплата.</sales_notes>
        <manufacturer_warranty>true</manufacturer_warranty>
        <country_of_origin>Россия</country_of_origin>
        <barcode>0156789012</barcode>
        <cpa>1</cpa>
        <rec>123,456</rec>
      </offer>
      <offer id="9012" type="vendor.model" available="true" bid="80" cbid="90" fee="325">
        <url>http://best.seller.ru/product_page.asp?pid=12345</url>
        <price>8990</price>
        <oldprice>9900</oldprice>
        <currencyId>RUR</currencyId>
        <categoryId>102</categoryId>
        <picture>http://best.seller.ru/img/model_12345.jpg</picture>
        <store>false</store>
        <pickup>false</pickup>
        <delivery>true</delivery>
        <delivery-options>
          <option cost="300" days="1" order-before="18"/>
        </delivery-options>
        <outlets> 
          <outlet id="1" instock="50"/>
          <outlet id="2" instock="20"/>
        </outlets>
        <typePrefix>Мороженица</typePrefix>
        <vendor>Brand</vendor>
        <model>3811</model>
        <description>
        <![CDATA[
          <h3>Мороженица Brand 3811</h3>
          <p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей, ведь с его помощью вы сможете делать вкусное домашнее мороженое из натуральных ингредиентов.</p>
        ]]>
        </description>
        <param name="Цвет">белый</param>
        <sales_notes>Необходима предоплата.</sales_notes>
        <manufacturer_warranty>true</manufacturer_warranty>
        <country_of_origin>Китай</country_of_origin>
        <barcode>0123456789379</barcode>
        <cpa>1</cpa>
        <rec>345,678</rec>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Описание элементов

ЭлементОписание
xml headerСтандартный XML-заголовок. Должен начинаться с первой строки, с нулевого символа.
yml_catalogЛюбой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент <yml_catalog>. Атрибут date элемента <yml_catalog> должен соответствовать дате и времени генерации YML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD hh:mm.
shopЭлемент содержит описание магазина и его товарных предложений.
Обязательный элемент.
nameКороткое название магазина, не более 20 символов. В названии нельзя использовать слова, не имеющие отношения к наименованию магазина, например «лучший», «дешевый», указывать номер телефона и т. п
Обязательный элемент.
companyПолное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации.
Обязательный элемент.
urlURL главной страницы магазина. Максимум 50 символов. Допускаются кириллические ссылки.
platformСистема управления контентом, на основе которой работает магазин (CMS).
Необязательный элемент.
versionВерсия CMS.
Необязательный элемент.
agencyНаименование агентства, которое оказывает техническую поддержку магазину и отвечает за работоспособность сайта.
Необязательный элемент.
emailКонтактный адрес разработчиков CMS или агентства, осуществляющего техподдержку.
Необязательный элемент.
currenciesСписок курсов валют магазина.
Обязательный элемент
categoriesСписок категорий магазина.
Обязательный элемент.
delivery-optionsСтоимость и сроки курьерской доставки по своему региону.
Обязательный элемент, если все данные по доставке передаются в прайс-листе.
cpaЭлемент управляет участием товарных предложений в программе «Заказ на Маркете» .
Необязательный элемент.
offersСписок предложений магазина. Каждое предложение описывается в отдельном элементе offer.
Обязательный элемент