Criteo OneTag.¶
Руководство по интеграции решения Criteo OneTag в исходный код для сайтов недвижимости.
Обзор¶
С помощью данного руководства, Вы сможете разобраться, как внедрить решение Criteo OneTag напрямую в ваш исходный код.
Criteo OneTag должен быть помещен в заголовок или тело каждой страницы на вашем сайте. Пожалуйста, установите следующие 4 тега на свой ресурс.
Учитывая, что речь идет о сайте недвижимости, важно понять, какой продукт вы хотите продвигать на баннерах: здания или квартиры. В зависимости от этого, план установки тегов будет немного отличаться. Основная идея заключается в том, что основной продукт (здание или квартира) должен иметь тег продукта, размещенный на веб-странице. Поэтому, если, например, квартира является основным продуктом, нужно будет установить тег продукта на страницах описания квартир, а тег категории на страницах описания зданий.
-
Тег категории / списка товаров (весь список зданий или квартир) [необязательный]
-
Тег на странице продукта (отдельное здание, отдельная квартира)
-
Форма обратного звонка (в случае наличия формы обратного звонка)
[[disclaimer-developer]]
Теги¶
Тег домашней страницы¶
Установите следующий тег на домашней странице вашего сайта: {{homepageurl}}
Поле | Описание | Пример | Синтаксис |
---|---|---|---|
Открытый текст или 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
Поле | Описание | Пример | Синтаксис |
---|---|---|---|
Открытый текст или 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
Данный тег будет установлен на странице, где пользователь может ознакомиться с более подробной информацией о квартире или здании, а также, где пользователь может запросить обратный звонок.
Поле | Описание | Пример | Синтаксис |
---|---|---|---|
Открытый текст или 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
Поле | Описание | Пример | Синтаксис |
---|---|---|---|
Открытый текст или 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()).
Поле | Описание | Пример | Синтаксис |
---|---|---|---|
Открытый текст или 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]]