Как настроить товарные рекомендации в email

Если в блоке «Товары» для параметра Источник установить значение Рекомендации, товары можно будет ранжировать по стратегиям Бестселлеры, Снова в наличии, Снижение цены, Новинки, Часто покупают вместе или На основе просмотренного без необходимости выбирать товары вручную или создавать правило для каталога. Описание всех полей, которые добавляет этот источник, см. в разделе Получение рекомендованных товаров. Для работы трех из этих стратегий требуются данные не из вашего каталога: стратегия Бестселлеры считывает историю заказов, а стратегии Часто покупают вместе и На основе просмотренного считывают информацию о том, что покупатели просматривали и покупали. В этом руководстве рассказывается, какие данные нужно отправлять, чтобы у каждой стратегии была информация для ранжирования.

Перед началом работы

Убедитесь, что в каталоге вашего аккаунта есть товары. Перейдите в Контент → Каталог товаров и подключите фид, импортируйте CSV-файл или добавьте товары вручную. Узнайте, как заполнить каталог.

Для каких стратегий требуются события

Три из шести стратегий ранжируют товары на основе отправляемых вами событий; остальные три ранжируют товары непосредственно из вашего каталога и не требуют от вас никаких действий.

Стратегия	Требуются ли события?	Источник данных
Снова в наличии	Нет	Изменения остатков в каталоге
Снижение цены	Нет	Изменения цен в каталоге
Новинки	Нет	Дата добавления в каталог
Бестселлеры (7/30 дней)	Да	`PW_OrderCreated` / `PW_OrderUpdated` с `items`
На основе просмотренного	Да	Любое событие, содержащее ID товара. `items` заказа также пополняют пары, по которым она ранжирует
Часто покупают вместе	Да	Любое событие, содержащее ID товара или `items` заказа, плюс тег устройства

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

Бестселлеры: добавьте товары в события о заказах

Стратегии Бестселлеры (7 дней) и Бестселлеры (30 дней) ранжируют товары по количеству проданных единиц за указанный период. Они считывают массив items в событиях PW_OrderCreated и PW_OrderUpdated, а именно productId и quantity каждого товара.

Если вы уже отправляете PW_OrderCreated для удаления тегов брошенной корзины, этот минимальный вызов (только с orderId) по-прежнему будет очищать корзину, но не предоставит стратегии «Бестселлеры» данных для подсчета. Добавьте в тот же вызов позиции заказа:

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "PW_OrderCreated",
    "attributes": {
      "orderId": "ORDER-10293",
      "items": [
        {
          "productId": "SKU-4821",
          "quantity": 1
        },
        {
          "productId": "SKU-5190",
          "quantity": 2
        }
      ]
    },
    "userId": "shopper@example.com"
  }
}

productId должен совпадать с ID, который используется для этого товара в вашем Каталоге товаров, чтобы стратегия «Бестселлеры» могла найти товар для отображения. Дополнительные поля товара (цена, название и т.д.) для этой стратегии игнорируются. Для ранжирования учитываются только productId и quantity. Событие также должно содержать orderId, потому что заказ без него не учитывается.

Когда заказ меняется, отправьте PW_OrderUpdated с тем же orderId и items. Для каждого товара в событии новое значение quantity заменяет предыдущее, а не прибавляется к нему. Так количество товара можно уменьшить до 1 единицы, но не до нуля:

quantity равно 0 или меньше: товар учитывается как 1 проданная единица.
Товар не указан в items: для товара сохраняется количество из последнего события, в котором он был.

Например, покупатель заказывает 2 единицы товара и возвращает обе. Если отправить PW_OrderUpdated со значением quantity этого товара, равным 0, стратегия «Бестселлеры» учтет для него 1 единицу вместо 2. Если убрать товар из items, по-прежнему будут учитываться 2 единицы. Никакое событие не удаляет возвращенный или отмененный товар из стратегии «Бестселлеры». Он перестает учитываться, только когда заказ выходит за пределы окна в 7 или 30 дней.

Если вы используете интеграцию с Shopify:

Каждый оплаченный заказ приходит как PW_OrderCreated с ID заказа Shopify в orderId и с items, содержащими productId и quantity. Оплаченные заказы учитываются в стратегии «Бестселлеры», и с вашей стороны ничего добавлять не нужно.
productId — это ID товара в Shopify, тот же ID, который использует ваш каталог при импорте из Shopify.
Интеграция не отправляет PW_OrderUpdated, поэтому стратегия «Бестселлеры» учитывает количество из исходного заказа и не отражает последующие изменения, возвраты или отмены.

Стратегия Бестселлеры ранжирует товары исключительно на основе истории заказов. Просмотры и действия в корзине не учитываются. Для ранжирования, которое также включает просмотры и действия в корзине, используйте стратегии На основе просмотренного или Часто покупают вместе.

На основе просмотренного и Часто покупают вместе: отслеживайте активность по товарам

Обе стратегии строятся на одном и том же сигнале: событиях, содержащих ID товара. Вам не нужно специальное событие с названием «просмотр товара» — любое пользовательское событие, отправленное через postEvent, будет учтено, если его attributes включают один из следующих ключей:

Один товар, как атрибут верхнего уровня: product_id, productId, productid, item_id или sku.
Несколько товаров, как массив products, где каждый элемент имеет product_id, productId, id или sku.

Например, вызовите ваше существующее событие просмотра товара с уже имеющимся атрибутом ID товара:

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "ProductViewed",
    "attributes": {
      "product_id": "SKU-4821",
      "category": "Audio"
    },
    "userId": "shopper@example.com"
  }
}

Стратегия На основе просмотренного рекомендует товары, которые сочетаются с тем, что каждый покупатель недавно просматривал. Она работает так:

Pushwoosh хранит последние 10 товаров, по которым покупатель отправлял события, начиная с самого нового. Товары в этот список добавляют только события с перечисленными выше ключами ID товара. items заказов — нет.
Блок показывает товары, образующие пары с этими недавними товарами, по тем же парам, что и стратегия Часто покупают вместе (см. ниже). Заказы учитываются в этих парах, поэтому отправка PW_OrderCreated с items улучшает и эту стратегию, но не обязательна.
Товары, которые уже есть в списке недавних товаров покупателя, не показываются.
Список очищается через 30 дней после последнего события покупателя по товару. Если у покупателя нет недавних товаров или ни у одного из них пока нет пар, для него в блоке отображается обычный каталог.

Тег товара и другая настройка не требуются.

Стратегия Часто покупают вместе показывает товары, которые покупатели часто выбирают вместе с определенным товаром. Например, для телефона блок может показать чехлы и зарядные устройства, которые другие покупатели телефонов тоже просматривали или покупали. Чем больше покупателей взаимодействовали с обоими товарами, тем выше рекомендуемый товар в рейтинге.

Несмотря на название, покупки не обязательны. Учитываются просмотры, события корзины и заказы. Стратегия считывает:

Все события, содержащие ID товара, по ключам, перечисленным выше.
Массив items событий PW_OrderCreated и PW_OrderUpdated. items других событий, включая PW_AbandonedCart, не считываются.

Pushwoosh формирует пары товаров так:

Два товара образуют пару, если один и тот же пользователь отправил события по обоим товарам за последние 30 дней. События могут быть разными: товарам не обязательно быть в одном заказе.
Пары считаются в пределах одного приложения. Активность в других приложениях вашего аккаунта не учитывается.
Рейтинги пересчитываются раз в день, поэтому новые события влияют на них начиная со следующего дня.

Для стратегии Часто покупают вместе требуется еще один элемент: Тег товара, тег устройства, который содержит ID товара, для которого строятся рекомендации. Укажите имя поля при настройке стратегии в блоке «Товары» (например, PW_LastViewedProductID), а затем поддерживайте этот тег в актуальном состоянии на каждом устройстве. Например, устанавливайте его на ID товара всякий раз, когда покупатель просматривает товар. Если у получателя тег не установлен, для него в блоке будет отображаться обычный каталог.

Убедитесь, что ваши события доставляются

Прежде чем добавлять блок, проверьте, что Pushwoosh действительно получает вышеуказанные события: перейдите в Аудитория → События, откройте отправленное вами событие (PW_OrderCreated или пользовательское событие, содержащее ID товара) и убедитесь, что последние обращения отображаются. См. Статистика событий.

Добавьте блок в ваше email-сообщение

Добавьте блок Товары в контент вашего email-сообщения, установите Источник в Рекомендации и выберите Стратегию. Описание всех полей в панели настроек см. в разделе Получение рекомендованных товаров. Нажмите Обновить предпросмотр, чтобы убедиться, что холст заполнен реальными товарами, прежде чем отправлять сообщение.