Мы создали руководство по интеграции, предназначенное для команд разработчиков и специалистов по монетизации в компаниях-ритейлерах. Это руководство призвано помочь вам в установке Criteo OneTag для Sponsored Products на вашем сайте. Весь процесс интеграции обычно занимает от 4 до 8 недель. Как только OneTag для Criteo Sponsored Products установлен на вашем сайте, вы сможете использовать все новые функции, как только они станут доступны.
Помните, что ваш технический специалист Criteo всегда готов помочь вам с любыми вопросами по интеграции OneTag.
Установите Criteo OneTag для Sponsored Products прямо сейчас.
Шаг 1: Загрузите свой товарный каталог
Чтобы запустить кампании Criteo Sponsored Products, технический специалист Criteo поможет вам в настройке товарного фида. Criteo поддерживает следующие форматы товарного фида: .tsv, .csv и .xml.
Подробные требования к товарному фиду вы найдете здесь.
Шаг 2: Регистрация страницы и рекламного пространства
Следующим шагом будет регистрация страниц вашего сайта и рекламного пространства в Criteo Retailer Network. Ваш технический специалист Criteo выполнит все настройки за вас и предоставит вам данные для регистрации, которые будут необходимы при установке Criteo OneTag. Параметр Event Name в коде OneTag JavaScript отвечает за тип страницы, в которую интегрируется OneTag. Все типы страниц перечислены в шаге 3.2, только эти типы могут использоваться в параметре Event Name. Если тип страницы, в которую вы хотите интегрировать Criteo Sponsored Products, отличается от стандартных, перечисленных в шаге 3.2, обратитесь к своему техническому специалисту Criteo.
Как только рекламное пространство готово к работе, технический специалист Criteo присвоит идентификатор этого рекламного пространства Ad Placement.
Ознакомьтесь с Приложением B , чтобы узнать больше о настройке рекламного пространства Criteo
Шаг 3: Интеграция тегов на вашем сайте
Criteo OneTag для Sponsored Products – это тег JavaScript, который позволяет Criteo отслеживать взаимодействие пользователей с вашим сайтом и подбирать релевантные товары Criteo Sponsored Products для рекламы на страницах вашего сайта.
Наш OneTag состоит из двух элементов:
- Criteo Loader – это JavaScript код для вашего аккаунта в системе Criteo, который должен быть прописан в заголовке каждой страницы сайта, в которую интегрируется Criteo OneTag. Это минимизирует какие-либо задержки в загрузке Criteo Sponsored Products. Criteo Loader отвечает за загрузку рекламы и отправку запросов на серверы Criteo Sponsored Products.
- События Tracker позволяют нам собирать данные об активности пользователей на вашем сайте, чтобы на их основе показывать им релевантную рекламу. Глубокое понимание активности ваших пользователей и контекста сайта обеспечивает Criteo максимальную точность таргетинга при создании рекламы. Таргетинг различается для каждого типа страницы. Ключевые страницы, активность на которых необходимо отслеживать, вне зависимости от того, отображается ли на них реклама:
- Страницы:
- Главная страница
- Страница каталога категорий
- Страница результатов поиска
- Страница товара
- Страница корзины
- Страница подтверждения заказа
В примере ниже вы найдете тег со всеми универсальными параметрами для корректного трекинга. Универсальный параметр – это одинаковый для каждого типа страницы параметр, необходимый вне зависимости от того, отображается ли на ней реклама.
Пример
Универсальные параметры
Указанные ниже параметры необходимы для корректного трекинга, вне зависимости от того, отображается ли на ней реклама, и от типа страницы
Event |
Параметр |
Sample Value |
Описание |
Тип |
Требуется |
setAccount |
account |
123456 |
Идентификатор Criteo Partner Account Этот идентификатор вам предоставит технический специалист Criteo. |
String |
Да |
setRetailerVisitorId |
id |
53e20ea700424f7bbdd7 93b02abcb5d7 |
Уникальный неаутентифицированный идентификатор пользователя, используемый на всех сессиях на одном устройстве |
String |
Да |
setEmail |
|
3e0a83febcf74ba6a08e 684534100773 |
Если вы можете передавать email пользователя, он должен быть хэширован по протоколу MD5 или SHA256 MD5. Мы также принимаем адреса в текстовом виде, Criteo хэширует их для вас на своей стороне. |
String |
Да, если это возможно. |
etCustomerId |
id |
53e20ea700424f7bbdd7 93b02abcb5d7 |
Идентификатор аутентифицированного пользователя, используемый на всех зарегистрированных сессиях. |
String |
Да, если email пользователя не передается. |
Трекинг на домашней странице сайта.
Добавляя трекеры на домашнюю страницу, указывайте только универсальные параметры.
Event |
Параметр |
Описание |
Тип |
Требуется |
viewHome |
Н/П |
Это событие, указывающее на тип страницы «Домашняя страница» |
String |
Да |
Пример
Трекинг на странице каталога категорий
Для всех страниц, отображающих каталог товаров или же страниц коллекций товаров, укажите в тегах все обязательные параметры и следующие дополнительные:
Event |
Параметр |
Описание |
Тип |
Требуется |
viewCategory |
item, category, page_number, filters |
Это событие, которое указывает тип страницы. |
String |
Да |
Ниже вы найдете подробное описание параметров для события "viewCategory":
Параметр |
Sample Value |
Описание |
Тип |
Требуется |
item |
["1-9835530","1- 9835432”,”1-9866287”] |
Список товаров, которые показываются на странице. Это идентификаторы каждого товара одной группы, которые необходимо передавать с разделителями, причем не более 100 товаров сразу. Идентификаторы каждого товара в тегах должны полностью совпадать с идентификаторами тех же товаров в фиде. |
String |
Да |
категория; |
Электроника > Аудиотовары > Наушники |
Категория просматриваемой пользователем страницы. Это значение должно совпадать со значением, передаваемым в товарном фиде в поле field product_type или product_type_key в Criteo |
String |
Да |
page_number |
1 |
Если страницы вашего сайта пронумерованы, этот параметр отображает номер страницы. Если ваш сайт представляет собой одну страницу прокрутки, это значение должно быть равно 1. |
String |
Да, но только если страницы вашего сайта пронумерованы. Если ваш сайт представляет собой одну страницу прокрутки, вам не требуетсяпередавать это значение |
filters [фильтры] |
{name: “brand”, operator: “eq”, value:”Nikon, Sony”} |
Это все фильтры, примененные на странице, на которой вы хотели бы размещать рекламу. Если выбрано несколько опций одного фильтра, разделите их запятыми. Каждую опцию фильтра нужно выделять в отдельную строку. Ознакомьтесь с разделом о фильтрах ниже, чтобы узнать больше. |
String |
Нет |
Пример
Трекинг на страницах результатов поиска
На всех страницах, где отображаются результаты поиска и каталог товаров, вне зависимости от того, являются ли они результатами органического поиска, укажите все универсальные параметры, плюс параметры, приведенные ниже:
Event |
Sample Value |
Описание |
Тип |
Требуется |
viewSearchResult |
item, keyword, category, page_number, filters |
Это событие, которое указывает тип страницы. |
String |
Да |
Ниже указаны параметры события "viewSearchResult":
Параметр |
Sample Value |
Описание |
Тип |
Требуется |
item |
["1-9835530","1-9835432”,”1-9866287”] |
Список товаров, которые показываются на странице. Это идентификаторы каждого товара одной группы, которые необходимо передавать с разделителями, причем не более 100 товаров сразу. |
String |
Да |
ключевые слова |
наушники |
Ключевое слово, по которому пользователь выполняет поисковый запрос. |
String |
Да |
категория; |
Электроника > Аудиотовары > Наушники |
Категория просматриваемой пользователем страницы. Это значение должно совпадать со значением, передаваемым в товарном фиде в поле field product_type или product_type_key в Criteo |
String |
Необязательно |
page_number |
1 |
Если страницы вашего сайта пронумерованы, этот параметр отображает номер страницы. Если ваш сайт представляет собой одну страницу прокрутки, это значение должно быть равно 1. |
String |
Да, но только если страницы вашего сайта пронумерованы. Если ваш сайт представляет собой одну страницу прокрутки, вам не требуетсяпередавать это значение |
filters [фильтры] |
{name: “brand”, operator: “eq”, value:”Nikon, Sony”} |
Это все доступные фильтры на странице, где вы хотели бы размещать рекламу, в виде списка, разделенные запятыми в случае, когда есть несколько опций одного фильтра (например, бренд). Каждый выбранный фильтр должен быть вынесен в отдельную строку. Ознакомьтесь с разделом о фильтрах ниже, чтобы узнать больше. |
String |
Нет |
Пример
Фильтры
Если пользователь применил фильтр результатов поиска (один или несколько), вы можете указать это в фиде функции. 3 фильтра используются Criteo, они будут соотноситься с соответствующими полями в фиде: это “бренд”, “цена” и “рейтинг”. Вы можете назначить любые фильтры.
Полное описание фильтра состоит из 3 элементов
(filter-name,operator,value)
- Имя фильтра: Название фильтра
- Оператор
- Значение: This is the value of the It can be a list of values depending on your use case. К примеру, если вы используете оператор ‘in’, вы можете указать список значений, разделенных запятыми.
Чтобы указать фильтры в тегах, используйте функцию ‘filters’ в функции ‘event’.
Criteo поддерживает следующие операторы:
Оператор |
Описание |
eq |
Равно |
gt |
Больше, чем |
lt |
Меньше, чем |
ge |
Больше или равно |
le |
Меньше или равно |
in |
Принадлежность списку |
Примеры:
filters:[("price","le","500")]
Так будет установлен фильтр цены товаров ‘меньше или равно’ $500.
filters:[("color","eq","blue")]
Так будут отфильтрованы товары синего цвета.
filters:[("brand","eq","sony,hp,dell")]
Таким образом будет установлен фильтр, который выдаст товары брендов ‘sony’, ‘hp’ и ‘dell’.
Операторы ‘in’ и ‘eq’ в данном случае будут иметь одинаковый эффект.
Трекинг на страницах товаров
Страница товара содержит данные о конкретном товаре. Установка Criteo OneTag на страницу товара – это ключевой момент всего процесса сбора данных. Указанный ниже тег обеспечивает актуальность данных о доступности товара и его цене в реальном времени, в любой момент между плановыми обновлениями фида. Например, если товар распродан в середине дня после ежедневного обновления фида Criteo,
тег отметит товар как распроданный в системе Criteo и исключит его из показа в рекламных баннерах на вашем сайте. Укажите в теге все универсальные параметры, плюс несколько дополнительных:
Event |
Параметр |
Описание |
Тип |
Требуется |
viewItem |
item, price, availability |
Это событие, которое указывает тип страницы. |
String |
Да |
Ниже указаны параметры события "viewItem":
Параметр |
Sample Value |
Описание |
Тип |
Требуется |
item |
1-9835530 |
Пользователь просматривает один товар из группы. Идентификатор товара превалирует над идентификатором группы товаров, но можно использовать последний, хотя и с определенными ограничениями функционала. |
String |
Да |
price |
475 |
Актуальная цена отображаемого товара. |
Десятичный знак |
Да |
availability |
1 |
1 – товар в наличии, 0 – товар распродан. |
Boolean |
Да |
Пример
Трекиг на странице корзины
Добавляя трекеры на страницу корзины, укажите в теге все универсальные параметры, плюс несколько дополнительных:
Event |
Параметр |
Описание |
Тип |
Требуется |
viewBasket |
item |
Это событие, которое указывает тип страницы. |
String |
Да |
Полный тег на странице корзины будет выглядеть следующим образом:
Параметр |
Sample Value |
Описание |
Тип |
Требуется |
item |
{id: “productid123”, price: “100.00”, quantity: “4”} |
Список идентификаторов товаров из одной группы отображается в корзине. Добавьте новый элемент JSON для каждого товара в корзине. Параметр price отвечает за актуальную цену товара |
String |
Да |
Пример
Трекинг на страницах подтверждения транзакции
Страница подтверждения заказа – страницу, на которую пользователь перенаправляется после завершения заказа на вашем сайте. Обычно на странице отображается номер заказа и его подытог.
Обязательно установите Criteo OneTag на страницу подтверждения заказа, чтобы отслеживать купленные пользователями товары. Трекинг купленных товаров позволяет Criteo предоставлять вам отчет о конверсиях. Укажите в теге все универсальные параметры, плюс несколько дополнительных:
Event |
Параметр |
Описание |
Тип |
Требуется |
trackTransaction |
id , item |
Это событие, которое указывает тип страницы. |
String |
Да |
Ниже указаны параметры события “trackTransaction":
Параметр |
Sample Value |
Описание |
Тип |
Требуется |
id |
97234735 |
Идентификатор транзакции или заказа из вашей eCommerce системы |
String |
Да |
item |
{id: “productid123”, price: “100.00”, quantity: “4”} |
Список идентификаторов товаров из одной группы отображается в корзине. Для каждого товара в корзине добавьте новую строку. |
String |
Да |
Пример
Трекинг события AddToCart
Событие добавления товара в корзину содержит данные об определенном товаре, который пользователь положил в корзину. Установка Criteo OneTag на события AddToCart для CPG ритейлеров также является ключевым аспектом трекинга. Укажите в теге все универсальные параметры, плюс несколько дополнительных:
Event |
Параметр |
Описание |
Тип |
Требуется |
addToCart |
item, price, quantity |
Это событие определяет тип страницы. |
String |
Да |
Ниже указаны параметры события "addToCart":
Параметр |
Sample Value |
Описание |
Тип |
Требуется |
item |
1-9835530 |
Пользователь просматривает один товар из группы. Идентификатор товара превалирует над идентификатором группы товаров, но можно использовать последний, хотя и с определенными ограничениями функционала. |
String |
Да |
price |
12 |
Актуальная цена отображаемого товара |
Десятичный знак |
Да |
количество |
3 |
Номер товара, который пользователь добавил в корзину |
String |
Да |
почтовый индекс |
10012 |
Почтовый индекс магазина, в котором пользователь совершает покупку |
String |
Да |
store_id |
123456 |
Идентификатор магазина, в котором пользователь делает заказ |
String |
Да |
Добавление рекламного пространства
Вы можете легко создать рекламное пространство на любой странице вашего сайта, где установлены трекеры Criteo, добавив divmarker для разграничения пространства, где будет размещен рекламный блок.
Имя этого <div> должно полностью совпадать с тем, что вам предоставил ваш технический специалист Criteo.
Приложение А: Часто задаваемые вопросы
Вопрос Что, если мой сайт автоматически адаптируется под устройство пользователя? Нужно ли отдельно устанавливать теги для мобильной версии сайта?
Для всех адаптивных сайтов команда технических специалистов Criteo присваивает вашим страницам и рекламным блокам тип «смешанные». Тип «мобильный» присваивается только в случае, если у вас есть отдельная мобильная версия сайта, которая не является адаптивной. Сообщите вашему техническому специалисту Criteo об этом, чтобы обеспечить корректную интеграцию.
Вопрос На моем сайте доступно несколько валют, как мне установить выбранную валюту для каждого заказа?
Валюта указывается в тегах на страницах корзины и подтверждения заказа только в том случае, когда пользователь выбрал валюту, отличающуюся от вашей валюты по умолчанию. Если вы не уверены, что установили валюту по умолчанию в системе Criteo, проконсультируйтесь со своим техническим специалистом Criteo. Функция currency является суб-функцией viewBasket или trackTransation. Ниже для вас приведен пример. Код используемой валюты должен соответствовать стандарту ISO 4217 Currency Code Standard.
Пример View Basket
Пример Track Transaction / Order Confirmation
Приложение B: Регистрация страницы и рекламного пространства
Ваша команда технических специалистов Criteo зарегистрирует ваши страницы и рекламные блоки и выдаст вам идентификатор каждого рекламного блока для использования в div тегах.
Ниже представлены поля, которые Criteo использует для регистрации ваших страниц.
Параметр |
Описание |
|
Event Name |
Идентификатор, присваиваемый вашим техническим специалистом Criteo в зависимости от типа страницы. |
|
Page Type |
Классификация стандартных страниц |
Классификация нестандартных страниц (пожалуйста, обратитесь к вашему техническому специалисту Criteo за инструкциями для данного типа страниц) |
• Домашняя страница (главная страница вашего сайта) • Страница поиска (каждая страница сайта, которая позволяет осуществить поисковый запрос) • Страница просмотра (все страницы вашего сайта, которые содержат список категорий товаров) |
• Страница подборки (каждая страница сайта, на которой содержится определенная подборка товаров, выбранных магазином, которая является лэндингом для кампании или основанием для SEO) • Страница мерчендайзинга (страница, на которую пользователь попадает через просмотр или фильтр, но которая не содержит списка товаров) |
|
• Страница товара (все страницы с описанием конкретного товара на вашем сайте) • Страница корзины или оформления заказа (страница просмотра корзины до подтверждения заказа) • Страница подтверждения заказа (финальная страница подтверждения совершения покупки) |
• Страница регистрации либо избранного • Другие ритейл страницы • Страница специальных предложений |
Платформа |
Выберите платформу, на которой загружается данная страница: ПК Мобильное приложение Смешанная (адаптивный сайт) |
Таким образом создается регистрируемый идентификатор страницы в нашей системе. Мастер тегов будет использовать этот идентификатор страницы для всех интеграций Criteo OneTag JavaScript.
Пример. |
|
Event Name |
viewHome |
Page Type |
Главная |
Платформа |
Смешанная |
После регистрации страницы ваш технический специалист Criteo установит рекламные блоки, где будут показываться баннеры Criteo Sponsored Products на вашем сайте. Ниже приведен процесс регистрации рекламного пространства.
Параметр |
Описание |
|
Event Name |
Идентификатор, присваиваемый вашим техническим специалистом Criteo в зависимости от типа страницы. |
|
Идентификатор рекламного блока |
Идентификатор, определяемый вашим техническим специалистом Criteo, зависит от типа контента, отображаемого на данной странице. |
|
Page Type |
Классификация стандартных страниц |
Классификация нестандартных страниц (пожалуйста, обратитесь к вашему техническому специалисту Criteo за инструкциями для данного типа страниц) |
• Домашняя страница (главная страница вашего сайта) • Страница поиска (каждая страница сайта, которая позволяет осуществить поисковый запрос) • Страница просмотра (все страницы вашего сайта, которые содержат список категорий товаров) • Страница товара (все страницы с описанием конкретного товара на вашем сайте) • Страница корзины или оформления заказа (страница просмотра корзины до подтверждения заказа) |
• Страница подборки (каждая страница сайта, на которой содержится определенная подборка товаров, выбранных магазином, которая является лэндингом для кампании или основанием для SEO) • Страница мерчендайзинга (страница, на которую пользователь попадает через просмотр или фильтр, но которая не содержит списка товаров) • Страница регистрации либо избранного • Другие ритейл страницы • Страница специальных предложений |
|
• Страница подтверждения заказа (финальная страница подтверждения совершения покупки) |
|
Платформа |
Выберите платформу, на которой загружается данная страница: Десктоп Мобильное приложение Смешанная (адаптивный сайт) |
|
Горизонтальная ориентация |
На странице загружается горизонтально расположенный баннер. Возможные варианты размещения на странице: Слева, справа, посередине |
|
Вертикальная ориентация |
На странице загружается вертикально расположенный баннер. Возможные варианты размещения на странице: Вверху страницы, внизу страницы, в центре |
|
Расположение в общей сетке товаров |
Расположение рекламных блоков в органической сетке товаров на сайте или вне ее. |
|
Размер |
Ширина и высота рекламного блока. |
|
Контент-таргетинг |
Соответствие рекламы полученному от пользователя контексту |
|
Максимальное количество показов |
Максимальное число показов рекламы. Если в системе Criteo есть еще доступные рекламные баннеры, они просто не будут загружаться на странице. |
|
Минимальное количество показов |
Минимальное число показов рекламы. Criteo необходимо указать минимальное количество баннеров для показа на странице, иначе div для рекламы Criteo не сможет работать корректно. |
Как только рекламное пространство готово к работе, технический специалист Criteo присвоит идентификатор этого рекламного пространства Ad Placement.
Пример. |
|
Page ID: |
viewHome |
Идентификатор рекламного блока |
viewHome-viewHomeAds |
Горизонтальная ориентация |
Bottom |
Вертикальная ориентация |
Center |
Location-Grid: |
Outside Grid |
Размер: |
300x150 |
Контент-таргетинг |
Run-of-Site |
Max Ads |
15 |
Min Ads |
5 |
Приложение C: Интеграция Brand Spotlight
Brand Spotlight – это продукт Criteo, альтернатива Amazon Headline Search. Brand Spotlight позволяет рекламодателям получить доступ к эксклюзивному премиум инвентарю для рекламы своего бренда. Эти рекламные блоки представляют собой микс нативного контента и элементов брендинга: логотип бренда и слоган рекламодателя отображается наряду с товарами из sponsored products.
Если вы добавляете интвентарь BrandSpotlight на страницу, где отсутствуют теги Criteo, ознакомьтесь со инструкциями по Тегу страницы списка, который может быть использован на любой странице вашего сайта. Если же на данной странице уже установлены наши теги, интеграция Brand Spotlight очень проста.
Пример
Идентификатор рекламного блока вы получите от своего технического специалиста Criteo, как это указано в Приложении B, он также предоставит вам идентификатор BrandSpotlight PlacementID. На странице с инвентарем BrandSpotlight понадобится установить <div id>.
Приложение D: Brand Store 360
Для доступа к Brand Store 360 вначале свяжитесь со своим аккаунт-стратегом Criteo, который запустит данную функцию отчетности в вашем аккаунте. Как только данная функция добавлена в ваш аккаунт, ваш технический специалист Criteo окажет вам всю необходимую техническую поддержку.
Для интеграции Brand Store 360 необходимы те же теги, о которых мы писали выше. В дополнение к этим тегам необходима еще одна новая функция, которую нужно добавить к Criteo OneTag на каждой странице сайта вашего бренда.