Руководство: как отправить письмо подтверждения заказа
Этот гайд покажет алгоритм работы в маркете Altcraft Platform.
В качестве примера представим, что у нас есть интернет-магазин смартфонов. Покупатель заходит на сайт, добавляет товар в корзину и оформляет заказ. Наша задача — отправить ему письмо подверждения заказа, где будет указан номер заказа и сумма к оплате.
В инструкции описаны следующие шаги:
- Создание канала продаж и точек контакта
- Импорт данных о продуктах и SKU с помощью yml файла
- Настройка API-запроса для добавления данных заказа в маркет
- Создание шаблона и подстановка данных заказа с помощью переменных
- Настройка триггерной кампании
Шаг 1. Настройка канала продаж
Работа в маркете начинается с создания канала продаж. Канал определяет базу профилей и точки контакта.
База профилей — это покупатели, которые делают заказы в определенном канале. Необходимо импортировать их данные в новую или существующую базу. Для этого воспользуйтесь импортом из файла или через API.
Точка контакта — это площадка или инструмент, с помощью которого вы продаете клиенту товары или услуги (сайт, магазин, постамат, отдельный терминал, соцсеть, call-центр и др.). Точка контакта связывает канал продаж и заказ.
Чтобы создать канал, в главном меню перейдите в раздел Маркет → Настройки. На вкладке Каналы продаж создайте новый канал. Укажите:
- название канала
- дополнительный идентификатор
- базу профилей
- тип канала: онлайн или ритейл
Далее сохраните канал и снова перейдите в его настройку. Создайте точки контакта.
Обратите внимание, каждая точка может быть привязана только к одному каналу. Идентификатор точки контакта будет использоваться в API-запросе для импорта заказа.
Шаг 2. Загрузка в платформу данных о товарах
Товары в Маркете представлены двумя сущностями: продукты и SKU.
Продукт — это товар или услуга для продажи. SKU — это модификатор продукта, т.е. группа товаров, которая выделяется в одном продукте по некоторым параметрам (цвет, размер, вес, модель, комплектация и т.д.).
SKU привязывается к определенному продукту и не может существовать без него. Например, Apple iPhone 12
— это продукт, а Apple iPhone 12 128GB
и Apple iPhone 12 256GB
— это его SKU.
Добавить данные о товарах в платформу можно тремя способами:
Давайте импортируем товары из файла. Для этого вам необходимо подготовить файл в формате yml.
Если возникнут вопросы по импорту, читайте подробную инструкцию.
Ниже показаны примеры yml-файлов:
- Продукт
- SKU
Файл с таким содержимым добавит в маркет два продукта: Apple iPhone 12
и Xiaomi 12X
.
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2017-02-05 17:22">
<shop>
<name>BestSeller</name>
<company>Tne Best inc.</company>
<url>http://best.seller.ru</url>
<categories>
<category id="10">Смартфоны</category>
<category id="101" parentId="10">Apple</category>
<category id="102" parentId="10">Xiaomi</category>
</categories>
<offers>
<offer id="iphone12" available="true">
<name>Apple iPhone 12</name>
<vendor>Apple</vendor>
<url>http://best.seller.ru/product_page.asp?pid=12348</url>
<price>83990</price>
<oldprice>89990</oldprice>
<currencyId>RUB</currencyId>
<categoryId>101</categoryId>
<picture>https://example.com/img/apple_phone.png</picture>
<delivery>true</delivery>
<manufacturer_warranty>true</manufacturer_warranty>
<barcode>0156789012</barcode>
</offer>
<offer id="xiaomi12" available="true">
<name>Xiaomi 12X</name>
<vendor>Xiaomi</vendor>
<url>http://best.seller.ru/product_page.asp?pid=12345</url>
<price>62990</price>
<oldprice>69990</oldprice>
<currencyId>RUB</currencyId>
<categoryId>102</categoryId>
<picture>https://example.com/img/xiaomi_phone.png</picture>
<delivery>true</delivery>
<manufacturer_warranty>true</manufacturer_warranty>
<barcode>0123456789379</barcode>
</offer>
</offers>
</shop>
</yml_catalog>
Файл добавит два SKU для продукта Apple iPhone 12
: Apple iPhone 12 128GB
и Apple iPhone 12 256GB
.
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2017-02-05 17:22">
<shop>
<name>BestSeller</name>
<company>Tne Best inc.</company>
<url>http://best.seller.ru</url>
<offers>
<offer id="apple12_128gb" group_id="iphone12" available="true">
<name>Apple iPhone 12 128GB</name>
<vendor>Apple</vendor>
<url>http://best.seller.ru/product_page.asp?pid=12358</url>
<price>71990</price>
<oldprice>72990</oldprice>
<currencyId>RUB</currencyId>
<categoryId>101</categoryId>
<picture>https://example.com/img/apple_phone_128.png</picture>
<delivery>true</delivery>
<manufacturer_warranty>true</manufacturer_warranty>
<barcode>0156789012</barcode>
</offer>
<offer id="apple12_256gb" group_id="iphone12" available="true">
<name>Apple iPhone 12 256GB</name>
<vendor>Apple</vendor>
<url>http://best.seller.ru/product_page.asp?pid=12359</url>
<price>83990</price>
<oldprice>89990</oldprice>
<currencyId>RUB</currencyId>
<categoryId>102</categoryId>
<picture>https://example.com/img/apple_phone_256.png</picture>
<delivery>true</delivery>
<manufacturer_warranty>true</manufacturer_warranty>
<barcode>0156789012</barcode>
</offer>
</offers>
</shop>
</yml_catalog>
Список всех продуктов и SKU хранится в элементе offers. Один продукт или SKU записывается в отдельном элементе offer.
Для элемента offer указывается атрибут id , уникальный для каждого товара.
Cтруктура yml файла для продукта и SKU практически не отличается. Единственное отличие — при импорте SKU для элемента offer указывается не только id, но также group_id – идентификатор продукта.
Обратите внимание, SKU – это ра зличные вариации одного продукта, поэтому значение атрибута group_id должно быть одинаковым для всех SKU одного продукта.
Чтобы импортировать файл со списком продуктов, перейдите в раздел Маркет → Продукты. Нажмите на иконку в верхней панели, а затем выберите, что именно хотите импортировать — продукт.
Кликните на область загрузки и выберите файл на своем устройстве:
Запустите процесс импорта, нажав кнопку "Импортировать" в верхней панели.
Затем импортируйте SKU, повторив все действия, описанные в этом пункте.