Войти

Добро пожаловать в Центр поддержки

Получите помощь с интеграцией и запущенными кампаниями.

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

Criteo OneTag для Sponsored Products

Мы создали руководство по интеграции, предназначенное для команд разработчиков и специалистов по монетизации в компаниях-ритейлерах. Это руководство призвано помочь вам в установке 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 состоит из двух элементов:

  1. Criteo Loader – это JavaScript код для вашего аккаунта в системе Criteo, который должен быть прописан в заголовке каждой страницы сайта, в которую интегрируется Criteo OneTag. Это минимизирует какие-либо задержки в загрузке Criteo Sponsored Products. Criteo Loader отвечает за загрузку рекламы и отправку запросов на серверы Criteo Sponsored Products.

  1. События Tracker позволяют нам собирать данные об активности пользователей на вашем сайте, чтобы на их основе показывать им релевантную рекламу. Глубокое понимание активности ваших пользователей и контекста сайта обеспечивает Criteo максимальную точность таргетинга при создании рекламы. Таргетинг различается для каждого типа страницы. Ключевые страницы, активность на которых необходимо отслеживать, вне зависимости от того, отображается ли на них реклама:
  • Страницы:
    • Главная страница
    • Страница каталога категорий
    • Страница результатов поиска
    • Страница товара
    • Страница корзины
    • Страница подтверждения заказа

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

Пример

 

Универсальные параметры

Указанные ниже параметры необходимы для корректного трекинга, вне зависимости от того, отображается ли на ней реклама, и от типа страницы 

Event

Параметр

Sample Value

Описание

Тип

Требуется

 

 

 

 

setAccount

 

 

 

 

account

 

 

 

 

123456

Идентификатор Criteo Partner Account Этот идентификатор вам предоставит технический специалист Criteo.

 

 

 

 

String

 

 

 

 

Да

 

 

 

 

setRetailerVisitorId

 

 

 

 

id

 

 

 

53e20ea700424f7bbdd7 93b02abcb5d7

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

 

 

 

 

String

 

 

 

 

Да

 

 

 

 

 

 

setEmail

 

 

 

 

 

 

email

 

 

 

 

 

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 на каждой странице сайта вашего бренда.

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
На базе технологии Zendesk