Criteo OneTag.

Руководство по интеграции решения Criteo OneTag в исходный код для сайтов недвижимости.

Обзор

С помощью данного руководства, Вы сможете разобраться, как внедрить решение Criteo OneTag напрямую в ваш исходный код.

Criteo OneTag должен быть помещен в заголовок или тело каждой страницы на вашем сайте. Пожалуйста, установите следующие 4 тега на свой ресурс.

Учитывая, что речь идет о сайте недвижимости, важно понять, какой продукт вы хотите продвигать на баннерах: здания или квартиры. В зависимости от этого, план установки тегов будет немного отличаться. Основная идея заключается в том, что основной продукт (здание или квартира) должен иметь тег продукта, размещенный на веб-странице. Поэтому, если, например, квартира является основным продуктом, нужно будет установить тег продукта на страницах описания квартир, а тег категории на страницах описания зданий.

  1. Тег главной страницы

  2. Тег категории / списка товаров (весь список зданий или квартир) [необязательный]

  3. Тег на странице продукта (отдельное здание, отдельная квартира)

  4. Тег конверсии

  5. Форма обратного звонка (в случае наличия формы обратного звонка)

[[disclaimer-developer]]

Теги

Тег домашней страницы

Установите следующий тег на домашней странице вашего сайта: {{homepageurl}}

Поле Описание Пример Синтаксис
email Открытый текст или MD5 хэш 79054025255fb1a26e4bc422aef54eb4 Строка в нижнем регистре. Длина - 32 символа, без обрамляющих пробелов. Кодировка - UTF-8.

Структура

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

<!-- Тег домашней страницы Criteo OneTag -->
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript">
window.criteo_q = window.criteo_q || [];
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q.push(
 { event: "setAccount", account: {{accountid}}}, // Это значение остается неизменным
 { event: "setEmail", email: "##Электронный адрес пользователя##" }, // Может быть пустой строкой
 { event: "setSiteType", type: deviceType},
 { event: "viewHome"});
</script> 
<!-- Конец тега домашней страницы Criteo OneTag -->

Пример

<!-- Тег домашней страницы Criteo OneTag -->
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript">
window.criteo_q = window.criteo_q || [];
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q.push(
 { event: "setAccount", account: {{accountid}}}, // Это значение остается неизменным
 { event: "setEmail", email: "79054025255fb1a26e4bc422aef54eb4" }, // Может быть пустой строкой 
 { event: "setSiteType", type: deviceType},
 { event: "viewHome"});
</script> 
<!-- Конец тега домашней страницы Criteo OneTag -->

Тег категории/списка

Установите следующий тег на страницы списка, категории и страницы выдачи поисковых результатов на вашем сайте. URL такой страницы может выглядеть следующим образом: {{homepageurl}}/category?id=categoryid1

Поле Описание Пример Синтаксис
email Открытый текст или MD5 хэш 79054025255fb1a26e4bc422aef54eb4 Строка в нижнем регистре. Длина - 32 символа, без обрамляющих пробелов. Кодировка - UTF-8.
item Массив уникальных идентификаторов зданий/квартир ['BuildingID_1','BuildingID_1','BuildingID_1'] Массив строковых значений

Структура

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

<!-- Тег категории Criteo OneTag -->
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript">
window.criteo_q = window.criteo_q || [];
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q.push(
 { event: "setAccount", account: {{accountid}}}, // Это значение остается неизменным
 { event: "setEmail", email: "##Электронный адрес пользователя##" }, // Может быть пустой строкой
 { event: "setSiteType", type: deviceType},
 { event: "viewList", item: ["##Id здания/квартиры №1##", "##Id здания/квартиры №2##", "##Id здания/квартиры №3##"]});
</script> 
<!-- Конец тега категории Criteo OneTag -->

Пример

<!-- Тег категории Criteo OneTag -->
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript">
window.criteo_q = window.criteo_q || [];
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q.push(
 { event: "setAccount", account: {{accountid}}}, // Это значение остается неизменным
 { event: "setEmail", email: "79054025255fb1a26e4bc422aef54eb4" }, // Может быть пустой строкой
 { event: "setSiteType", type: deviceType},
 { event: "viewList", item: ["BuildingID_1", "BuildingID_2", "BuildingID_3"] });
</script> 
<!-- Конец тега категории Criteo OneTag -->

Тег на странице продукта

Установите следующий тег на карточке товара вашего сайта. URL такой страницы может выглядеть следующим образом: {{homepageurl}}/product?id=productid_1

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

Поле Описание Пример Синтаксис
email Открытый текст или MD5 хэш 79054025255fb1a26e4bc422aef54eb4 Строка в нижнем регистре. Длина - 32 символа, без обрамляющих пробелов. Кодировка - UTF-8.
item Уникальный идентификатор зданий/квартир BuildingID_1 Строка

Структура

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

<!-- Тег карточки товара Criteo OneTag -->
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript">
window.criteo_q = window.criteo_q || [];
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q.push(
 { event: "setAccount", account: {{accountid}}}, // Это значение остается неизменным
 { event: "setEmail", email: "##Электронный адрес пользователя##" }, // Может быть пустой строкой 
 { event: "setSiteType", type: deviceType},
 { event: "viewItem", item: "##Id здания/квартиры №1##" });
</script> 
<!-- Конец тега карточки товара Criteo OneTag -->

Пример

<!-- Тег карточки товара Criteo OneTag -->
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript">
window.criteo_q = window.criteo_q || [];
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q.push(
 { event: "setAccount", account: {{accountid}}}, // Это значение остается неизменным
 { event: "setEmail", email: "79054025255fb1a26e4bc422aef54eb4" }, // Может быть пустой строкой
 { event: "setSiteType", type: deviceType},
 { event: "viewItem", item: "BuildingID_1" });
</script> 
<!-- Конец тега карточки товара Criteo OneTag -->

Тег продаж

Установите следующий тег на страницу подтверждения покупки или страницу благодарнности вашего сайта. URL такой страницы может выглядеть следующим образом: {{homepageurl}}/thankyou

Поле Описание Пример Синтаксис
email Открытый текст или MD5 хэш 79054025255fb1a26e4bc422aef54eb4 Строка в нижнем регистре. Длина - 32 символа, без обрамляющих пробелов. Кодировка - UTF-8.
id Номер заказа или подтверждения 7654322 Строка
item.price Цена за единицу продукта По дефолту можно передавать 1 Строка или число, без символа валюты
item.quantity Количество единиц продукта 2 Целочисленное значение
item.id Уникальный идентификатор зданий/квартир BuildingID_1 Идентификатор может содержать как цифры, так и символы алфавита

Структура

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

<!-- Тег продажи Criteo OneTag -->
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript">
window.criteo_q = window.criteo_q || [];
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q.push(
 { event: "setAccount", account: {{accountid}}}, // Это значение остается неизменным
 { event: "setEmail", email: "##Email Address of user##" }, // Может быть пустой строкой
 { event: "setSiteType", type: deviceType},
 { event: "trackTransaction", id: ##ID транзакции##, item: [
    {id: "##Id здания/квартиры №1##", price: ##Цена за единицу товара##, 
    quantity: ##Количество товарных единиц## }
    //добавьте новую запись для каждого продукта в корзине
]}
);
</script> 
<!-- Конец тега продажи Criteo OneTag -->

Пример

<!-- Тег продажи Criteo OneTag -->
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript">
window.criteo_q = window.criteo_q || [];
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q.push(
 { event: "setAccount", account: {{accountid}}}, // Это значение остается неизменным
 { event: "setEmail", email: "79054025255fb1a26e4bc422aef54eb4" }, // Может быть пустой строкой
 { event: "setSiteType", type: deviceType},
 { event: "trackTransaction", id: 7654322, item: [
    {id: "BuildingID_1", price: 1, quantity: 1 }
    //добавьте новую запись для каждого продукта в корзине
]}
);
</script> 
<!-- Конец тега продажи Criteo OneTag -->

Форма обратного звонка

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

Поле Описание Пример Синтаксис
email Открытый текст или MD5 хэш 79054025255fb1a26e4bc422aef54eb4 Строка в нижнем регистре. Длина - 32 символа, без обрамляющих пробелов. Кодировка - UTF-8.
id Номер заказа или подтверждения. Если невозможно передать реальный номер заказа. Id может быть сгенерирован, однако обязательно должен быть уникальным числом и желательно содержать в себе информацию о дате и времени заказа (например - 'fast_order_2018-4-8-10-8-7') 7654322 Строка
item.price Цена за привлечение клиента. В случаем если такой информации нет, разрешается передавать = 1 1 Строка или число, без символа валюты
item.quantity Количество единиц продукта. Всегда = 1 1 Целочисленное значение
item.id Уникальный идентификатор здания/квартиры. Если невозможно передать динамически значение, разрешается передавать = 1 ##BuildingID_1## Идентификатор может содержать как цифры, так и символы алфавита

Структура

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

<!-- Criteo Conversion Tag -->
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript">
function criteoCallBackEvent () {
window.criteo_q = window.criteo_q || [];
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q.push(
 { event: "setAccount", account: {{accountid}}}, // You should never update this line
 { event: "setEmail", email: "##Электронный адрес пользователя##" }, // Can be an empty string 
 { event: "setSiteType", type: deviceType},
 { event: "trackTransaction", id: ##ID транзакции##, item: [
    {id: "##ID продукта №1##", price: ##CPA##, quantity: 1 }    
]}
);
};
</script> 
<!-- END Criteo Conversion Tag -->

Example

<!-- Criteo Conversion Tag -->
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript">
function criteoCallBackEvent () {
window.criteo_q = window.criteo_q || [];
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q.push(
 { event: "setAccount", account: {{accountid}}}, // You should never update this line
 { event: "setEmail", email: "79054025255fb1a26e4bc422aef54eb4" }, // Can be an empty string 
 { event: "setSiteType", type: deviceType},
 { event: "trackTransaction", id: 7654322, item: [
    {id: "ProductID_1", price: 200.99, quantity: 1 }    
]}
);
};
</script> 
<!-- END Criteo Conversion Tag -->

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

[[accurate_ru]]