# Справочный центр Zenky.io

Гид по функциям, ответы на часто задаваемые вопросы, ознакомительный тур и полезные ссылки. Здесь  данные, чтобы сделать сайт, приложение, бонусную систему и подключить к своей учетной системе.

## Только зарегистрировались?&#x20;

Всего 3 минуты, чтобы разобраться с интерфейсом, и вы готовы сделать&#x20;

* мобильное  приложение
* сайт для доставки еды
* интернет-магазин
* QR-меню
* VK магазин
* бонусную систему
* связать со своей учетной системой

{% content-ref url="/pages/-M3KBrCUwwCc2RW4iJsM" %}
[Как начать работать в Zenky.io](/start/firststep)
{% endcontent-ref %}

## Новости, обновления, уведомления

Следите за выпуском новых полезных функций на сайте <https://zenky.io/updates> или в нашем Телеграм-канале <https://t.me/zenky_io>.

Также рекомендуем вступить в чат пользователей Zenky Business → <https://t.me/zenky_chat>. Этот чат создан для взаимопомощи, знакомства и общения владельцев магазинов на платформе Zenky.


# Как начать работать в Zenky.io

Вводный документ, чтобы быстро разобраться в основах

1. Зарегистрироваться в системе по адресу [https://my.zenky.io](https://my.zenky.io/)
2. Создать свой магазин. [Инструкция→](https://help.zenky.io/shop/create)
3. Наши менеджеры внедрения свяжутся с вами и создадут для вас магазин и аккаунт владельца магазина, а так же проконсультируют о тарифных планах
4. Создать город(а), котором работает ваш магазин, кафе, доставка. [Инструкция→](https://help.zenky.io/shop/cities-pos)
5. Создать склады и привязать их к городам. [Инструкция→](/shop/cities-pos)
6. Создать категории товаров. [Инструкция→](/shop/products)
7. Наполнить товарами в каталог (если нет учетной системы). [Инструкция→](/shop/products)
8. Создать коллекции товаров для отображения на главной странице сайта и приложения. [Инструкция→](/shop/collections)
9. Настроить обмен товарами с вашей учетной системой (1С, Frontpad). [Инструкция→](/exchange/1c/1c-exchange)
10. Создать промо акции. [Инструкция→](broken://pages/-M4ADnxnByn1OXlvFD_U)
11. Настроить бонусные системы Zenky и Frontpad. [Инструкция→](/exchange/frontpad/bonuses-sync)
12. Установить на браузеры операторов расширение Zenky Frontpad Assistant. [Инструкция→](/exchange/frontpad/assitant)
    1. Синхронизировать точки продаж (склады) Zenky и Frontpad
    2. Синхронизировать статусы заказов Zenky и Frontpad
    3. Импортировать заказы из Frontpad
    4. Импортировать клиентов из Frontpad
13. Настроить внешний вид сайта. [Инструкция→](/website/builder)
14. Купить и привязать домен к сайту. [Инструкция→](https://help.zenky.io/website/domains)
15. Настроить внешний вид приложения. (в разработке)
16. Зарегистрировать developer аккаунты в [Appstore](/app/ios/apple-developer) и [Play Market](/app/android/google-play-publish)
17. Оформить [страницы приложения в Appstore](/app/ios/app-store-publish) и [Play Market](/app/android/google-play-publish)
18. Отправить приложение на публикацию.

## Инструкции по шагам

{% content-ref url="/pages/-M4ACkF2RNPMGrNR2a52" %}
[Создание магазина](/shop/create)
{% endcontent-ref %}

{% content-ref url="/pages/-M4ACxwSWY45xFHDO-HT" %}
[Создание городов и складов](/shop/cities-pos)
{% endcontent-ref %}

{% content-ref url="/pages/-M4ADByBWsQrgPbwwPoQ" %}
[Создание категорий и товаров](/shop/products)
{% endcontent-ref %}

{% content-ref url="/pages/-M4ADVBtIeBft4yTd\_v8" %}
[Создание коллекций товаров](/shop/collections)
{% endcontent-ref %}

{% content-ref url="/pages/-M4ADYMpIxfM4t-rDwhc" %}
[Импорт товаров из Frontpad в Zenky](/exchange/frontpad/products-sync)
{% endcontent-ref %}

{% content-ref url="/pages/wpIq0ybbbSjT40VPji9f" %}
[Акции и баннеры](/loyalty/promo)
{% endcontent-ref %}

{% content-ref url="/pages/-M3G6lJ8XziZalOnN6BO" %}
[Настройка бонусной системы Zenky и Frontpad](/exchange/frontpad/bonuses-sync)
{% endcontent-ref %}

{% content-ref url="/pages/-M3BMJ-yWkR4GBUffTFe" %}
[Настройка модуля обмена Zenky Frontpad Assistant](/exchange/frontpad/assitant)
{% endcontent-ref %}

{% content-ref url="/pages/-M4AjxeADgCp93t-bNLc" %}
[Конструктор сайта](/website/builder)
{% endcontent-ref %}


# Как подготовить магазин к продвижению

Что делать с созданным магазином, чтобы он был готов к продвижению

1. Настроить [бонусную систему](/exchange/frontpad/bonuses-sync)
2. Настроить [бонусные уровни](/loyalty/bonuses#bonusnye-urovni)
3. Создать [скидки в "счастливые часы"](/loyalty/bonuses)
4. Создать полезные [акции с красивыми баннерами](https://help.zenky.io/loyalty/promo)
5. Создать программу "Приветственные бонусы"
6. Создать программу ["Приведи друга, получи бонусы и твой друг получит бонусы"](/loyalty/referral)
7. Установить [счетчик посещений сайта Яндекс.Метрика](/website/metrika)
8. Установить [пиксели от Facebook и Вконтакте](/website/vkontakte-piksel#facebook-pixel)
9. Повесить иконки приложений на сайт
10. Создать  QR коды на скачивание приложений для рекламы
11. Подключить [рассылку push-сообщений](/push/start)


# Вопрос-ответ

Публикуем ответы на наиболее часто задаваемые вопросы

<details>

<summary>Не находится адрес в форме заказа</summary>

Если ваши клиенты не могут найти адрес в подсказках при заказе, это значит, что адреса нет в базе данных подсказок dadata.ru, которая у нас используется по умолчанию. Чтобы разрешить эту проблему есть два пути.

1\. Отключить обработчик адресов и подсказки.&#x20;

2\. Добавить улицу или дом в базу Дадата

Подробнее [читайте в статье](/delivery/check-address).

</details>


# Создание магазина

Регистрация в системе и создание первого магазина на Zenky.io

{% embed url="<https://youtu.be/RlEhWdFNoS4>" %}

## Регистрация аккаунта <a href="#signup" id="signup"></a>

Прежде чем вы сможете создать магазин, вам необходимо зарегистрироваться или войти в свой аккаунт Zenky.

Для регистрации перейдите по ссылке [my.zenky.io/register](https://my.zenky.io/register) и выберите опцию **«Как владелец магазина»**.

<figure><img src="/files/zNXBDNgLFIeMBdKkNzkU" alt="" width="375"><figcaption><p>Первичное окно регистрации.</p></figcaption></figure>

В открывшейся форме укажите ваш номер телефона (его нужно будет подтвердить кодом из SMS, поэтому указывайте номер, к которому у вас есть доступ), адрес электронной почты и придумайте пароль.

<figure><img src="/files/4Ofjnheljgk4ay1jYe0G" alt="" width="375"><figcaption><p>Форма регистрации аккаунта.</p></figcaption></figure>

После создания аккаунта вам нужно будет подтвердить телефон кодом из SMS. Если SMS не приходит, нажмите на кнопку «Выслать код повторно» (станет доступна через 60 секунд после первой отправки).

<figure><img src="/files/RpTYIs0FU3msjuYlVCxD" alt="" width="375"><figcaption><p>Форма подтверждения телефона.</p></figcaption></figure>

После успешного подтверждения телефона вы будете перенаправлены на страницу создания первого магазина.

### Создание магазина <a href="#create-store" id="create-store"></a>

Форма создания магазина разделена на 5 шагов – информация о магазине, создание первого города, создание первого склада, первичная настройка магазина и выбор тарифного плана.

#### Информация о магазине <a href="#general-info" id="general-info"></a>

На первом экране от вас потребуется ввести как минимум название вашего магазина. Оно будет отображаться в панели управления, а так же на некоторых страницах, которые смогут увидеть покупатели.По желанию так же можно сразу загрузить логотипы магазина – один в любых пропорциях и один – квадратный. Если у вас нет логотипов, этот шаг можно будет выполнить позднее в любое время.

<figure><img src="/files/Di4On1np8iPHZqjCW4kC" alt=""><figcaption><p>Первый шаг создания магазина.</p></figcaption></figure>

Нажмите на кнопку «Сохранить», когда закончите.

#### Первый город <a href="#first-city" id="first-city"></a>

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

<figure><img src="/files/3Orsy37wGccNCtnd68fz" alt=""><figcaption><p>Форма с основной информацией о городе.</p></figcaption></figure>

Так же вы можете добавить контакты для города – они будут отображаться на сайте или в мобильном приложении. Включите переключатель **«Добавить контакты»**, чтобы открыть форму добавления контактов.

Если вы добавляете контакты соц. сетей, используйте в качестве контакта полную ссылку на страницу в конкретной социальной сети.

<figure><img src="/files/3LbrBVSOS0jonYsotkiz" alt=""><figcaption><p>Форма добавления контактов города.</p></figcaption></figure>

Для корректной работы подсказок адресов доставки вам потребуется выбрать центр города. Ещё он будет использоваться на сайте, чтобы показать карту точек самовывоза (складов).

Включите переключатель **«Настроить работу адресов доставки»** и кликните на карте по центру вашего города (должна появиться **красная** метка). От него будет рассчитываться радиус поиска адресов доставки. **Радиус очень важно подобрать и указать, иначе адреса просто не будут появляться в выпадающем списке!**

<figure><img src="/files/IAAI798S6sALy0cknfcy" alt=""><figcaption><p>Выбор центра города.</p></figcaption></figure>

Нажмите на кнопку «Сохранить», когда завершите заполнение формы.

#### Первый склад <a href="#first-stock" id="first-stock"></a>

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

Значение поля «Название» будет использоваться в панели управления, а «Публичное название» – на сайте или в мобильном приложении (если оно задано; в противном случае будет использовано поле «Название»).

<figure><img src="/files/8kLwQglh8GzyNqZItaGc" alt=""><figcaption><p>Основная информация склада.</p></figcaption></figure>

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

Начните вводить ваш адрес, а затем выберите нужную подсказку. Дополнительно вы можете указать офис, подъезд или вход и этаж.

<figure><img src="/files/LPeeC8irbZ8TD65RANH1" alt=""><figcaption><p>Форма ввода адреса склада.</p></figcaption></figure>

Режим работы склада отображается на форме оформления заказа и на информционных страницах сайта или мобильного приложения.

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

Для отметки, что склад работает круглосуточно отметьте переключатель «Круглосуточно» или введите значения «00:00» в оба поля.

<figure><img src="/files/RP0wue21xtiPWiSHIW7X" alt=""><figcaption><p>Форма настройки режима работы склада.</p></figcaption></figure>

Для склада тоже можно добавить свои контакты – они будут показаны на информационных страницах сайта или мобильного приложения. Для добавления включите переключатель «Добавить контакты».

#### Первичная настройка <a href="#initial-setup" id="initial-setup"></a>

На четвёртом шаге вы можете настроить способы доставки, минимальную сумму заказа (в том числе для конкретного способа доставки), способы оплаты и дополнительные поля формы заказа.Выберите подходящие для вас настройки и нажмите на кнопку **«Сохранить»**. Вы сможете отредактировать эти и дополнительные настройки в любое время.

#### Завершение <a href="#congrats" id="congrats"></a>

Поздравляем! Вы успешно создали магазин на платформе Zenky. Воспользуйтесь ссылками на финальном экране, чтобы начать работу.

#### Тарифный план

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

Мы стараемся связываться с новыми пользователями как можно быстрее, но если вам никто не позвонил, пожалуйста, обратитесь в чат техподдержки (верхний правый угол экрана), чтобы вам включили пробный период и проконсультировали по дальнейшей работе.


# Создание городов и складов

## Создание склада

Перейдите в раздел [**«Города и склады» -> «Склады»**](https://my.zenky.io/dashboard/stocks) в панели управления Zenky и нажмите на кнопку **«Создать»** в правой верхней части экрана либо перейдите по [этой ссылке](https://my.zenky.io/dashboard/stocks/create).

{% embed url="<https://youtu.be/menkG1AbdmY>" %}

## Создание города

&#x20;Перейдите в раздел [**«Города и склады» -> «Склады»**](https://my.zenky.io/dashboard/cities) в панели управления Zenky и нажмите на кнопку **«Создать»** в правой верхней части экрана либо перейдите по [этой ссылке](https://my.zenky.io/dashboard/cities/create).

{% embed url="<https://youtu.be/VPDbuiIspn8>" %}


# Создание категорий и товаров

## Создание категории

Для создания новой категории перейдите в раздел [**«Каталог» -> «Категории»**](https://my.zenky.io/dashboard/categories) и нажмите на кнопку «Создать» в правой верхней части страницы или перейдите по этой [**ссылке**](https://my.zenky.io/dashboard/categories/create).

Укажите название категории, выберите её отображение и, если необходимо, добавьте описание.

<figure><img src="/files/0JFMV32dRXOYjs5lz5bh" alt=""><figcaption><p>Основные поля формы категории</p></figcaption></figure>

Ниже вы сможете выбрать родительскую категорию (или оставить новую категорию в корне каталога) и отметить новую категорию как «Избранную». Избранные категории могут отображаться на сайте или в мобильном приложении выше всех остальных категорий.

<figure><img src="/files/khq15kiB1Psj6FXyclDS" alt=""><figcaption><p>Дополнительные поля формы категории.</p></figcaption></figure>

Список категорий выглядит лучше всего, когда у каждой категории (хотя бы у корневых) есть фотографии-обложки. Мы рекомендуем загружать обложки, выполненные в едином стиле. \
**‼️Лучше всего подходят прямоугольные изображения с шириной не менее 1000 пикселей‼️**

Так же вы можете выбрать глобальные правила участия товаров из этой категории в программе лояльности.

<figure><img src="/files/ZrQb1eiJUDJARbf8MlCT" alt=""><figcaption><p>Правила участия товаров в программе лояльности.</p></figcaption></figure>

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

<figure><img src="/files/DGt1fS0Swl46YPRXhTcK" alt=""><figcaption><p>Выбор конкретных разделов программы лояльности.</p></figcaption></figure>

Даже если вы запретите участие товаров в программе лояльности, вы сможете переопределить это поведение для конкретных товаров вручную.

## Управление вложенностью категорий

Для более удобного (чем редактирование категорий и установка родительской) управления деревом вложенности категорий перейдите в раздел [**«Каталог» -> «Категории»**](https://my.zenky.io/dashboard/categories) и нажмите на кнопку **«Вложенность»** в правой верхней части страницы или перейдите по этой [**ссылке**](https://my.zenky.io/dashboard/categories/tree).

<figure><img src="/files/i8sjJN14jJBVxUbgLWrF" alt=""><figcaption><p>Управление вложенностью категорий.</p></figcaption></figure>

Перемещайте категории вверх-вниз для изменения сортировки и влево-вправо для изменения вложенности. Мы поддерживаем неограниченную вложенность, но для удобства покупателей рекомендуем ограничиться максимум 2-3 уровнями вложенности.

После завершения работы нажмите на кнопку **«Сохранить»** внизу страницы.

{% embed url="<https://www.youtube.com/watch?v=LYRAl_RlV8k>" %}

## Создание товара

Для создания нового товара перейдите в раздел [**«Каталог» -> «Товары»**](https://my.zenky.io/dashboard/products) и нажмите на кнопку «Создать» в правой верхней части страницы или перейдите по [**этой ссылке**](https://my.zenky.io/dashboard/products/create).

Форма создания товара значительно меньше, чем формы редактирования, поэтому на этапе создания указываются только самые основные параметры.

<figure><img src="/files/XgsYGFfksHp6xpo3j5Sq" alt=""><figcaption><p>Форма создания товара.</p></figcaption></figure>

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

Так же выберите категорию, в которую должен быть помещён товар. Если необходимо, можно выбрать несколько категорий.

{% hint style="info" %}
Выбирайте только последнюю по уровню вложенности категорию – все предыдущие (родительские) категории будут добавлены к товару автоматически.

Например, если у вас есть категория «Роллы и Суши», а в ней – «Роллы темпура», достаточно выбрать категорию «Роллы темпура», родительскую «Роллы и Суши» выбирать не нужно.
{% endhint %}

Далее, укажите цену за единицу товара. Если вы захотите добавить дополнительные варианты или цены, вы сможете сделать это после создания товара.

Если товар будет использоваться в качестве подарка за акцию, отметьте соответствующий переключатель. В этом случае покупатели смогут добавить его в корзину только в качестве подарка (в обычную корзину добавить его будет нельзя).

Так же вы можете переопределить участие товара в программе лояльности. По умолчанию будут использоваться правила категории, в которой находится товар (если категорий несколько, будет использована первая категория в списке).

<figure><img src="/files/74lXMNJAu1WDpHs7W9Wq" alt=""><figcaption><p>Настройки программы лояльности товара.</p></figcaption></figure>

{% embed url="<https://www.youtube.com/watch?v=rz2I_W4rEXY>" %}


# Создание коллекций товаров

Коллекции товаров позволяют объединить товары из разных категорий по какому-то общему признаку. Например, служба доставки еды может объединить в коллекции «Комплексный обед» товары из категорий «Первые блюда», «Вторые блюда» и «Салаты».

Список товаров коллекций можно задать вручную (выбирая каждый товар вручную) или применить список критериев, по которым будут отбираться товары – в этом случае новые товары, попадающие под критерии, будут добавляться в такие коллекции автоматически.

Коллекции могут отображаться на сайте или в мобильном приложении.

## Создание коллекции

Перейдите в раздел [**«Каталог» -> «Коллекции»**](https://my.zenky.io/dashboard/products-collections) в панели управления Zenky и нажмите на кнопку «Создать» в правой верхней части страницы или перейдите по [**этой ссылке**](https://my.zenky.io/dashboard/products-collections/create).

Укажите основную информацию о коллекции – её статус отображения, название, описание и обложку.

<figure><img src="/files/d145iRdmweImNXFLaNi0" alt=""><figcaption><p>Основная информация о коллекции товаров.</p></figcaption></figure>

Далее вам необходимо выбрать как именно будет наполняться коллекция – по критериям или вручную.

## Отбор товаров по критериям

Если вы хотите, чтобы товары попадали в коллекцию автоматически, выберите тип отбора **«По критериям»**. Поле **«Режим отбора»** отвечает за то, как именно будут отбираться товары – фактически это выбор режима «И» или «ИЛИ».

<figure><img src="/files/qWrAHsMfKrYjmDPFwefR" alt=""><figcaption><p>Настройки критериев коллекции товаров.</p></figcaption></figure>

Каждый критерий состоит из трёх параметров:

1. Поле, по которому будет выполняться поиск;
2. Операция сравнения (равно, содержит, больше и т.д.);
3. Значение, которое будет сравниваться в выбранном поле.

Вам доступно четыре поля, по которым может выполняться отбор товаров:

1. Название товара;
2. Название варианта товара;
3. Цена варианта товара;
4. Категория товара.

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

### Название товара

Название товара может сравниваться следующими операциями:

1. Равно – название товара должно полностью совпадать с полем «Значение»;
2. Не равно – название товара не должно совпадать с полем «Значение»;
3. Начинается с – название товара должно начинаться со строки из поля «Значение»;
4. Заканчивается на – название товара должно заканчиваться строкой из поля «Значение»;
5. Содержит – название товара должно содержать (хоть где) строку из поля «Значение»;
6. Не содержит – название товара не должно содержать строку из поля «Значение».

### Название варианта товара

Название варианта товара имеет те же самые операции сравнения, что и название товара.

### Цена варианта товара

Цена варианта может сравниваться следующими операциями:

1. Равно – цена варианта должна быть равна сумме из поля «Значение»;
2. Не равно – цена варианта не должна быть равна сумме из поля «Значение»;
3. Больше – цена варианта должна быть больше суммы из поля «Значение»;
4. Меньше – цена варианта должна быть меньше суммы из поля «Значение».

### Категория товара

У категории товара есть только одна операция сравнения – «Равно». Если этот критерий присутствует, товары будут отбираться только из указанной категории (по всем остальным критериям).

## Ручной отбор товаров

Если вы не хотите использовать критерии, вы можете добавить товары в коллекцию самостоятельно. Для этого переключите поле **«Тип отбора»** на **«Вручную»**.

<figure><img src="/files/yoXbn7tNJkzTdp2bt5q4" alt=""><figcaption><p>Ручной отбор товаров.</p></figcaption></figure>

В поле **«Товары»** вводите название нужных товаров и выбирайте их из выпадающего списка.

{% embed url="<https://youtu.be/fJUfj-CiWQg>" %}


# Акции и баннеры

### Список акций

Акции создаются в системе управления в разделе `«Лояльность - Акции»`&#x20;

<figure><img src="/files/HYcmrB73UeesIddCRdPT" alt=""><figcaption></figcaption></figure>

Перейдя в раздел акции, вы увидите таблицу активных акций. Можете удалить или отредактировать каждую. Для создания новой акции нажмите кнопку `«Создать»` в правом верхнем углу экрана.&#x20;

<figure><img src="/files/0np3pZY7lhKn7cump2xW" alt=""><figcaption></figcaption></figure>

### Основная информация по акции

При создании новой акции укажите `основную информацию`.&#x20;

* Это системное название акции, то как она будет отображаться в системе управления.
* Это город, в котором активна акция. В разных городах, могут быть разные акции
* Загрузите обложку для `Статьи`, которая будет отображаться на странице `Блог`
* Заголовок - какое-нибудь продающее название акции, видное пользователям сайта или приложения
* Вводный текст, который будет  описывать акцию
* Полное описание условий акции

<br>

<figure><img src="/files/6JyWv5brthboB1FK2Lmj" alt=""><figcaption></figcaption></figure>

### Статья об акции

К каждой акции можно создать текстовую статью, поясняющую все детали акции. Статья будет размещена на сайте в разделе «Акции». При клике на баннер акции произойдет переход на статью.

У статьи есть заголовок, краткое описание и полный текст статьи. К статье можно загрузить промо картинку и она будет отображена в статье (лучше всего подходят изображения формата **1200х740**).

### Баннеры для сайта и приложения

Далее загрузите баннеры для сайта и для приложения. Это два отдельных баннера. Сделано так потому, что форматы баннеров для сайта и приложения могут быть разными. \
**!!ВАЖНО!!** Размер картинки баннера для сайта - **1200х500,** для приложения - **120х740**

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

Если вы не хотите, чтобы текст накладывался на баннер, то оставьте поля пустыми.

Выбрав баннер, обязательно нажмите кнопку «Загрузить» и дождитесь появления на картинке зеленой галочки.

<figure><img src="/files/UfzLPky6vtgAg0Pjj6T3" alt=""><figcaption></figcaption></figure>

### Правила акции

У каждой акции есть правила срабатывания, которые проверяются в корзине при каждом ее изменении. Если сработали правила, то в корзине появляются подарки, скидки, бонусы и прочие награды предусмотренные правилами акции. [Подробнее о правилах акций читайте в статье.](/loyalty/rules)

## Видео инструкция

{% embed url="<https://youtu.be/6Anm4gNX7q0>" %}


# Автоматические акции и подарки

Рассказываем про акции и подарки.

Акции делятся на две части – контентную (баннер, статья) и функциональную (подарки). В этой статье мы рассказываем про функциональную – как выдавать подарки покупателям.

## Правила акций

У каждой акции должно быть как минимум одно правило:

* **Количество товаров**. В этом случае покупатели должны добавить в корзину определённое количество товаров. Вы можете указать какие именно товары должны быть добавлены – например, конкретный товар, конкретный вариант товара, товары из заданной категории, товары с определённой опцией варианта или товар с определённым значением опции варианта;
* **Стоимость товаров**. Это правило похоже на предыдущее и в нём можно указывать такие же условия, но вместо количества товаров учитывается их стоимость;
* **Промокод**. Чтобы акция выполнилась, покупатель должен применить конкретный промокод.

Правила можно комбинировать – например, вы можете создать акцию, условиями которой будут *«Добавить 2 товара в корзину из категории "Пицца", сумма должна быть не меннее 2000 рублей и покупатель должен применить промокод "ПИЦЦА"»*.

## Подарки за акции

В качестве подарков вы можете выбрать:

* **Товар на выбор**. Покупатель сможет выбрать товар из разрешённого списка – этот товар будет добавлен в корзину с нулевой ценой. Вы можете ограничить выбор по категории, опции варианта или значению опции варианта;
* **Товар в корзину**. В этом случае вам нужно выбрать конкретный товар и его вариант. Если покупатель выполнит условия акции, этот вариант товара будет добавлен в его корзину автоматически;
* **Фиксированная и процентная скидка**. Вы можете предоставить скидку на товары в корзине, при этом уточнив к каким именно товарам может быть применена скидка (ко всем товарам, к конкретному товару или  варианту товара, к товарам из конкретной категории, к товарам с нужной опцией варианта или к товару с выбранным значением опции варианта);
* **Бонусы**. После завершения заказа с выполненной акцией покупатель получит указанное количество бонусов на свой баланс.

## Ограничения акций

Вы можете задать различные ограничения, чтобы акции срабатывали тогда, когда вам удобно.

### Период работы

Вы можете указать дату начала и дату окончания работы акции. Если выбраны обе даты, акция будет работать только в указанном периоде. Если выбрана одна из дат, акция либо начнётся после указанной даты начала, либо закончится в указанную дату окончания.

### Расписание по дням недели

Также вы можете указать в какие дни недели (и в какое время для каждого дня) должна работать акция. Мы проверяем эти параметры как во время добавления подарков в корзину, так и во время оформления заказа. Если покупатель попытается оформить заказ с добавленным подарком вне разрешённого времени, мы покажем ему ошибку и попросим удалить подарок, чтобы продолжить оформление заказа.

### День рождения

Если у акции включен режим «Акция на день рождения», такую акцию смогут выполнить только те покупатели, у которых:

* в профиле установлена дата рождения;
* дата рождения попадает под условия акции.

Вы можете указать количество дней до дня рождения и после – этот период будет считаться подходящим для выполнения акции (например, если у покупателя день рождения 20 сентября, а в акции установлены параметры «2 дня до дня рождения» и «1 день после дня рождения», то покупатель сможет получить подарок в период с 18 по 21 сентября). Также вы можете установить лимит срабатываний акции за один день рождения.

### Сегмент покупателей

При необходимости вы можете выбрать [сегмент покупателей](/marketing/segments), для которых будет работать акция. Если он выбран, то подарки за акцию смогут получить только те покупатели, которые вошли в свой аккаунт или ввели номер телефона в форме оформления заказа, и которые находятся в выбранном сегменте.

### Лимиты выполнения акции

Вы можете задать следующие лимиты выполнения акции:

* **Общий лимит**. Сколько раз акция может выполниться между всеми покупателями. Если это поле заполнено, то подарки смогут получить только первые N покупателей, где N – значение лимита. После достижения лимита акция перестанет работать;
* **Повторения в заказе**. Этот параметр отвечает за повторения акции внутри одного заказа. Например, если вы указали в правилах «Добавьте товар из категории "Пицца" и получите товар "Соус"», акция может выполняться по-разному в зависимости от этого значения. Если повторения в заказе неограничены, то за каждую пиццу покупатель будет получать ещё один соус. Если же повторения ограничены, то покупатель сможет получить только N соусов, где N – значение лимита;
* **Лимит на покупателя**. Используйте этот параметр, чтобы покупатели не смогли получить подарки больше заданного количества раз. Например, вы хотите, чтобы покупатели могли использовать промокод только один раз. Уникальность покупателей мы проверяем по номеру телефона.


# Бонусная система

Рассмотрим бонусную систему, бонусные уровни, скидки на товар по расписанию и акции.

## Бонусная система

Чтобы настроить бонусную систему нужно зайти на страницу настройки `«Лояльность — Бонусная система».`  и включить бонусную систему.

<figure><img src="/files/uS97zqq6TDSTF419quLJ" alt=""><figcaption></figcaption></figure>

После включения нужно указать процент кэшэка или  бонусного начисления от суммы покупки. А также выбрать, какая система будет производить начисление бонусов.

<figure><img src="/files/Nk7VVBWHruc1SOrqI4ma" alt=""><figcaption></figcaption></figure>

Далее нужно настроить арботу системы по своему вкусу

<figure><img src="/files/lG2LSNJkPj0hsdCplzcr" alt=""><figcaption></figcaption></figure>

Затем вы можете настроить приветственные бонусы, которые клиент может получить после совершения первого заказа через приложение или сайт. Это полезно применять для раскрутки приложения, чтобы увеличить базу клиентов, чтобы в будущем рассылать бесплатные пуш-уведомления с акциями для увеличения повторных покупок и выручки.

<figure><img src="/files/kBWJeLQk5OV5Nii0gU6E" alt=""><figcaption></figcaption></figure>

## Бонусные уровни

Уровни можно назвать также статусами, которые клиент получает при совершении определенного количества покупок в вашем магазине. Уровни имеют названия, например, «Бронза, Серебро, Золото». У каждого уровня есть процент бонусного начисления и процент оплаты чека.

<figure><img src="/files/xsKLeLuFj9odp6iceyhU" alt=""><figcaption><p>Придумать и добавить новый уровень можно через соответствующую кнопку в правом верхнем углу.</p></figcaption></figure>

## Видео инструкция

{% embed url="<https://youtu.be/ktAcADcF_Lw>" %}

## Скидки

В нашей бонусной системе предусмотрены даже скидки, о который подробнее вы можете узнать в разделе [Автоматические скидки](https://help.zenky.io/loyalty/discount)


# Реферальная программа

Программа "Приведи друга" и получит бонусы за его заказ и он тоже получит бонусы после заказа

## Описание реферальной системы Zenky

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

Система будет следить за количеством друзей пришедшим по ссылке и будет награждать клиента и его друга в зависимости от настроек.

{% hint style="info" %}
**Акция может звучать примерно так**

Позови другра и получи 300₽ бонусов за его заказ через приложение от 1000₽ и он получит в подарок 100₽ на бонусный счет
{% endhint %}

## Настройка реферальной программы Zenky

Зайдите в раздел `«Лояльность - Бонусная система»`, найдите блок `«Программа Пригласи Друга»` и включите ее.

<figure><img src="/files/hHM2aUcR1QpDUdeB9St2" alt=""><figcaption></figcaption></figure>

Далее нужно настроить реферальную программу. И первая настройка это&#x20;

### Действие, за которое будет выдана награда

<figure><img src="/files/P63yk6voxipDOJadApv8" alt=""><figcaption></figcaption></figure>

Награда выдается за следующие действия привлеченного  друга:

* Первый вход в аккаунт (регистрация)
* Первый выполненный заказ на сумму
* Потраченная сумма (сумма нескольких заказов)

### Источник или канал продаж от куда пришел друг

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

<figure><img src="/files/Pvw2CkGsxPavUmj5G0nv" alt=""><figcaption></figcaption></figure>

### Сумма трат

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

### Вознаграждение пригласившего

Указать сумму бонусов, которые получит пригласивший в процентах от суммы заказа или фиксированно в бонусах.

### Вознаграждение приглашенного

Указать сумму бонусов, которые получит приглашенный.

<figure><img src="/files/YWdo04dxMyHhmrn1ET8h" alt=""><figcaption></figcaption></figure>

Также, в нашем конструкторе предусмотрена многоуровневая реферральная система. Подробнее о ней вы можете почитать в разделе [Сетевой маркетинг](https://help.zenky.io/loyalty/setevoi-marketing).

## Настройка промо домена для реферальной программы

Для работы системы нужно создать подомен на своем основном домене. Например, `promo.dostavka.ru`

Для этого вам нужно&#x20;

1. зайти в кабинет регистратора вашего домена
2. перейти в раздел редактирования ДНС записей
3. добавить запись типа "А" для поддомена `"promo"` и указать наш ip адрес **178.154.200.26**

Далее перейдите в раздел «Магазин - Каналы продаж» и укажите адрес промо домена и выпустите SSL сертификат для него. Например, `promo.dostavka.ru`

<figure><img src="/files/M6Gr8Jd2HgPuC4eyOoh8" alt=""><figcaption></figcaption></figure>

## Проверка системы

Зайдите на сайт и в приложение как клиента, водите в личный кабинет и нажмите на свою реферальную ссылку. Вас должно отпраивть на страницу приглашения.

<figure><img src="/files/2xdspS0mKEZcLUPnixMe" alt=""><figcaption></figcaption></figure>


# Сетевой маркетинг

**Сетевой маркетинг** - это хороший способ сократить расходы на рекламу. Все мы легче доверяем мнению друзей, чем распиаренным по телевизору продуктам или красочным билбордам на шоссе. Мы решили использовать это свойство человеческой психики и внедрили в конструктор реферальную систему.<br>

С нашей многоуровневой системой вы сокращаете расходы на классический маркетинг и перекладываете его львиную долю на плечи ваших клиентов. За это ваши клиенты получают вознаграждение в виде процентов от заказов их рефералов.&#x20;

\
Подводя итог, сетевой маркетинг – **это крутая штука для быстрого, эффективного, недорогого продвижения продукта**, которая идеально подходит для бизнеса по доставке еды.

<figure><img src="/files/NPl28BVsW2ZyUAcggz2v" alt=""><figcaption></figcaption></figure>

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


# Автоматические скидки

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

<figure><img src="/files/kYGB4lt5Gj1cJsypDiSH" alt=""><figcaption></figcaption></figure>

**Базовые настройки** скидки включают:

* Название скидочной программы
* Размер скидки в процентах или рублях
* Включена скидка или отключена
* Глобальная скидка на все товары или обыкновенная на выборку товаров

<figure><img src="/files/3UzVRqAAbOnVwJpf0TDJ" alt=""><figcaption></figcaption></figure>

* Дата начала действия скидки и дата окончания.
* Город на который распространяется скидка

  <figure><img src="/files/MtLGosP4n4Iu7GRJb1Bq" alt=""><figcaption></figcaption></figure>

  Расписание работы скидок требуется для автоматического включения или отключения скидок на товары. Это существенно облегчает вашу работу. Теперь не нужно следить за скидками, они сами включаются. Расписание устанавливается с шагом не меньше одного  часа.

Также можно настроить поведение скидок в корзине

<figure><img src="/files/8rxDMn1VXagugJX4C274" alt=""><figcaption></figcaption></figure>

**Критерии отбора товаров**, на которые нужно выдать скидки работают по принципу [Коллекций товаров](/shop/collections). Можно выбрать категорию, товары по названию или конкретные товары из поиска.&#x20;

<figure><img src="/files/37R8HtvfQJzjGBzR75Dy" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/MBC7ZsRU2SJ0IapRk7sI" alt=""><figcaption></figcaption></figure>


# Изменение статуса заказа для начисления бонусов

Как изменить статус заказа, чтобы начислить клиенту бонусы за заказ.

## **Этапы ручного изменения статуса заказа**

1. Заказы созданные через сайт и приложение отправляются в учетную систему (Фронтпад, в Iiko бонусы синхронизируются сами).&#x20;
2. В учетной системе заказы уточняются и передаются в производство и доставку.
3. После того, как заказ оплачен, доставлен, курьер сдал наличность / чек терминала - оператор заходит в кабинет [my.zenky.io](https://my.zenky.io) в раздел `"Продажи → Заказы"` и нужном заказе меняет статус на Выполнен.
4. После того как статус `Выполнен` назначен - покупателю начисляются бонусы и они видны на сайте и приложении.

## **Как изменить статус заказа**

1. Зайти на <https://my.zenky.io>
2. Авторизоваться под своим логином и паролем
3. Зайти в раздел “Продажи → Заказы” (<https://my.zenky.io/dashboard/orders>)

   <figure><img src="/files/NfaRX52M3zKaQins7IYF" alt=""><figcaption></figcaption></figure>

4\. Из таблицы заказов выбрать нужный и нажать на иконку Просмотра заказа, либо клинкнуть на номер самого заказа.

<figure><img src="/files/Q63lXLUXOBjwXeNKq05b" alt=""><figcaption></figcaption></figure>

5\. В открывшемся окне редактирования заказа кликнуть на статус “Выполнен” и статус будет изменен. После, чего бонусы будут начислены покупателю.

<figure><img src="/files/DW0pqotEvSD0fObASnA4" alt=""><figcaption></figcaption></figure>

6\. Если заказ отменить, то бонусы будут обратно списаны со счета покупателя. Поэтому нужно быть внимательным и не отменить заказ, чтобы не аннулировать бонусы за этот заказ.

7\. Если же нужно, чтобы бонусы не списывались при отмене заказа, то нужно изменить настройку в разделе `Лояльность` → `Бонусная система` (<https://my.zenky.io/dashboard/store/profile/loyalty>)

<figure><img src="/files/1jgxAg4QCljrVIpJx2lM" alt=""><figcaption></figcaption></figure>


# Промокоды

Рассказываем как работать с промокодами в Zenky.

С помощью промокодов вы можете выдавать фиксированные или процентные скидки вашим покупателям или товары-подарки. У промокодов может быть расписание работы и ограничение по применению – например, вы можете ограничить промокод на конкретное количество применений как глобально (среди всех покупателей), так и для уникальных покупателей.

## Создание промокодов

Ранее в этой документации было описано как создавать отдельные промокоды. Начиная с 13 апреля 2026 года промокоды объединены с акциями и теперь добавление промокодов доступно в редактировании правил акций.

Для того, чтобы ваша акция работала по промокоду, добавьте новое правило "Промокод" и укажите его текст. Это правило можно комбинировать с другими – суммой заказа и/или количеством позиций в корзине.&#x20;

## Подключение промокодов

Для того, чтобы покупатели смогли ввести промокод во время оформления заказа, в разделе **«Дополнительные поля»** [настроек заказа](https://my.zenky.io/dashboard/store/profile/settings/orders) магазина нужно выбрать опцию **«Промокод»**.

<figure><img src="/files/YMIOHGQb2Mka0Sf3SgKl" alt="" width="563"><figcaption><p>Выбор дополнительных полей на форме оформления заказа.</p></figcaption></figure>

После этого на сайте и в приложении покупатели увидят поле «Промокод».

<figure><img src="/files/kQLWRb7FCOc7TlWUACd8" alt=""><figcaption><p>Поле ввода промокода при оформлении заказа на сайте.</p></figcaption></figure>


# Сегментация покупателей

Рассказываем, что такое сегменты покупателей, как их создавать и использовать.

{% embed url="<https://drive.google.com/file/d/1PQEG9eBS0RFJpVP6U9UeSV7FSonyQ8M5/view?usp=sharing>" %}

Сегментация покупателей поможет вам создать группы покупателей по определённым признакам. Например, вы можете объединить покупателей в группы "Не оформляли заказы за последний месяц" или "Покупали пиццу в последние три месяца, но ничего не заказывали в последний месяц".

Созданные сегменты можно использовать в нескольких целях:

* **Отправка уведомлений.** Если у вашего магазина есть мобильное приложение, вы сможете отправлять пуш-уведомления конкретным группам, в зависимости от ваших маркетинговых потребностей. Например, чтобы попытаться вернуть "спящих" покупателей или наоборот, простимулировать активных покупателей на новые заказы.
* **Изучение сегмента.** Каждый динамический сегмент обновляется раз в сутки и его состав может постоянно меняться – какие-то покупатели выходят из сегмента, а какие-то наоборот попадают в него. Мы ведём подсчёт при каждом изменении и показываем его вам.
* **Ограничение акций.** Хотите поощрить постоянных клиентов или дополнительно мотивировать уходящих? Вы можете создать акцию и разрешить её выполнение только для определённого сегмента. Даже если уходящий покупатель поделится промокодом с постоянным, последний не сможет его использовать, так как не находится в нужном сегменте.

## Создание сегмента

Для создания нового сегмента перейдите в раздел [**«Маркетинг»** – **«Сегменты покупателей»**](https://my.zenky.io/dashboard/segments) и нажмите на кнопку **«Создать сегмент»**.

На новой странице вы увидете форму создания сегмента.&#x20;

### Способ создания сегмента

Для начала вам нужно выбрать какой сегмент вы хотите создать – по условиям или по номерам телефонов.

<figure><img src="/files/ykiWqXZqwAEyIzmhT3UL" alt=""><figcaption><p>Поле выбора способа создания сегмента.</p></figcaption></figure>

Если вы выберете **«По условиям»**, вам будет доступен конструктор сегмента. Если выберете **«Импорт по телефонам»**, сможете вставить список телефонов в текстовое поле (один телефон на строку).

#### Импорт по телефонам

Если у вас есть список телефонов покупателей, которым вы хотите отправить уведомления (или просто узнать динамику их заказов), выберите эту опцию, а затем вставьте номера телефонов в поле «Телефоны покупателей». Вы можете использовать телефоны в любом формате – главное, чтобы они начинались со знака «+».

{% hint style="info" %}
Форматы телефонов

Мы поддерживаем полные номера телефонов практически в любых форматах. Номера вида:

* +7 999 999 99 99;
* +7 (999) 999 99 99;
* +7 (999) 999-99-99;
* +7-999-999-99-99
* +79999999999

и так далее будут обработаны без проблем. Однако, если у вас есть номера в "коротком городском" формате (например, 6- или 7-значные без кода города/оператора и знака «+»), такие номера обработаны не будут.
{% endhint %}

#### По условиям

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

### Тип сегмента

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

<figure><img src="/files/GRNqzAkEUbaUeVm0K1M4" alt=""><figcaption><p>Выбор типа сегмента по условиям.</p></figcaption></figure>

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

## Условия сегмента

Если вы выбрали сегмент по условиям, вам станет доступен конструктор сегмента. В нём вы сможете указать параметры отбора покупателей по различным условиям.

Изначально вам доступна одна группа отбора условий. Она работает по принципу **«И»** – это означает, что все указанные в ней условия должны совпасть, чтобы покупатель попал в сегмент. Если вам нужно, чтобы в сегмент попали покупатели хотя бы по одному условию (режим **«ИЛИ»**), измените параметр **«Как объединять условия»** на **«Достаточно любого условия»**.

<figure><img src="/files/RPpU5PI2lGL4kjUv7YmR" alt=""><figcaption><p>Выбор принципа работы группы условий.</p></figcaption></figure>

### Количество заказов

Основное условие, которое вы скорее всего будете использовать, – количество оформленных заказов. В этом условии вы можете выбрать оператор сравнения (больше, больше или равно, меньше, меньше или равно, равно, не равно) и его значение.

Например, если вы хотите найти покупателей, которые оформили только два заказа, выберите оператор **«Равно»**, а в поле **«Значение»** укажите 2.

<figure><img src="/files/kPipPUOcU4FOIlY9NATK" alt=""><figcaption><p>Выбор покупателей с двумя заказами.</p></figcaption></figure>

У условия «Количество заказов» есть ограничение по периоду – по умолчанию выбрано «За всё время». Это означает, что мы будем искать покупателей, которые оформили только два заказа за всё время. Если, к примеру, вы хотите найти покупателей с двумя заказами за последний месяц, измените параметр «Период» на «Последние N дней», а в поле «Количество дней» укажите 30 (или любое другое количество дней).

<figure><img src="/files/W404KRL3dT2Y1X8bSoip" alt=""><figcaption><p>Выбор покупателей с двумя заказами за последние 30 дней.</p></figcaption></figure>

Ещё вы можете поменять период на диапазон конкретных дат – в этом случае будут найдены покупатели, которые оформили ровно два заказа в указанный период.

<figure><img src="/files/SkxSJu6SMj84tTVYk5L9" alt=""><figcaption><p>Выбор покупателей с двумя заказами в определённый период.</p></figcaption></figure>

#### Ограничение по товарам

Условие **«Количество оформленных заказов»** поддерживает дополнительные уточнения – по конкретным товарам, категориям товаров, опциям вариантов или значениям опций вариантов.

Если вы хотите найти покупателей, которые оформляли заказы с конкретными товарами, введите их названия в поле **«Товары»**. Не забудьте нажать на нужный товар, чтобы он добавился в условие.

<figure><img src="/files/GGc3kUHjwwQJOUmRDsrc" alt=""><figcaption><p>Ограничение заказов по конкретным товарам.</p></figcaption></figure>

{% hint style="info" %}
**Обратите внимание**

Если выбрано несколько товаров, они используются в режиме «ИЛИ» – будут найдены покупатели с заказами, в которых есть хотя бы один из выбранных товаров.

То же самое относится ко всем другим ограничениям по товарам.
{% endhint %}

#### Ограничение по категориям

Если вы хотите найти покупателей, которые оформляли заказы с товарами из конкретных категорий, введите нужные категории в поле «Категории».

<figure><img src="/files/bKASYgIutwW8plEccpqN" alt=""><figcaption><p>Ограничение заказов по категориям.</p></figcaption></figure>

#### Ограничение по опциям вариантов

Это ограничение подойдёт вам, если у вашего магазина есть товары с различными вариантами. Если вы хотите найти покупателей, которые оформляли заказы с товарами, варианты которых содержат конкретные опции вариантов (например, **«Размер пиццы»**), введите нужные опции в поле **«Опции вариантов»**.

<figure><img src="/files/9VNY8W5xaQ0qgA4NLYSn" alt=""><figcaption><p>Ограничение заказов по опциям вариантов.</p></figcaption></figure>

#### Ограничение по значениям опции вариантов

Это ограничение подойдёт вам, если у вашего магазина есть товары с различными вариантами. Если вы хотите найти покупателей, которые оформляли заказы с товарами, варианты которых содержат конкретные значения опций вариантов (например, опция **«Размер пиццы»** и значение **«Большая»**), введите нужную опцию и выберите нужное значние в поле **«Значения опций вариантов»**.

<figure><img src="/files/PC7staWQkKjVgB00OVea" alt=""><figcaption><p>Ограничение заказов по значениям опции вариантов.</p></figcaption></figure>

### Сумма заказов

Условие **«Сумма заказов»** работает по аналогии с **«Количество оформленных заказов»**, только вместо количества учитывается сумма всех оформленных заказов.

Нужно учитывать, что это условие может работать по нескольким заказам. Например, если в поле **«Значение»** вы указали сумму **10 000 руб.**, то будут найдены как покупатели, которые оформили один заказ на эту сумму, так и покупатели, которые оформили несколько заказов на выбранную сумму.

Все остальные ограничения по периоду и товарам работают так же, как и в условии **«Количество оформленных заказов»**.

### Выручка по заказам

Это условие похоже на предыдущее, но оно не учитывает списанные бонусы. Например, если вы хотите найти покупателей, которые потратили 10 000 руб. без списания бонусов, вам пригодится именно это условие. Нужно отметить, что у этого условия нет дополнительных ограничений по товарам (только по периоду).

### Списанные бонусы

Условие, обратное предыдущему. Если вы хотите узнать, какие покупатели списали конкретное количество бонусов за период, воспользуйтесь этим условием.

### Город заказа

Если вы хотите найти покупателей, которые оформляли заказы в выбранном городе (или нескольких городах), воспользуйтесь этим условием.

### Точка продаж

Это условие поможет найти покупателей, которые оформляли заказы, привязанные к конкретной точке продаж (складу). Обратите внимание, что склад может быть привязан и к заказу на доставку, если у вас есть зоны доставки. В этом случае будут найдены все заказы с выбранными точками.

{% hint style="info" %}
**Пример**

Вы выбрали склад «Основной» в качестве значения условия «Точка продаж».

Покупатель оформил заказ на самовывоз из точки «Основной». Такой покупатель попадёт в сегмент.

У вас есть зоны доставки и одна зона («Центральная») привязана к складу «Основной». Покупатель оформил доставку и его адрес попал в зону доставки «Центральная». Из-за этого его заказ был связан со складом «Основной», поэтому он тоже попадёт в сегмент.
{% endhint %}

### Способ доставки и оплаты

Выберите эти условия, чтобы найти покупателей, которые оформляли заказы с указанными способами доставки или оплаты.

### RFM-параметры

Условия **«RFM: оценка давности заказа»** (R), **«RFM: оценка частоты заказа»** (F), **«RFM: оценка суммы заказов»** (M) и **«RFM: общий балл»** относятся только к покупателю, а не к его заказам. Вы можете добавить покупателей в сегмент либо по отдельным параметрам (например, если вам нужны покупатели с оценкой R3 и M2), либо по общей оценке (например, если вы хотите найти покупателей с общей оценкой 421).

### Баланс бонусов

Это условие поможет вам найти покупателей с определённым количеством бонусов. Например, покупателей с балансом бонусов больше 5000.

### Мобильное приложение

Условия **«Есть мобильное приложение»** и **«Операционная система устройства»** могут помочь вам найти покупателей, которые установили (или наоборот – не устанавливали) ваше приложение, либо покупателей на конкретных операционных системах (iOS или Android).

{% hint style="info" %}
Обратите внимание

Эти два условия могут создавать самые неполные списки покупателей. Мы получаем информацию об установках приложений (когда покупатели заходят в аккаунт из приложений), но не получаем (и не можем получать) информацию, когда покупатели удаляют приложения или отключают push-уведомления.

Например, покупатель может установить приложение и войти в аккаунт, тогда его профиль получит флаг «Есть мобильное приложение». Однако, если покупатель удалит приложение, сменит устройство или просто отключит пуш-уведомление, мы не сможем получить флаг «Нет мобильного приложения».

Учитывайте эту информацию при формировании сегментов по этим условиям.
{% endhint %}

### Дата рождения

Это условие поможет вам найти покупателей, чей день рождения попадает под ваши ограничения:

* покупатели, у которых день рождения приходится на конкретную дату («День и месяц»);
* покупатели, у которых день рождения приходится на конкретную дату и год («В дату»);
* покупатели, у которых день рождения приходится до конкретной даты и года («До даты»);
* покупатели, у которых день рождения приходится после конкретной даты и года («После даты»).

Например, дата рождения покупателя – 20 сентября 1991 года.

* Для условия «День и месяц» и значения «20.09» покупатель попадёт в сегмент (т.к. его дата рождения без года равна выбранной дате);
* Для условия «В дату» и значения «20.09.1991» покупатель попадёт в сегмент (т.к. его дата рождения с годом равна выбранной дате). При этом со значением «20.09.2005» покупатель в сегмент не попадёт;
* Для условия «До даты» и значения «01.01.1992» покупатель попадёт в сегмент, но для значения «01.01.1990» – уже нет;
* Для условия «После даты» и значения «01.01.1990» покупатель попадёт в сегмент, но для значения «01.01.1992» – уже нет.

## Комбинирование условий

Если вы создаёте сегмент с несколькими условиями, в большинстве случаев отбор будет происходить по условию «И». Однако, есть некоторые моменты, которые следует учитывать.

### Несколько одинаковых условий

Вы можете создать сегмент, используя несколько одинаковых условий в одной группе. Например:

* Количество оформленных заказов (за всё время): больше 0;
* Количетсов оформленных заказов (за 30 дней): равно 0.

В этом случае мы найдём покупателей, которые оформляли хотя бы один заказ за всё время, но не оформляли заказы за последние 30 дней.

### Несколько разных условий

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

* Способ доставки: самовывоз;
* Точка продаж: «Центральная».

Может показаться, что при таких условиях будут найдены покупатели, которые оформляли заказы на самовывоз именно из точки «Центральная». Однако, при таком наборе условий будут найдены покупатели, которые:

* оформляли заказы на самовывоз (из любой точки);
* оформляли заказы, которые были связаны с указанной точкой.

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


# RFM-параметры

Рассказываем об RFM-параметрах покупателей.

{% embed url="<https://drive.google.com/file/d/1b2S36qp2WZe0GaAFsuNfl7XIGmXH4NT1/view?usp=sharing>" %}

RFM (Recency, Frequency, Monetary) – общая оценка покупателей по трём показателям:

* как давно покупатель оформлял заказ;
* как часто покупатель оформляет заказы;
* сколько выручки принёс покупатель.

Каждый покупатель вашего магазина получает 3-значную оценку как только он оформляет первый заказ. По этим параметрам вы можете понять в какую категорию входит покупатель:

* лояльные покупатели;
* VIP-покупатели;
* новые покупатели;
* уходящие покупатели;
* неактивные покупатели.

У лояльных покупателей все параметры будут стремиться к 5 (555 – самые лояльные покупатели). У неактивных покупателей все параметры будут равны 1 – 111. У новых покупателей оценка будет зависеть от общей активности покупателей.

## Принцип оценки

Каждый покупатель получает оценки относительно всей остальной истории заказов вашего магазина. Каждый раз, когда у покупателя пересчитывается оценка, мы высчитываем его общие показатели, а затем сравниваем со всеми остальными покупателями. И так для каждого покупателя.

В итоге каждый покупатель помещается в «бакеты» по каждому параметру. Каждый «бакет» отражает:

* Оценка 5: покупатель входит в топ 20% покупателей по параметру;
* Оценка 4: покупатель входит в топ 40% покупателей по параметру;
* Оценка 3: покупатель входит в топ 60% покупателей по параметру;
* Оценка 2: покупатель входит в топ 80% покупателей по параметру;
* Оценка 1: покупатель входит в топ 100% покупателей по параметру.

## Отображение оценки

Вы можете увидеть RFM-оценки ваших покупателей в разделе [**«Продажи» – «Покупатели»**](https://my.zenky.io/dashboard/customers).

<figure><img src="/files/yET6eYr0aQVrBR8yFKDC" alt="" width="375"><figcaption><p>RFM-оценка покупателей.</p></figcaption></figure>

## Использование оценки

Оценка ваших покупателей (как общая, так и индивидуальная – по конкретным параметрам) может быть использована при [создании сегментов покупателей](/marketing/segments).


# Баннеры и сторис

Рассказываем о баннерах и сторис.

Если вы уже используете [новый шаблон сайта](/website/migration), вам доступна возможность создавать баннеры, не [зависящие от акций](/loyalty/promo) – мы называем их креативами.

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

Кроме этого, вам теперь доступны новые виды креативов: вертикальные баннеры и сторис.

{% embed url="<https://drive.google.com/file/d/1z6ICVmMs10RLxtG9_QwgWoxY19ZRUJCp/view?usp=sharing>" %}

## Типы креативов

Новые креативы делятся на три вида:

1. **Горизонтальные баннеры**. Это привычные баннеры на всю ширину сайта. То же самое, что вы использовали для акций, но теперь с возможностью загрузить версию баннера для мобильного сайта;
2. **Вертикальные баннеры**. Это баннеры с соотношением сторон 3:4, которые вы можете использовать для анонсов, не требующих большого фокуса от покупателей;
3. **Сторис**. Здесь вы можете загрузить до 10 слайдов в каждой сторис, а у каждого слайда может быть своё отдельное действие (например, добавить товар в корзину или применить промокод).

Кроме всего этого, каждый тип креатива поддерживает загрузку как фотографий, так и **видео**.

## Создание креатива

Чтобы создать новый креатив, перейдите в раздел [**«Маркетинг» -> «Баннеры и сторис»**](https://my.zenky.io/dashboard/creatives) в панели управления магазином и нажмите на кнопку **«Создать»**.

<figure><img src="/files/KjnDxRHOySI8NLWuoETq" alt=""><figcaption><p>Выбор типа креатива.</p></figcaption></figure>

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

В зависимости от выбранного типа вам будет доступно несколько полей для загрузки медиа-файлов.

### Горизонтальный баннер

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

<figure><img src="/files/nBHD27g4GZaC0120OJ9M" alt=""><figcaption><p>Ввод текста горизонтального баннера.</p></figcaption></figure>

{% hint style="info" %}
**Обратите внимание**

Расположение текста и описания баннера может меняться в зависимости от шаблона сайта. Добавляйте их, если ваш медиа-файл позволяет наложение текста в любом месте.
{% endhint %}

После этого вы можете выбрать медиа-файл для загрузки. По умолчанию вы можете выбрать изображение, но нажав на кнопку **«Видео MP4»**, вы переключитесь на режим загрузки видео. Сейчас мы поддерживаем только формат **MP4**, поэтому вам может потребоваться подготовить видео заранее (например, сконвертировать его из другого формата – например, **MOV**).

<figure><img src="/files/pRTxm4CFbrmtGgsVWzBg" alt=""><figcaption><p>Загрузка медиа-файла для горизонтального баннера.</p></figcaption></figure>

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

{% hint style="info" %}
**Обратите внимание**

Мы рекомендуем использовать размеры, указанные в поле загрузки изображения или видео. В противном случае ваши баннеры могут отображаться неправильно.

Ограничение по размерам в первую очередь связано с необходимостью быстрой доставки файлов покупателям – если размеры файлов видео-баннеров будут слишком большими, покупатели могут не дождаться их загрузки.
{% endhint %}

### Вертикальный баннер

Для вертикального баннера нужно загрузить только один файл – он используется как в десктопной версии, так и в мобильной версии. По аналогии с горизонтальными баннерами, вы можете использовать как изображения, так и видео.

<figure><img src="/files/Np0wq6IuoVuQSdn3mcWG" alt=""><figcaption><p>Загрузка медиа-файла для вертикального баннера.</p></figcaption></figure>

### Сторис

Сторис – это специальный тип креативов, который одновременно выступает как вертикальный баннер, так и как карусель из максимум 10 слайдов фото или видео.

Для начала вам нужно загрузить обложку – она должна иметь те же размеры, что и вертикальные баннеры (как для изображений, так и для видео).

<figure><img src="/files/ZcOAah3V5p3WPegSmUWT" alt=""><figcaption><p>Загрузка медиа-файла для обложки сторис.</p></figcaption></figure>

Обложка будет отображаться в одном списке с вертикальными баннерами, но при нажатии на неё будет открываться просмотр слайдов.

Загружать слайды нужно в отдельном поле. Там вы можете добавить до десяти файлов – каждый слайд может быть либо изображением, либо видео. Соотношение сторон должно быть 9:16.

<figure><img src="/files/aYWmYCxZvfKVHNJbuzqa" alt=""><figcaption><p>Интерфейс добавления слайдов в сторис.</p></figcaption></figure>

Нажмите на кнопку с иконкой «+», чтобы добавить новый слайд и выберите тип медиа.

<figure><img src="/files/eZQ5f472RKXkFR5WwepX" alt=""><figcaption><p>Выбор типа медиа-файла слайда сторис.</p></figcaption></figure>

Если у вас уже есть готовые файлы, перетащите их в область загрузки, чтобы загрузить несколько слайдов за раз.

{% embed url="<https://drive.google.com/file/d/1tBmgYrk8Z5ikAOTmHy-qeTaeO91h2xwo/view?t=1&usp=sharing>" %}
Добавление нескольких слайдов за раз.
{% endembed %}

После загрузки слайдов вы можете их перемещать, изменять или удалять.

{% embed url="<https://drive.google.com/file/d/1FTi1nAfYJKozyyBk4GxHJDcfjAUBmjv8/view?usp=sharing>" %}
Перемещение и удаление слайдов.
{% endembed %}

Каждому слайду можно назначить действие. Если это сделать, в нижней части появится кнопка действия, по нажатию на которую покупатель сможет сделать следующее:

* открыть ссылку;
* добавить товар в корзину;
* применить промокод.

{% hint style="info" %}
**Обратите внимание**

Если вы выбираете действие **«Применить промокод»**, не забудьте создать [акцию](/loyalty/rules) с таким промокодом.
{% endhint %}

Наведите мышь на любой слайд и нажмите на кнопку **«Действие»**, чтобы выбрать нужное действие.

{% embed url="<https://drive.google.com/file/d/1uCckII5aM_wKZOo23DQu2S1tL8Ef66qX/view?usp=sharing>" %}
Настройка действия «Открыть товар».
{% endembed %}

## Настройки креатива

Кроме медиа-файлов у креативов есть дополнительные настройки. Так, вы можете выбрать каналы продаж, в которых будет отображаться креатив, а также города (по умолчанию креативы показываются во всех городах).

В поле **«Каналы продаж»** выберите нужные каналы продаж, где должен отображаться текущий креатив.

{% hint style="info" %}
Обратите внимание

Сейчас креативы могут отображаться только в новом шаблоне сайта. Поддержка в приложениях появится ближе к концу лета.
{% endhint %}

<figure><img src="/files/z5KONsJLEjH3SWZafKnj" alt=""><figcaption><p>Выбор канала продаж.</p></figcaption></figure>

В поле **«Города»** выберите нужные города, где должен отображаться текущий креатив. Если вы хотите, чтобы креатив отображался везде, оставьте это поле пустым или выберите все доступные города.

<figure><img src="/files/2bLrHWtMMTuuUIoiDil5" alt=""><figcaption><p>Выбор города.</p></figcaption></figure>

## Действия креатива

Мы показали действия креативов на примере сторис. Для горизонтальных и вертикальных баннеров доступно действие **«Открыть ссылку»**. Это действие вызывается, когда покупатель нажимает на баннер.

Так, вы можете выбрать в качестве цели ссылки следующие элементы магазина:

* товар;
* категория;
* коллекция товаров;
* акция;
* статья;
* произвольная ссылка.

Чтобы назначить действие для баннера, в разделе **«Действие»** выберите **«Открыть ссылку»**.

<figure><img src="/files/SpFhMQXrB9DMLYPcPt9L" alt=""><figcaption><p>Настройка действия «Открыть ссылку».</p></figcaption></figure>

В поле **«Тип ссылки»** выберите нужный тип, а в **«ID ресурса»** начните вводить название и выберите нужное из выпадающего списка.

<figure><img src="/files/GgRdFhY22KK9GQ3H6I3i" alt=""><figcaption><p>Выбор цели ссылки.</p></figcaption></figure>

Вы также можете указать любую ссылку на другой сайт, выбрав тип **«Произвольная ссылка»** и вставив её в поле **«Ссылка»**.

<figure><img src="/files/Gao33p9lPws01J29AW12" alt=""><figcaption><p>Выбор произвольной ссылки.</p></figcaption></figure>

## Подключение креативов в конструкторе сайта

По умолчанию в новом шаблоне используются старые баннеры из акций. Чтобы переключиться на новые горизонтальные баннеры, откройте конструктор и на главной странице найдите раздел **«Главная / Порядок блоков»**, а в нём включите блок **«Горизонтальные баннеры»** и выключите блок **«Акции»**.

<figure><img src="/files/NTJzaN0MEHUHeoX6Wtvv" alt=""><figcaption><p>Подключение новых горизонтальных баннеров.</p></figcaption></figure>

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


# Push-кампании

Рассказываем о push-кампаниях в панели управления магазином.

Если у вашего магазина есть мобильное приложение, вы можете создавать push-кампании (рассылки) прямо из панели управления магазином. При этом вам по-прежнему доступны рассылки через [OneSignal](/push/start).

Основное отличие двух способов отправки уведомлений – в push-кампаниях вы можете выбрать сегмент, которому будут отправлены пуш-уведомления (в OneSignal вам доступна ограниченная функциональность по сегментации покупателей).

## Создание push-кампании

Для начала [создайте новый сегмент](/marketing/segments), а затем выберите его в форме [создания push-кампании](https://my.zenky.io/dashboard/push-campaigns) (раздел **«Маркетинг» / «Push-кампании»**).

<figure><img src="/files/HXxkx0Devm226bpd3BEE" alt=""><figcaption><p>Создание новой push-кампании.</p></figcaption></figure>

Разумеется, вы можете создать кампанию, нацеленную на всех покупателей. В этом случае в параметре **«Аудитория»** выберите опцию **«Все покупатели»**.

{% hint style="info" %}
**Обратите внимание**

Независимо от выбора аудитории, итоговое количество покупателей будет ниже, чем в сегменте или в списке покупателей. Это связано с тем, что мы добавляем в аудиторию кампании только тех покупателей (из всего списка или сегмента), которые ранее устанавливали приложение и разрешали получение push-уведомлений.
{% endhint %}

Далее вам нужно заполнить заголовок и текст кампании – эти поля обязательны и именно их увидят пользователи в своих уведомлениях.

При желании вы можете указать ссылку, на которую смогут перейти покупатели, и изображение, которое добавится к уведомлению (внешний вид будет зависеть от операционной системы устройства покупателя).

<figure><img src="/files/EhMlxJcA2C5UmR9opdfl" alt=""><figcaption><p>Заголовок, текст, ссылка и картинка push-уведомления.</p></figcaption></figure>

Отправка кампании может происходить в двух режимах – вручную после создания или автоматически по расписанию. Если вы хотите отправить уведомления прямо сейчас, оставьте переключатель **«Запланировать отправку»** выключенным.

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

<figure><img src="/files/IMUpYIfa1VQMhoXeNr86" alt=""><figcaption><p>Планирование отправки кампании.</p></figcaption></figure>

## Отправка уведомлений

Для отправки уведомлений либо дождитесь запланированного времени (уведомления будут отправлены автоматически, ничего дополнительно делать не нужно), либо нажмите на кнопку **«Отправить»** в правом верхнем углу блока с информацией о кампании.

<figure><img src="/files/yTmNv1fNVDq2LPVxyfPF" alt=""><figcaption><p>Блок с информацией о кампании.</p></figcaption></figure>

{% hint style="info" %}
**Обратите внимание**

Запланированные кампании можно отправить раньше времени, нажав на кнопку **«Отправить»**.
{% endhint %}

Отправка начнётся в течение нескольких секунд и может занять какое-то время (в зависимости от размера аудитории).

<div><figure><img src="/files/PDYkxzKe0ljVqV8lcQXl" alt=""><figcaption><p>Обычное состояние уведомления.</p></figcaption></figure> <figure><img src="/files/e8XsgGt7H7bUr7GWhPjv" alt=""><figcaption><p>Раскрытое состояние уведомления.</p></figcaption></figure></div>

## Статистика уведомлений

Информация об отправленных уведомлениях обновляется в течение 7 дней после рассылки, а открытия – до тех пор, пока кампания не будет удалена из панели управления магазином.

<figure><img src="/files/E0phVgyXqP72D63SGNEW" alt=""><figcaption><p>Статистика отправки push-уведомлений.</p></figcaption></figure>

**Аудитория** – это общее количество покупателей, которые попали под условия выборки. Здесь будет указано либо общее число покупателей на момент отправки (если кампания создавалась по всем покупателям), либо число покупателей в выбранном сегменте на момент отправки.

**Подписаны на Push** – это количество покупателей из общей аудитории, которые когда-либо устанавливали приложение и разрешали получение push-уведомлений. Если покупатель устанавливал приложение, а потом его удалил, он по-прежнему может попадать в это число.

**Принято в отправку** – это количество уведомлений, которые OneSignal отметил как принятые. Сюда попадают покупатели, которые находятся в базе OneSignal (при этом они могут быть неактивными).

**Отправлено на устройства** – это количество уведомлений, которые OneSignal расценил как корректные и переданные в Apple / Google на дальнейшую отправку. Чаще всего эта цифра близка к итоговому количество покупателей, но сюда по-прежнему могут попасть покупатели, которые запретили уведомления или удалили приложение.

**Открытия** – это гарантированно доставленные и прочитанные уведомления. Этот счётчик обновляется, если покупатель нажимает на уведомление или открывает его в разделе «Профиль» внутри приложения. Не пугайтесь, если в этой карточке очень низкий показатель – многие покупатели могут открывать приложение не по нажатию на уведомление, а по нажатию на иконку (в том числе через какое-то время после получения). К сожалению, мобильные операционные системы не позволяют связать такие открытия с конкретным уведомлением.

### На какие цифры опираться

Подсчёт доставленных уведомлений – очень сложная задача, т.к. ни iOS, ни Android не предоставляют каких-то точных метрик, по которым можно оценить гарантированно доставленные уведомления. Когда уведомление покидает OneSignal и отправляется в APN/Firebase (системы, которые используют Apple и Google для уведомлений), оно фактически попадает в "чёрный ящик", откуда очень сложно извлечь информацию.

Единственный способ точно узнать о прочтении – если пользователь нажимает на само уведомление и таким образом запускает приложение либо просматривает уведомление внутри самого приложения спустя какое-то время. Именно это количество покупателей мы показываем в карточке **«Открытия»**.

Чтобы примерно понять количество полученных уведомлений, возьмите число из карточки **«Отправлено на устройства»** и отнимите 10-20% от этого значения. Уведомления могут не придти, в том числе, в следующих случаях:

* Покупатель уже удалил приложение, но OneSignal ещё не отметил его подписку как неактивную и передал уведомление в Apple/Google;
* Покупатель отключил уведомления в настройках операционной системы, но OneSignal по каким-то причинам не получил эту информацию или ещё не обновил статус подписки на уведомления;
* У покупателя нет сети, выключен телефон или включен режим энергосбережения – в этих случаях уведомления либо будут доставлены позже, либо могут окончательно потеряться (зависит от операционной системы);
* Сервисы уведомлений (APN / Firebase) попросту не смогли отправить уведомления из-за внутренних проблем – такое тоже может быть.


# Push-рассылка через OneSignal

Отправка push уведомлений в приложения Zenky осуществляется через сервис OneSignal.

## Войти в аккаунт OneSignal

После регистрации вам нужно будет войти в акканут, нажав на главной странице кнопку `Sign In` и ввести емейл и пароль.

![Введите емейл и пароль](/files/-MbjV6cSsx5DgZiAIeO6)

## Добавить свое приложение

Нажать на кнопку `New App`

<figure><img src="/files/MuGvZYsHT52ZLVQbiBBV" alt=""><figcaption></figcaption></figure>

## Создать push-сообщение

Перед вами откроется страница с данными по вашему приложению. Для создания новой рассылки нужно нажать кнопку в правом верхнем углу `New Push`&#x20;

![](/files/-MbjKSuwnb-edXOYpkhJ)

## Выбрать аудиторию для рассылки

В открывшемся окне создания рассылки, вам потребуется выбрать аудиторию для рассылку. По умолчанию выбрана — `Все подписанные пользователи` Ее и будем использовать в первых рассылках.&#x20;

А в будущем, когда у вас будет большая аудитория, можно будет рассылать отдельным сегментам (активным, не активным, по геолокации, по количеству открытий приложения и пр)

![Выбираем первый пункт](/files/-MbjKj5G6-TFB73hM_OP)

## Ввести текст сообщения

Введите заголовок и короткий текст сообщения. Смотрите предпросмотр в правой части экрана и регулируйте длину сообщения, чтобы оно вошло полностью и не обрезалось. Также загрузите картинку, нажав кнопку `Upload`.&#x20;

![](/files/-MbjP31Etga1UGJbotPQ)

## Указать ссылку на контент

Чтобы по клику на пуш открывалось не просто приложение, а нужная страница акции, коллекции, категории или товара, нужно указать ссылку на акцию или товара на вашем сайте.

Работает это так. Клиент кликнет на пуш, после этого система направит его на ваш сайт. А ваш сайт связан диплинками с приложением. Таким образом вместо сайта у клиента откроется приложение на той странице, на которую указывала ссылка. Посколько содержание сайта и приложения асбсолютно идентичное.&#x20;

Для этого кликаем на **`Advanced Settings`** и в развернувшемся окне **Additional data** в поле **Field 1** вводим текстом **`data`** и адрес акции или товара на вашем сайте (который сделан на платформе Zenky).

Пример:

* data&#x20;
* <https://yarollov.ru/offers/9a7f427c96f5d8fb/monstry-na-progulke-specialno-k-xellouin>

<figure><img src="/files/FZBvAN7S6BashcpHHNVl" alt=""><figcaption><p>Ссылка на акцию или товар на вашем сайте</p></figcaption></figure>

Для корректной работы этой ссылки, нужно настроить диплинки на сайте.

## Выбрать время и послать сообщения

В самом нижнем блоке, выбрать немедленную `Immediately` отправку или отложенную ко времени `Specific time` и нажать кнопку `Review and Send`. После нажатия кнопки откроется окно с текстом сообщения для проверки, что все верно заполнено. Если ошибок нет, то нажимаем повторно `Send` и сообщения будут отправлены.

![](/files/-MbjTyOiIkiFtZEwjKNS)

## Следите за статистикой после отправки

После отправки рассылки вас перенаправит на статистику, где вы сможете в режиме реального времени смотреть

* количество отправленных сообщений
* количество открытых сообщений
* количество кликов
* Процент открытия пушей
* Статистику по iOS, Android
* Количество отписок от рассылки

![](/files/-MbjX66vWezoPhDLPXBS)

![](/files/-MbjXGxXKlg-4cKtJiQb)


# Push-уведомления о смене статуса заказа

Узнайте, как подключить push-уведомления о смене статуса заказа.

Если ваш магазин использует мобильное приложение с версией 2.0 или выше, вы можете подключить push-уведомления о смене статуса заказа через сервис OneSignal.

## Настройка API OneSignal

Для того, чтобы и приложение, и наш сервер могли работать с OneSignal, вам потребуется указать идентификатор приложения OneSignal (App ID) в конструкторе приложения. Так же необходимо указать этот же App ID и ключ REST API (REST API Key) в настройках уведомлений магазина.

App ID и REST API Key можно найти в вашем аккаунте OneSignal.

<figure><img src="/files/U6bxPtLmZ6tfRmTzvpnK" alt=""><figcaption><p>Раздел с информацией о приложении в интерфейсе OneSignal.</p></figcaption></figure>

### Настройка приложения

В панели управления магазином найдите ваше приложение в боковом меню слева. Выберите раздел **«Конструктор»** и перейдите в него.

В интерфейсе конструктора выберите раздел **«Интеграции»** и введите идентификатор вашего приложения в поле **Клиентский API ключ OneSignal**, предварительно выбрав **OneSignal** в выпадающем списке **Провайдер пуш уведомлений**. Сохраните настройки.

<figure><img src="/files/jlZAc4q6Sy64XGMUk5En" alt=""><figcaption><p>Редактирование интеграции push-уведомлений в конструкторе приложения.</p></figcaption></figure>

### Настройка уведомлений заказов

Перейдите в раздел **«Магазин»** -> **«Настройки заказов»** и найдите раздел **«Уведомления»**.

В этом разделе включите настройку **«Подключить пуш-уведомления OneSignal»**. Далее введите App ID в поле **«ID приложения OneSignal»** и ключ REST API в поле **«Ключ REST API приложения OneSignal»**. Сохраните настройки.

<figure><img src="/files/hxHGE7SqsIZHLBmfBWCV" alt=""><figcaption><p>Редактирование настроек уведомлений заказов.</p></figcaption></figure>

## Настройка статусов заказов

Теперь вам нужно отредактировать каждый статус заказа, для которого вы хотите подключить push-уведомления.

Перейдите в раздел **«Продажи»** -> **«Статусы заказов»** и откройте редактирование нужного статуса заказа.

{% hint style="info" %}
Push-уведомления недоступны для статусов заказов с типом **«Ожидание»**, **«Ожидание оплаты»**, **«Новый»** и **«Экспортирован»**.
{% endhint %}

В разделе **«Пуш-уведомления»** включите отправку, переключив настройку **«Отправлять пуш-уведомления»**, и введите текст сообщения, которое будет отправлено покупателю.

<figure><img src="/files/8WLVFQiAvK9HjU7dDUVv" alt=""><figcaption><p>Настройка push-уведомления для статуса заказа.</p></figcaption></figure>

В тексте сообщения вы можете использовать специальные подстановки `:order` и `:status`, которые будут заменены на номер заказа и название статуса заказа соответственно.

{% hint style="info" %}
Например, если вы введёте текст «Ваш заказ **:order** подтверждён!», то покупателю будет отправлено сообщение «Ваш заказ **№2306-100** подтверждён!», где «№2306-100» – настоящий номер заказа.

Другой пример – текст «Статус вашего заказа **:order** изменился на **:status**.» будет заменён на «Статус вашего заказа **№2306-100** изменился на **Подтверждён**», где «№2306-100» – настоящий номер заказа, а «Подтверждён» – название статуса заказа.

При использовании этих подстановок не забудьте про **двоеточие**, которое должно идти **слитно** вместе с названием подстановки (`:order` и `:status`).
{% endhint %}

Эту операцию нужно проделать с каждым статусом, который должен отправлять push-уведомления.

Статусы заказов, для которых подключены push-уведомления, будут отмечены иконкой колокола.

<figure><img src="/files/J4FZERh2U2bbUnlUVhwp" alt=""><figcaption><p>Список статусов заказов с отметкой push-уведомлений.</p></figcaption></figure>

## Если push-уведомления не приходят

1. Убедитесь, что вы указали правильный идентификатор приложения OneSignal (в конструкторе приложения и в настройках заказов магазина) и ключ REST API (в настройках заказов магазина);
2. Убедитесь, что для конкретного статуса заказа подключена отправка push-уведомлений;
3. Для получения push-уведомлений покупатель должен войти в свой аккаунт в вашем приложении, а так же разрешить получение push-уведомлений от вашего приложения.


# Подключение SMSC.RU

## Самостоятельная регистрация на SMSC.RU

Самое главное что нужно учесть при самостоятельной решистрации, это то, что обязательно нужно регистрироавть короткое имя отравителя для смс. Без имени отправителя смс не будут уходить.

Сервис не предоставляет свои имена больше. Теперь нужно самостоятельно регистрировать имена у каждого провайдера.&#x20;

Теле2, Билайн дадут вам бесплатно использовать имена отправителя. Но МТС и Мегафон требует ежемесячную оплату по 2000 руб. А также требуют заключения договора с smsc.ru и предоставление заявления на использование желаемого имени.

Договор и скан заявления можно подгрузить в разделе [«Настройки - Имена отправителей»](https://smsc.ru/senders/)

Процесс получения своего имени достаточно трудоемкий. Если вам не хочется заключать договор, писать заявления, то вы можете использовать наше имя ZENKY.

## Регистрация через Zenky

Для использования нашего имени отправителя бесплатно, нужно написать нам в техподдержку (чат в админке) запрос на регистрацию суб-аккаунта для вас с указанием следующих данных:

1. Название вашей организации
2. Емейл
3. Телефон
4. Желаемый логин

Мы зарегистрируем вам аккаунт и передадим логин и пароль, который вам нужно будет указать в разделе настроек «Магазин - SMS»

<figure><img src="/files/4ATi4O9RDg4IKJ8xmQDe" alt=""><figcaption></figcaption></figure>


# Создать аккаунт в OneSignal

## Создать аккаунт в Onesignal

Перейти на сайт <https://onesignal.com>. Создать аккаунт, нажав кнопку `"Sign Up"`

<figure><img src="/files/ve4GMwZEISwRxlxOUuyE" alt=""><figcaption></figcaption></figure>

Далее ввести емейл, пароль и название компании. Нажать на кнопку `Create Account`

<figure><img src="/files/1RFrInl9wdcsXRnVKF7C" alt=""><figcaption></figcaption></figure>

## Добавить свое приложение

Нажать на кнопку `New App`

<figure><img src="/files/MuGvZYsHT52ZLVQbiBBV" alt=""><figcaption></figcaption></figure>


# Пригласить пользователя в OneSignal

Чтобы дать дополнительный доступ сотруднику, пригласите его в систему по этой инструкции

## Отправить приглашение

Зайти в разлел `Setting` и далее в подраздел `Roles` и нажать на кнопку `Invite to App`

<figure><img src="/files/Ktq2ZMg1E8fCLcMnSB1K" alt=""><figcaption></figcaption></figure>

В окне ввести емейл сотрудника. Ему будет отправлено письмо с приглашением. Которое он должен принять и войти в OneSignal.

<figure><img src="/files/5L5riUujv2wHh9OAsI68" alt=""><figcaption></figcaption></figure>

## Принять приглашение

На указанный вами email придет сообщение от OneSignal, в котором нужно нажать кнопку `Accept Invitation`

![](/files/-MbjIf-C-NTz5PM_vydS)

## Создать пароль

Вас перенаправит на страницу создания пароля. Нужно придумать пароль и ввести его два раза. Пароль должен быть более 8 символов в длину и не должен быть простым типа qwerty123. Система будет проверять пароль на сложность и наличие такого пароля в открытых базах данных украденных паролей. Если система выдаст ошибку, то нужно придумать более сложный пароль.

![](/files/-MbjJP1de9aDdsmP1MRi)

## Войти в аккаунт OneSignal

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

![Введите емейл и пароль](/files/-MbjV6cSsx5DgZiAIeO6)

##


# Добавление OneSignal в Google

После того, как вы [создали аккаунт в OneSignal](https://help.zenky.io/push/create-onesignal) и [пригласили нужных пользователей](https://help.zenky.io/push/invite-onesignal), необходимо зарегистрироваться с гугловской почты на сервисе <https://firebase.google.com/>.&#x20;

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

<figure><img src="/files/8Q69bSaHxRLIOIicBGMo" alt=""><figcaption></figcaption></figure>

Далее жмем `Go to console` тоже в правом верхнем углу и попадаем в рабочее пространство, жмем на `Create a proect`

<figure><img src="/files/IYzTvmCc6B1KKinQVpqd" alt=""><figcaption></figcaption></figure>

Проходим три шага по первичной настройке вашего приложения, сначала даем ему название:

<figure><img src="/files/idtn7rdDgpZEZZec1cAk" alt=""><figcaption></figcaption></figure>

Во втором шаге кликаем `Continue`

<figure><img src="/files/w5C9qZvujO0Nl5fNwebh" alt=""><figcaption></figcaption></figure>

В третьем шаге создаем свой собственный аккаунт и называем его&#x20;

<figure><img src="/files/pF4BW52rdd7aelCxRfNF" alt=""><figcaption></figcaption></figure>

Выбираем страну, прокликиваем галочки и жмем на `Create project`

<figure><img src="/files/tllKsxbNALlZCdRCtbRc" alt=""><figcaption></figcaption></figure>

Ждем пока проект создастся и кликаем `Continue`

<figure><img src="/files/yXMoGCoYzBSmpZ3Z67pI" alt=""><figcaption></figcaption></figure>

Теперь кликаем на шестеренку и идем в настройки проекта

<figure><img src="/files/DoS6TKuZs68Y8fWZNrMX" alt=""><figcaption></figcaption></figure>

Далее вкладка `Users and Permissions`, где мы можем пригласить к управлению проектом нужных нам людей по их почтам

<figure><img src="/files/zQS7X6syT3rvJc2x3l3I" alt=""><figcaption></figcaption></figure>

После этого идем во влкадку `Cloud Messaging`  и проверяем, чтобы стояла галочка и имелся Sender ID

<figure><img src="/files/jX5A0kYFCnMo0WycS5XA" alt=""><figcaption></figcaption></figure>

Теперь можем отправляться во влкадку `Service Accounts`, где нам надо поставить node.js и сгенерировать ключ

<figure><img src="/files/l6CJzhRMN0FpDENJLnmK" alt=""><figcaption></figcaption></figure>

После того как скачали файл ключа, идем в `OneSignal - Settings - Platforms` и кликаем на кнопку `Activate` под Google Android (FCM)

<figure><img src="/files/F9Uwqd6Qkjlqt52Efkz9" alt=""><figcaption></figcaption></figure>

Вставляем только скачанный нами файл, проверяем что добавился именно он, и жмем `Save & Continue`

<figure><img src="/files/Sd9o6wP9aDxyYXl2OttM" alt=""><figcaption></figcaption></figure>

В следующем окне выбираем `Flutter`, затем `Save & Continue`

<figure><img src="/files/xghk0EEGSf1nao0bGfnC" alt=""><figcaption></figcaption></figure>

Поздравляем! Вы получили ID приложения OneSignal! Копируем его, затем жмем кнопку `Done`, и отправляемся в админку своего магазина по адресу [my.zenky.io](https://my.zenky.io/). Затем идем в `Конструктор приложения - Интеграции`. Выбираем OneSignal в качестве провайдера push-уведомлений, и вставляем наше ID в соответствующую строку

<figure><img src="/files/Y45R8vpcfKw5Zhs9osOq" alt=""><figcaption></figcaption></figure>

Этот же айди вставляется для [уведомлений о смене статуса заказа](https://help.zenky.io/push/order-statuses)


# Добавление OneSignal в Apple

После того, как вы [создали аккаунт в OneSignal](https://help.zenky.io/push/create-onesignal) и [пригласили нужных пользователей](https://help.zenky.io/push/invite-onesignal), необходимо пройти по адресу [developer.apple.com](https://developer.apple.com/) и войти в аккаунт&#x20;

<figure><img src="/files/Ck26sXFDlAbrvZdsyYEH" alt=""><figcaption></figcaption></figure>

Затем идем в Keys и регистрируем новый ключ

<figure><img src="/files/YxYZ9NCosModkz4LSnqY" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/SIU03p9795zs8P2TqW43" alt=""><figcaption></figcaption></figure>

Называем его так, чтобы потом отличить от остальных ключей, например magazinpush, прожимаем галочку внизу и `Continue`

<figure><img src="/files/7LQ0gfS9rmztIFlRJpKr" alt=""><figcaption></figcaption></figure>

Жмем `Register`

<figure><img src="/files/W4LdFI7x30bLw2VfCsDX" alt=""><figcaption></figcaption></figure>

А затем - `Download` и загружаем файл ключа, заодно копируем ваш Key ID - скоро будем его вставлять

<figure><img src="/files/k99IDftBuNpXCdzvhcVK" alt=""><figcaption></figcaption></figure>

Теперь возвращаемся в OnaSignal и жмем кнопку `Activate` под `Apple iOS (APNs)`

<figure><img src="/files/ldxpgnbxAM824jaobMp0" alt=""><figcaption></figcaption></figure>

Загружаем только что скачанный файл

<figure><img src="/files/7xXvYXxV0EoW9TOIIJKW" alt=""><figcaption></figcaption></figure>

Вставляем Key ID, который копировали пару шагов ранее и Team ID, который можно взять вот здесь

<figure><img src="/files/POJHgQgirtbD1PJdpw4J" alt=""><figcaption></figcaption></figure>

Осталось вставить только bundle ID нашего приложения. Найти его можно в [appstore.connect](https://appstoreconnect.apple.com) в разделе информации о вашем приложении

<figure><img src="/files/JSsY9Iu4DtHEacNGNcyT" alt=""><figcaption></figcaption></figure>

Когда все вставили - жмем `Save & Continue`

<figure><img src="/files/EhyKM1dJlxlF9u69cx3M" alt=""><figcaption></figcaption></figure>

Теперь выбираем `Flutter` и снова `Save & Continue`

<figure><img src="/files/tLkDb4LBLeYX0q7YDoo7" alt=""><figcaption></figcaption></figure>

Проверяем, что все у нас заработало

<figure><img src="/files/8ym95ETBYEnnAvhgqjtO" alt=""><figcaption></figcaption></figure>

Теперь и идем в `Settings`, `Keys & IDs` и копируем `OneSignal App ID` (он такой же как и для Google) и `Rest API Key`. Эти два ключа - все что вам потребуется для успешной интеграции нашей админки с сервисом One Signal

<figure><img src="/files/IBTfQirQ29X9V8vVabZO" alt=""><figcaption></figcaption></figure>


# Переход на новый шаблон

Рассказываем, как перейти на новый шаблон сайта.

Начиная с 8 июня 2026 года всем магазинам доступен новый шаблон сайта. Этот шаблон работает независимо от вашего текущего сайта, поэтому вы можете создать новый канал продаж для тестирования, не нарушая работу основного сайта, а затем переключиться на новый дизайн, когда вам будет удобно.

Вкратце, для перехода на новый шаблон вам нужно будет выполнить эти шаги:

1. Создать новый сайт с новым шаблоном;
2. Указать в настройках нового сайта ваш домен;
3. **Изменить у регистратора домена IP-адрес сайта\*;**
4. Подключить аналитику и запустить сайт.

*Мы можем сделать за вас все шаги кроме третьего – доменом владеете только вы, поэтому изменять IP-адрес придётся самостоятельно (но если будут проблемы, всегда пишите в техподдержку – постараемся помочь).*

### Создание нового сайта

{% hint style="info" %}
Пропустите этот шаг, если наши сотрудники уже создавали для вас демо-магазин.
{% endhint %}

Чтобы перейти на новый дизайн, вам нужно создать новый канал продаж **«Сайт»**. Изменить шаблон текущего сайта на новый не получится.

На любой странице панели управления магазином нажмите на кнопку **«Сайт и приложение»** (текст может быть другим, например только **«Сайт»**) в верхней части экрана, а в открывшемся меню нажмите на кнопку **«Новый канал продаж»**, которая расположена в правой нижней части.

<figure><img src="/files/dtaYevc6vuWYsUUjv2Tu" alt=""><figcaption><p>Меню каналов продаж.</p></figcaption></figure>

На новой странице выберите **«Сайт»**.

<figure><img src="/files/MW9CPNT4JIIgR6CSeTw2" alt=""><figcaption><p>Страница выбора создания канала продаж.</p></figcaption></figure>

Далее вам нужно будет выбрать домен третьего уровня, по которому всегда будет доступен ваш сайт. Вы можете использовать его на время тестирования и настройки.

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

<figure><img src="/files/dId9GJIkkX4KTCC57kGS" alt=""><figcaption><p>Форма создания нового сайта.</p></figcaption></figure>

При необходимости вы можете защитить ваш сайт логином и паролем – так вы сможете временно оградиться от поисковых систем, чтобы они не начали индексировать ваш новый сайт, пока вы не будете уверены в запуске.

Для этого включите переключатель **«Защита паролем»**, а затем укажите на латинице логин и пароль. Эти данные нужно будет вводить при первом входе на сайт.

{% hint style="info" %}
Так как после запуска ваш сайт по-прежнему будет доступен по домену третьего уровня, для второстепенного домена мы отдаём заголовок \`X-Robots-Tag: noindex, nofollow\`, чтобы поисковые системы не использовали этот домен и не показывали его в поисковой выдаче.&#x20;
{% endhint %}

#### Режим www

С новым шаблоном вы можете настроить работу поддомена [www](http://www). Поддерживаются следующие значения (здесь мы используем домен `example.org` в качестве примера):

* **«Перенаправлять на www»**. В этом случае открытия сайта по домену `example.org` будут перенаправлены на `www.example.org`;
* **«Перенаправлять без www»**. В этом случае открытия сайта по домену `www.example.org` будут перенаправлены на `example.org`;
* **«Не перенаправлять»**. В этом случае будет доступен только домен `example.org`.

### Подключение домена

Если вы не указывали домен в момент создания сайта, вы всегда можете добавить его, перейдя в редактирование канала продаж. Для этого откройте меню **«Сайт и приложение»** в верхней части любой страницы, выберите пункт **«Все каналы продаж»**, а затем нажмите на название «**Zenky 2.0**».

<figure><img src="/files/KLCZbvRLpxgIBb5eSUqo" alt=""><figcaption><p>Список каналов продаж.</p></figcaption></figure>

На открывшейся странице найдите поле **«Домен»**. Введите имя вашего домена, сохраните настройки и обновите страницу, чтобы увидеть инструменты управления доменом.

<figure><img src="/files/c0XiohtfexOZGlcgSd7Q" alt=""><figcaption><p>Инструменты управления доменом.</p></figcaption></figure>

Чтобы ваш сайт начал открываться по вашему адресу, нужно изменить DNS-записи в панели управления регистратора вашего домена (компания, где вы купили ваш домен, например Reg.RU). Там вам нужно найти управление DNS и в качестве A-записи для корневого и www-доменов указать IP-адрес `5.42.119.219`.&#x20;

{% hint style="info" %}
Чтобы домен подключился успешно, убедитесь, что вы добавили как корневую запись домена (например, `example.org),` так и **www**-поддомен – `www.example.org`. Если этого не сделать, домен может не подключиться.
{% endhint %}

Если у вас уже есть сайт на Zenky и вы переходите на новый шаблон, скорее всего у вас уже есть A-запись, которая указывает на IP-адрес `84.252.131.0` – вам нужно заменить его на `5.42.119.219.`

{% hint style="danger" %}
Чтобы избежать проблем в выдачей SSL-сертификата, убедитесь, что у вас нет лишних **A-** или **AAAA**-записей, которые относятся к основному домену и поддомену **www**. Если они есть, удалите их, иначе SSL-сертификат может не выдаться.
{% endhint %}

В статье [**«Домен для сайта»**](/website/domains) есть ссылки на статьи популярных регистраторов доменов, которые могут помочь с настройкой DNS. Если вам нужна помощь, напишите в ваш чат или в чат техподдержки на сайте.

{% hint style="info" %}
**Проверка домена**

Мы будем проверять DNS-записи вашего домена автоматически с разной периодичностью. Если в течение 24 часов мы не сможем проверить изменения DNS, вам придётся написать в ваш чат или в чат техподдержки в панели управления магазином, чтобы мы проверили изменения вручную.
{% endhint %}

После того, как вы измените DNS-записи и они успешно обновятся, поле управления доменом должно измениться на такой вид:

<figure><img src="/files/4qm5MQ7dtJfsM6NRoS4C" alt=""><figcaption><p>Успешный результат подключения домена.</p></figcaption></figure>

Если ваш домен не подключается спустя 72 часа после изменения DNS-записей или вы увидите ошибку проверки DNS в этом поле, напишите в ваш чат или в чат техподдержки в панели управления магазином. Перед обращением убедитесь, что добавили правильные записи.

### Конструктор сайта

В конструкторе сайта с новым дизайном изменились все настройки. Вам нужно будет заново настроить цвета и параметры страниц. Мы постарались добавить как можно больше объяснений для каждой настройки, чтобы вы смогли настроить новый шаблон так, как вам нужно.

### Доступ к новому конструктору сайта

Вы можете заметить, что при выборе пункта **«Конструктор сайта»** в меню **«Сайт и приложение»** открывается конструктор текущего / старого сайта. Пока вы не перешли на новый шаблон, доступ к новому конструктору можно получить так:

1. В меню **«Сайт и приложение»** выберите пункт **«Все каналы продаж»**;
2. В открывшемся списке нажмите на название **«Zenky 2.0»**;
3. На следующей странице выберите вкладку **«Конструктор»**.

<figure><img src="/files/2nFH6mMSrUS22HSqIO10" alt=""><figcaption><p>Переход к конструктору нового шаблона.</p></figcaption></figure>

Чтобы всегда попадать в конструктор нового шаблона, прочтите раздел [**«Обновление верхнего меню»**](#obnovlenie-verkhnego-menyu) ниже.

### Страницы и служебные файлы

В старом шаблоне вы могли создавать **«Страницы»**, которые по факту являлись текстовыми файлами и в основном использовались для подтверждения различных сервисов.

В новом шаблоне мы переработали и переименовали разделы. Предыдущая функциональность файлов теперь доступна в разделе **«Служебные файлы»**. А **«Страницы»** превратились в контентные страницы, которые отображаются в интерфейсе сайта – с их помощью вы сможете создавать дополнительные разделы с произвольным контентом.

#### Специальные страницы

В новом шаблоне есть несколько специальных страниц, для которых вы можете задать свой текст. К таким страницам относятся:

* **«О нас»**;
* **«Доставка и оплата»**;
* **«Контакты»**.

Выберите нужный тип при создании новой страницы.

<figure><img src="/files/qq1xT8DYVFJvGuh6p8o7" alt=""><figcaption><p>Создание контентной страницы.</p></figcaption></figure>

У таких страниц нет настройки пути, поэтому их адресами управлять не получится. Если же вы хотите создать страницу с произвольным адресом, выберите тип **«Своя страница»** и укажите нужный путь.

{% hint style="warning" %}
Обратите внимание

Если вы создадите свою страницу с адресом, который уже зарезервирован (например, `/catalog`), на сайте по-прежнему будет отображаться встроенная страница, а не та, которую свы создали.
{% endhint %}

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

### Сниппеты

Мы поменяли работу сниппетов (CSS/JS), поэтому вам придётся создать новые сниппеты для сайта с новым дизайном. Обратите внимание: если вы использовали сниппеты для модификаций сайта (например, меняли цвет шрифта или перемещали блоки), старый код не будет работать на новом дизайне. Если вам нужна своя модификация нового шаблона, напишите в ваш чат или в чат техподдержки в панели управления магазина – мы подскажем что делать в вашем случае (обратите внимание, что такие доработки могут быть платными).

### Аналитика

В старом шаблоне аналитика (в частности, Яндекс.Метрика) настраивалась внутри конструктора. Мы поменяли подход и теперь сервисы аналитики подключаются через раздел [«Интеграции»](https://my.zenky.io/dashboard/marketplace).

<figure><img src="/files/aV08kStkhsgs5pzMtbf5" alt=""><figcaption><p>Раздел «Аналитика» в интеграциях Zenky</p></figcaption></figure>

На данный момент доступны сборщик UTM-меток и интеграция с Яндекс.Метрикой, но в ближайшее время мы добавим дополнительные сервисы (например, Пиксель VK Рекламы) и будем постоянно расширять этот раздел, в том числе и по вашим запросам.

Для подключения Яндекс.Метрики вам потребуется номер вашего счётчика – его можно узнать на главной странице Яндекс.Метрики или внутри кабинета конкретного счётчика.

<figure><img src="/files/HMApue5gIKqmsMd9RIjL" alt=""><figcaption><p>Настройки интеграции с Яндекс.Метрикой</p></figcaption></figure>

Новая интеграция с Яндекс.Метрикой отправляет данные о клиенте вместе с оформлением заказа. Вы можете увидеть их на странице заказа в панели управления магазином.

<figure><img src="/files/AkDzuuE2LIoM732o5ztX" alt=""><figcaption><p>Информация от Яндекс.Метрики на странице заказа.</p></figcaption></figure>

Эти данные также будут доступны в API.

### Обновление верхнего меню

Вы можете заметить, что даже после создания нового сайта, ссылки в верхнем меню «Сайт и приложение» ведут на старый сайт. Чтобы исправить это, перейдите в раздел [**«Магазин» / «Каналы продаж»**](https://my.zenky.io/dashboard/store/profile/settings/sales-channels) и в разделе **«Сайт»** выберите веб-сайт по умолчанию. У вашего нового сайта будет название **«Zenky 2.0»**.

<figure><img src="/files/bbf5oXqwtXN7JcUyMurX" alt=""><figcaption><p>Изменение сайта по умолчанию.</p></figcaption></figure>

Сохраните настройки и обновите страницу – верхнее меню теперь будет использовать новый сайт.


# Конструктор сайта

Как пользоваться конструктором сайта

1. [Подготовка](https://help.zenky.io/website/builder/podgotovka)
2. [Настройка главной страницы](https://help.zenky.io/website/builder/nastroika-glavnoi-stranicy)
3. [Настройка второстепенных страниц](https://help.zenky.io/website/builder/nastroika-vtorostepennykh-stranic)
4. [Глобальные настройки](https://help.zenky.io/website/builder/globalnye-nastroiki)
5. [Визуальное оформление](https://help.zenky.io/website/builder/vizualnoe-oformlenie)


# Подготовка

Для начала необходимо создать Канал продаж и назвать его "Сайт". Для этого кликаем на зеленую кнопку в левом верхнем углу админки и кликаем "Создать сайт"

<figure><img src="/files/IuwrlvEnbqUesSGL6CKI" alt=""><figcaption></figcaption></figure>

Перед нами откроется интерфейс создания нового канала продаж. Называем его "Сайт" и в поле "Короткий адрес" вписываем название своего магазина латиницей. Это будет адрес вашего сайта. Если у вас есть собственный домен - можете вписать и его адрес в последнюю строчку, после чего будет необходимо внести А-запись по [инструкции](https://help.zenky.io/website/domains#kupit-domen-i-nastroit-ego).

<figure><img src="/files/UN8ayLkuUMlwsmGNcQtv" alt=""><figcaption></figcaption></figure>

Жмем кнопку "Сохранить" и видим созданный канал продаж.&#x20;

<figure><img src="/files/jzzfbgUk1zQUhs5xAW0V" alt=""><figcaption></figcaption></figure>

Теперь нам открылся доступ к конструктору сайта

<figure><img src="/files/PRPhjyLSbevVxLRfARtI" alt=""><figcaption></figcaption></figure>

### **Видео инструкция**

{% embed url="<https://youtu.be/lJC4iUgTe48>" %}


# Настройка главной страницы

## 1. Промоблок

В этом разделе мы можем настроить отображение(скрыть или отображать) и характеристики промоблока. Заголовок, подзаголовок, настроить текст кнопки каталога товаров и ее отображение (скрыть или отображать), а также вставить картинку для фона.

<figure><img src="/files/ZafA5hDLvAUfKqgkvzM9" alt=""><figcaption></figcaption></figure>

## 2. Преимущества

<figure><img src="/files/db2KuMuW6cyaRzQL2yoR" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/2usv12lDKkAxtXx2fKqt" alt=""><figcaption></figcaption></figure>

Кликнув на кнопку "Список", можно задать количество преимуществ, их описание, заголовок и картинку

## 3. Акции&#x20;

В данном блоке мы можем настроить отображение [Акций, которые мы добавили в разделе Лояльность в Админке](/loyalty/promo).

<figure><img src="/files/RNSo2QZT7NuY4X9LAXMe" alt=""><figcaption><p>Можно добавить заголовок и краткое описание акции на картинку, а также задать порядковый номер. 1 - означает, что данный блок будет располагаться на главной странице первым по порядку.</p></figcaption></figure>

Затем можно настроить вид отображения акционных баннеров. Широкий - это как на изображении сверху, или Карточки, как на изображении снизу (В случае Широкого рекомендуется загружать изображение баннеры размером 1200х500, в Случае карточек - 1200х740 или еще большей высоты)

<figure><img src="/files/NcLvWnGnGuA4vAserXwC" alt=""><figcaption><p>Также, для варианта Широкий рекомендуется задать соотношение сторон 12 на 5. Яркость лучше ставить в районе 90%</p></figcaption></figure>

В последних трех графах блока можно скрыть или отобразить сам блок, задать порядок отображения акций, т.е. сначала показывать старые или недавно добавленные акции, либо вовсе вручную задать их очередность. А также выбрать вариант отображения слайдера - карточкой с аккуратными закруглениями, или картинкой во всю ширину вашего экрана.<br>

<figure><img src="/files/j6vnHTbiHxRm07yIHwH6" alt=""><figcaption></figcaption></figure>

## 4. Товары

Затем можем отобразить какую-либо коллекцию товаров, и настроить количество отображаемых товаров из нее.&#x20;

<figure><img src="/files/VfPZPpMKtQqK2RroD1co" alt=""><figcaption></figcaption></figure>

В графе "Коллекция" выбираем коллекцию. товары из которой хотим отразить

В графе "Заголовок" вписываем название коллекции, либо фразу которая будет озаглавливать данный блок на главной странице

Графой "Кол-во товаров" - задаем количество отображаемых товаров, либо выбираем "Все товары", поставив "-1"\
Порядковым номером задаем очередность отображения данного блока\
В последней графе можно скрыть, либо отобразить блок "Товары"

## 5. Обратная связь

<figure><img src="/files/ie8UtDtwzjUqbNXVL1iK" alt=""><figcaption></figcaption></figure>

В этом блоке пользователи оставляют свои пожелания и вопросы.

С помощью граф настройки мы можем поменять любой текст в блоке, а также включить/выключить его отображение на странице и задать порядковый номер, т.е. порядок отображения на сайте.

## 6. Категории

С помощью этого блока можно вывести на главную страницу категории ваших товаров.

<figure><img src="/files/VFnvFXizrg6jRrpLpur0" alt=""><figcaption></figcaption></figure>

Аналогично предыдущим блокам, здесь мы можем задать порядок отображения блока на главной странице, включить/выключить этот блок, а также включить/выключить отображение названий категорий.

<figure><img src="/files/dJQXwj8Ijt33ktu3gnbt" alt=""><figcaption></figcaption></figure>

Можно отображать как все имеющиеся в каталоге категории, так и создать выборочный список категорий.

## 7. SEO

Заполнение данного блока помогает вашему сайту быстрее находиться в поисковиках.![](/files/uJhb8cX9xQo2V1UCui7M)

В заголовок и описание можно добавить ключевые слова для поиска, а после загрузки изображения - оно будет вылезать в качестве превью каждый раз, когда вы делитесь где-нибудь ссылкой на свой сайт.

<figure><img src="/files/SqIF2c8MMJeS68VmrLY3" alt=""><figcaption></figcaption></figure>

### Видео инструкция

{% embed url="<https://youtu.be/bma3fltGLmI>" %}


# Настройка второстепенных страниц

Помимо главной страницы вы можете настроить еще и такие страницы, как:

* [О компании](https://help.zenky.io/website/builder/nastroika-vtorostepennykh-stranic/stranica-o-kompanii)
* [Доставка и оплата](https://help.zenky.io/website/builder/nastroika-vtorostepennykh-stranic/stranica-dostavka-i-oplata)
* Блог
* Акции


# Страница "О компании"

В режиме настройки страниц в конструкторе сайта можно просто кликнуть на желаемую страницу и перейти к ее настройкам. Обратите внимание, что в левой колонке изменятся блоки

<figure><img src="/files/VOzoyzcMmFmo4fl8kG6w" alt=""><figcaption></figcaption></figure>

### Промоблок

Первое что здесь стоит отметить - это "Промоблок". Так же как и на главной странице, мы можем загрузить сюда картинку фона и редактировать текст, который на ней отражается

<figure><img src="/files/3UoGBRgguiNtBIs12jG2" alt=""><figcaption></figcaption></figure>

### Карточки

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

<figure><img src="/files/urF1eezGBYJb3OxbhNzG" alt=""><figcaption></figcaption></figure>

### Технология

Блок "Технология" похож на предыдущий блок "Карточки", но в отличие от него можно загрузить сюда фоновую картинку, а также здесь есть возможность вставить предзаголовок. В остальном настройки блоков схожие: можно отредактировать текст, с помощью кнопки "Список" добавить карточки  описанием. В основном этот блок используется для описания процессов приготовления пищи, работы доставки и иных процессов, которые делают ваш магазин уникальным.

<figure><img src="/files/lu0C0oGMNCYFH9lG6BNy" alt=""><figcaption></figcaption></figure>

### Сотрудники

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

<figure><img src="/files/5OkD2hcl3hLDjcyNDgbh" alt=""><figcaption></figcaption></figure>

### Контроль качества

Здесь можно лишний раз подчеркнуть самую сильную сторону своего бизнеса, и описать ее, добавив изображение к своему повествованию.

<figure><img src="/files/3UJMC1muw8faxIO0MlhO" alt=""><figcaption></figcaption></figure>

Следом идут уже знакомые нам блоки "[Обратная связь](https://help.zenky.io/website/builder/nastroika-glavnoi-stranicy#id-5.-obratnaya-svyaz)" и "[SEO](https://help.zenky.io/website/builder/nastroika-glavnoi-stranicy#id-7.-seo)", а вот после них идет блок

### Главное меню

В данном блоке мы можем задать название самой страницы. По дефолту она называется "О компании".

<figure><img src="/files/Eq8JA2mr3kikGGbXnDoo" alt=""><figcaption></figcaption></figure>

### Видео инструкция

{% embed url="<https://youtu.be/n0sj_QXexDc>" %}


# Страница "Доставка и Оплата"

Настройки этой страницы достаточно просты и интуитивно понятны

<figure><img src="/files/KZ5RqoFn1iCN02k0iOQP" alt=""><figcaption></figcaption></figure>

### Доставка

Данный блок позволяет:

* Включать/выключать вкладку "Доставка"
* Вкл/выкл карту и зоны доставки на ней
* Отображать или не отображать список ваших складов под картой
* Настроить и описать с помощью кнопки "Список" пункты и условия вашей доставки

### Оплата

<figure><img src="/files/cwov3a9kJ5Gb9R7Hj30F" alt=""><figcaption></figcaption></figure>

* Включаем или выключаем данную вкладку
* С помощью кнопки "Список" редактируем условия оплаты. По умолчанию отображается тот же текст, что и на картинке выше. Как только вы создадите свой список из заголовков и описания, дефолтный текст пропадет и заменится на ваш.

### Гарантия

<figure><img src="/files/Lv1fx5QCwAObn5oaGuIb" alt=""><figcaption></figcaption></figure>

Все настраивается абсолютно так же, как и в предыдущей вкладке.

С блоками "[SEO](https://help.zenky.io/website/builder/nastroika-glavnoi-stranicy#id-7.-seo)" и "[Главное меню](https://help.zenky.io/website/builder/nastroika-vtorostepennykh-stranic/stranica-o-kompanii#glavnoe-menyu)" вы уже знакомы.

\
\
Что же касается страниц "Блог" и "Акции", то настроек там совсем чуть-чуть, они интуитивно понятны, а блоки настроек вам уже знакомы по предыдущим статьям.

### Видео инструкция

{% embed url="<https://youtu.be/Ke9_rC1drU4>" %}

Что же касается страниц "Блог" и "Акции", то настроек там совсем чуть-чуть, они интуитивно понятны, а блоки настроек вам уже знакомы по предыдущим статьям.


# Глобальные настройки

После настройки главной страницы кликаем на шестеренку в левом столбце и переходим к глобальным настройкам.

<figure><img src="/files/haYaxvbxomaTUtPMSLfU" alt=""><figcaption></figcaption></figure>

В блок "Логотипы" можем добавить лого для шапки и подвала сайта, а также фавикон, маленькое изображение, которое отражается на вкладке браузера.

В блоке "Доставка" можем настроить отображение полей сайта, связанных с доставкой.

Переходим к следующим блокам.

<figure><img src="/files/JnIBHNx0ZktMJzBETT9s" alt=""><figcaption></figcaption></figure>

В блок Яндекс.Метрика можем вставить счетчик от Яндекса и собирать статистику посещений сайта. Подробную инструкцию можно найти [здесь](https://help.zenky.io/website/metrika#sozdanie-schetchika).\
\
Следом можем настроить отображение меню на сайта, будет оно сбоку или сверху, и что вообще в нем отражать.\
Если предпочитаете боковое меню - следующим блоком можем настроить и его.\
Также есть возможность включать/выключать отображение страниц сайта, таких как "О компании", "Блог" и т.д.

<figure><img src="/files/WWPynnzDTBIDHh4ehCLB" alt=""><figcaption></figcaption></figure>

Следующие блоки предназначены для установки на сайт таких счетчиков, как: "[VK Pixel](https://help.zenky.io/website/vkontakte-piksel)" и "[Facebook Pixel](https://help.zenky.io/website/facebook-piksel)". просто вставляем ID счетчика и он начинает работать.

Далее - небольшие настройки для SEO, формы обратной связи и правовых документов.

<figure><img src="/files/VPWLhuq8dGNyMmKqd0mi" alt=""><figcaption></figcaption></figure>

С помощью последнего блока можно настроить отображение страницы "Спасибо за заказ"

### Видео инструкция

{% embed url="<https://youtu.be/n6AHr9iI49o>" %}


# Визуальное оформление

Здесь все просто. Читаем, за что отвечает данный цвет, меняем его на тот, который нам нужен (вводим хэштэг и 6 цифр понравившегося нам цвета в формате HEX).

<figure><img src="/files/EJiARlHF4fDjWFjV5g19" alt=""><figcaption></figcaption></figure>

После выбора цвета - не забываем сгенерировать для него оттенки, и сохранить цвета зеленой кнопкой в правом верхнем углу. \
\
Таким же образом идем от цвета к цвету и оформляем дизайн сайта согласно своему фирменному стилю. Если не понятно, за что отвечает тот или иной цвет - просто меняем его методом тыка и смотрим, где что поменялось. Это будет самый быстрый способ понять, какие цвета нужно поменять именно вам.

### Видео инструкция

{% embed url="<https://youtu.be/C1pfFsAgnC0>" %}


# Домен для сайта

Домен — это адрес сайта, по которому сайт можно найти в сети. Если вы хотите подключить собственный домен (то есть чтобы сайт открывался по адресу вида http\://mysite.com), нужно сделать 3 шага.

## Купить домен и настроить его

Продают домены компании-регистраторы. Таких компаний много, найти их можно в поиске Google или Яндекс по запросу «купить домен».

После покупки домена вам нужно добавить DNS-запись, которая будет указывать на наш сервер. Без неё сайт не будет работать.

В панели регистратора вашего домена найдите управление DNS-записями и добавьте новую или измените существующую.

Тип записи должен быть **«A»**, имя поддомена оставьте пустым или укажите символ `@` (у разных регистраторов могут быть другие требования, обратитесь к их справочной системе для уточнения). IP-адрес должен указывать на **5.42.119.219**.

### Добавление A-записи у регистратора reg.ru

Воспользуйтесь [этой статьёй](https://help.reg.ru/hc/ru/articles/4408047107089-Как-привязать-домен-к-IP-адресу), чтобы узнать как добавить **A-запись**, если ваш домен зарегистрирован у **reg.ru**.

Обратитесь в техподдержку reg.ru, если у вас возникли проблемы с добавлением записи.

### Добавление A-записи у регистратора nic.ru

Воспользуйтесь [этой статьёй](https://www.nic.ru/help/kak-napravit6-domen-na-hosting_6756.html), чтобы узнать как добавить **A-запись**, если ваш домен зарегистрирован у **nic.ru.**

Обратитесь в техподдержку nic.ru, если у вас возникли проблемы с добавлением записи.

### Добавление A-записи в Cloudflare

Воспользуйтесь этой [статьёй](https://support.cloudflare.com/hc/en-us/articles/360019093151-Managing-DNS-records-in-Cloudflare), чтобы узнать как добавить A-запись в **Cloudflare**. Для поддомена должно быть **отключено** проксирование трафика!

### Добавление A-записи у другого регистратора

Если ваш регистратор не перечислен на этой странице, обратитесь в его техподдержку с просьбой помочь добавить запись. Предоставьте техподдержке название записи (корневной домен, например `example.org`), тип записи (**A**) и IP-адрес, на который должна указывать запись (**5.42.119.219**).

### Время обновления записей

Обновление данных может занять до 72 часов, но как правило это происходит намного быстрее. После того, как вы добавите запись, вам нужно будет настроить канал продаж в нашей панели управления.

## Настроить канал продаж «Сайт»

Обратитесь к статье [**«Переход на новый шаблон»**](/website/migration), чтобы узнать как закончить настройку домена для вашего сайта.


# Служебные файлы

Если вам необходимо добавить на сайт специальный файл (например, для подтверждения владения доменом в различных сервисах или для внесения изменений в robots.txt), вы можете сделать это в разделе **«Служебные файлы»** вашего сайта (канала продаж).

Ссылку на раздел **«Служебные файлы»** вы можете найти в выпадающем меню **«Сайт и приложение»** (или **«Сайт»**) в верхней левой части каждой страницы.

![Выпадающее меню сайта и приложения.](/files/Kejunb2nWyGRllvYCI1h)

## Добавление файла

Перейдите в раздел **«Служебные файлы»** и создайте первый файл. Вам потребуется указать адрес (с расширением файла, если необходимо), тип файла и его содержимое.

{% hint style="info" %}
Не указывайте в поле **«Путь»** домен вашего сайта или протокол (http\:// или https\://)! Если вы хотите, чтобы страница открывалась по адресу **<https://example.org/my-page.html>**, в поле «Путь» нужно указать только **/my-page.html**.
{% endhint %}

Тип файла нужно указывать, чтобы браузеры могли правильно его открывать или скачивать. Например, если вам нужно разместить HTML-код, выберите тип **«HTML»**. Если этого не сделать, браузер не сможет отобразить её содержимое и вместо этого будет показан исходный код страницы.

![Пример создания файла robots.txt с двумя директивами.](/files/XQeVAelfeEfAIjNYpIUE)

Если в списке типов нет нужного, выберите **«Свой»** и введите нужный [Mime-Type](https://ru.wikipedia.org/wiki/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA_MIME-%D1%82%D0%B8%D0%BF%D0%BE%D0%B2) в отдельном поле.

![Пример настройки Mime-Type для SVG-изображения.](/files/6Oc91gKmZioyOMeYhkmx)

## Файл robots.txt

Мы автоматически создаём robots.txt с содержимым по умолчанию. Кроме того, мы генерируем файл sitemap.xml, куда помещаем ссылки на все категории, товары и страницы вашего сайта.


# Яндекс.Метрика

Рассказываем про Яндекс.Метрику для сайтов на Zenky.

### **Создание счетчика**

Зайдите на сайт [ЯндексМетрики](https://metrika.yandex.ru/) и войдите в свой аккаунт Яндекса. Если у вас его ещё нет, зарегистрируйтесь.

Нажмите на список приложений в левом верхнем углу и далее нажмите на кнопку «Добавить счетчик».

<figure><img src="/files/6iM0CPyHFHWDpaSB4MxO" alt=""><figcaption></figcaption></figure>

Укажите ваш домен в поле «Адрес сайта», выберите нужный часовой пояс, подключите нужные опции и нажмите на «Создать счётчик».

<figure><img src="/files/0rbNe3ehGTAR8LhxoA8O" alt=""><figcaption></figcaption></figure>

Включите опцию **"Электронная коммерция"** и скопируйте ID счетчика – его нужно будет вставить в настройках интеграции **«Яндекс.Метрика»** в панели управления магазином.

<figure><img src="/files/i95nm7kbITUMA7MRF7Kc" alt=""><figcaption></figcaption></figure>

### Установка счетчика

Для установки счётчика вам нужно установить интеграцию «Яндекс.Метрика». Пожалуйста, обратитесь к статье [**«Переход на новый шаблон»**](/website/migration), чтобы узнать как подключить и настроить Яндекс.Метрику.

## JavaScript-цели

Чтобы получать как можно больше информации о поведении покупателей на вашем сайте, создайте новые JavaScript-цели. Мы отправляем их в следующих случаях:

* **Открыт товар.** Когда покупатель открывает карточку товара, мы отправляем в Метрику соытие `ZENKY_PRODUCT_OPENED;`
* **Добавлен товар**. Когда покупатель добавляет товар в корзину, мы отправляем в Метрику событие `ZENKY_PRODUCT_ADDED_TO_ORDER;`
* **Удалён товар**. Когда покупатель удаляет товар из корзины, мы отправляем в Метрику событие `ZENKY_PRODUCT_REMOVED_FROM_ORDER`;
* **Заказ оформлен**. Когда покупатель завершает оформление заказа, мы отправляем в Метрику событие `ZENKY_ORDER_SUBMITTED`.

&#x20;

<figure><img src="/files/Hhjk9UmdVRjlvamI5tfe" alt=""><figcaption><p>Список целей в Яндекс.Метрике.</p></figcaption></figure>

Чтобы добавить новую цель, перейдите в Яндекс.Метрику, нажмите на пункт **«Настройки»** в левом меню сайта, выберите **«Счётчик»**, перейдите во вкладку **«Цели»** и нажмите на кнопку **«Добавить цель»**.

В открывшемся боковом меню выберите **«Целевое событие • ex JS-событие»** и в поле «**Идентификатор цели»** выберите **«Совпадает»** и укажите одно из событий `ZENKY_*`, перечисленное выше. Повторите для всех нужных событий.

<figure><img src="/files/Ufxf5vTt0cIyfbCa4cfm" alt=""><figcaption><p>Создание новой цели в Яндекс.Метрике.</p></figcaption></figure>


# Яндекс.Вебмастер

## Зарегистрироваться в Яндекс.Вебмастер

Это сервис Яндекса для вебмастеров, панель инструментов для оценки индексации сайта и настройки описания сайта в результатах поиска Яндекса. Адрес сервиса → <https://webmaster.yandex.ru>

После входа в кабинет вебмастера, нажмите на кнопку «+» в верхнем меню и в появившемся поле «Адрес сайта» введите адрес вашего сайта и нажмите «Добавить»

![](/files/Hm8ecw557vAuaoQsf2Fl)

Далее вас перекинет на страницу подтверждения прав на домен. Выберите пункт «Мета-тег» и система вам предложит текст мета-тега, который нужно скопировать и вставить в наш конструктор сайта.

![Скопировать этот мета-тег и вставить в конструктор сайта](/files/xyBDcgH4iTr3PRqgWR6Z)

## Вставить мета-тег в код страницы

Вы скопировали мета-тег. Теперь заходим в кабинет управления Zenky по адресу [`https://my.zenky.io`](https://my.zenky.io)

Далее кликаем на зеленую кнопку **«Сайт»** вверху и переходим в раздел **«CSS/JS»**&#x20;

<figure><img src="/files/oLaxPQ430pwt66UJWZfr" alt=""><figcaption></figcaption></figure>

В открывшемся окне нажимаем кнопку **«Создать»**

<figure><img src="/files/S9dMqJQVbTHaUzp68ptP" alt=""><figcaption></figcaption></figure>

Теперь добавляем язык - **HTML** в **Начало Head**

<figure><img src="/files/5ugeaCjootvqiF0eK2BJ" alt=""><figcaption></figcaption></figure>

Скопируйте мета-тег в поле **«Код»** и нажмите кнопку **«Сохранить»**

Поздравляем! Ваш код добавлен.&#x20;

После этого вернитесь в Вебмастер и нажмите кнопку **`«Проверить»`**

Вебмастер найдет мета-тег на сайте и откроет доступ к поисковой аналитике.

## Видео инструкция

{% embed url="<https://youtu.be/7e9RApI73wA>" %}


# ВКонтакте пиксель

Установка кода ретаргетинга на сайт для сбора данных об эффективности таргетинговой рекламы Вконтакте

## Создание пикселя

Создайте Пиксель в [рекламном кабинете Вконтакте](https://vk.com/ads?act=retargeting\&show=pixels\&union_id=1605175826).&#x20;

<figure><img src="/files/FUv4D1eEkmxvvEBbgu03" alt=""><figcaption><p>Раздел меню «Ретаргетинг» → вкладка «Пиксели» → кнопка «Создать пиксель»</p></figcaption></figure>

И скопируйте код пикселя, который в выглдядит вот так:

{% hint style="info" %}
VK-RTRG-5O9O40-goNOq
{% endhint %}

<figure><img src="/files/xJJiCl06zMYoh6vIEign" alt=""><figcaption><p>Жирным выделен код пикселя</p></figcaption></figure>

## Установка пикселя

Далее перейдите в Конструктор вашего сайта

<figure><img src="/files/zIFTItUiYoophCSbFAIH" alt=""><figcaption></figcaption></figure>

Далее перейдите на вкладку **«Глобальные настройки»**.

Найдите пункт `«VK Pixel»`  и введите код пикселя. Например, `VK-RTRG-5O9O40-goNOq`.

После добавления кода, сохраните настройки конструктора.&#x20;

<figure><img src="/files/f9I2RPO09UPFEh1bVDjC" alt=""><figcaption></figcaption></figure>

### Конверсии ВК пикселя

После уставноки ВК пикселя, сайт автоматически отправляет в пиксель следующие события:

{% hint style="info" %}

* add\_to\_cart (Добавление товара в корзину)
* initiate\_checkout (Начало оформления заказа)
* purchase (Заказ оформлен)
* contact (Заполнена форма обратной связи)
  {% endhint %}

Первые три события передают суммы товара и заказа в пиксель, чтобы вы могли оценить полученный доход с привлеченных через таргетинг клиентов.

<figure><img src="/files/ejRfdecufESqrB1PEkwE" alt=""><figcaption></figcaption></figure>

## Видео инструкция

{% embed url="<https://youtu.be/5Ew0dmI46Ug>" %}


# Facebook пиксель

Установка Facebook пикселя для сбора данных вашей рекламной кампании

## Установка пикселя

Чтобы установить Facebook Pixel, вам нужно открыть конструктор сайта и перейти в `«Глобальные Настройки».`

Далее, в левом меню найти блок `«Facebook Pixel»`  и ввести номер пикселя, который нужно получить в [бизнес кабинете Facebook](https://business.facebook.com/).

<figure><img src="/files/FqpafZQ4YEW9t6MUUGpN" alt=""><figcaption></figcaption></figure>

## Видео инструкция

{% embed url="<https://youtu.be/KVCP82_nDJs>" %}


# reCAPTCHA v3

Узнайте как защитить ваш сайт с помощью reCAPTCHA v3.

Если ваш магазин столкнулся с большим количеством подозрительных регистраций и/или оформлений заказов, вы можете защитить некоторые разделы сайта с помощью бесплатного сервиса [reCAPTCHA v3](https://www.google.com/recaptcha/about/) от Google.

Перед тем, как подключить reCAPTCHA v3 в магазине, вам нужно создать сайт в [консоли администрирования reCAPTCHA](https://www.google.com/recaptcha/admin) (для этого понадобится аккаунт Google).

{% hint style="info" %}
На данный момент защита с помощью reCAPTCHA v3 не поддерживается в мобильных приложениях. Если вы включите защиту, выбранные защищённые действия перестанут работать в приложениях (например, пользователи не смогут зарегистрироваться или оформить заказ).
{% endhint %}

## Создание ключей reCAPTCHA v3

Перейдите в раздел [добавления нового сайта](https://www.google.com/recaptcha/admin/create) в консоли администрирования reCAPTCHA. Если вы увидите окно с предложением использовать reCAPTCHA Enterprise, нажмите на кнопку **«Switch to create a classic key»**.

<figure><img src="/files/wgR9sexYfJebLKGrStM2" alt=""><figcaption><p>Окно с предложением ипользовать reCAPTCHA Enterprise.</p></figcaption></figure>

Далее заполните форму вашего сайта:

1. В поле «Ярлык» укажите название или домен вашего сайта;
2. В поле «Тип reCAPTCHA» выберите опцию **«reCAPTCHA v3»**;
3. В поле «Домены» укажите домен вашего сайта (например, `example.org`);
4. В поле «Владельцы» вы можете указать дополнительные адреса электронной почты, на которые будут приходить уведомления от Google; это необязательно;
5. Примите условия использования reCAPTCHA и нажмите на кнопку «Отправить».

<figure><img src="/files/55QEqUMiuDsyUu1nZ530" alt="" width="375"><figcaption><p>Пример заполнения полей формы сайта.</p></figcaption></figure>

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

<figure><img src="/files/CbkWfNUUmHSeoSpsvBBg" alt=""><figcaption><p>Страница с ключами reCAPTCHA.</p></figcaption></figure>

### Отключение проверки источника <a href="#disable-hostname-check" id="disable-hostname-check"></a>

Нажмите на кнопку **«Открыть настройки»**, которая расположена под списком ключей. В настройках сайта снимите галочку с поля **«Проверить источник решений reCAPTCHA»** и сохраните настройки.

{% hint style="info" %}
Ваш ключ reCAPTCHA v3 может использоваться на наших поддоменах \*.zenky.io (например, checkout.zenky.io или auth.zenky.io). Включенная настройка не позволит нам выполнять проверку на этих поддоменах, из-за чего покупатели могут столкнуться с ошибками во время регистрации или оформления заказов.

Мы выполняем проверку источника самостоятельно, поэтому ваш ключ не будет доступен для использования на сторонних сайтах.
{% endhint %}

<figure><img src="/files/Mr5NJS2DWZWDVBVpqXvN" alt=""><figcaption><p>Эта опция должна быть отключена.</p></figcaption></figure>

## Подключение reCAPTCHA v3

После создания и настройки сайта reCAPTCHA, перейдите в панель управления магазином и откройте раздел [**«Магазин» -> «Сторонние сервисы»**](https://my.zenky.io/dashboard/store/profile/settings/services). В секции «reCAPTCHA» включите защиту, вставьте публичный ключ (ключ сайта) и секретный ключ reCAPTCHA в соответствующие поля, укажите домен вашего сайта, а так же выберите какие действия вы хотите защитить.

<figure><img src="/files/XxS9XhjygdttjvSxaTrH" alt=""><figcaption><p>Настройка reCAPTCHA v3 в магазине Zenky.</p></figcaption></figure>

Поле **«Минимальная оценка угрозы для прохождения проверки»** предназначено для более точной настройки пропуска трафика. Чем ниже это значение (от 0.0 до 1.0), тем больше вероятность, что роботы смогут обойти защиту. Чем выше это значение, тем больше вероятность, что все запросы будут приходить только от людей (однако, у небольшого количества легитимных пользователей могут возникнуть проблемы с отправкой запросов).

Мы рекомендуем оставить это значение без изменений и повышать/понижать его в зависимости от типа атаки на ваш сайт.

## Установка reCaptcha для приложения

После настройки reCaptcha в разделе **`«Магазин - Сторонние сервисы»`** нужно создать файл **`/recaptcha.html`** в корневой папке сайта. Данный файл нужен для защиты мобильного приложения.

Для создания этого файла нажмите зеленую кнопку «Сайт» в верхнем меню админки системы. В выпадающем меню выберите пункт **«Страницы»**

<figure><img src="/files/Uw4BupSBx7napFFQ87Ul" alt=""><figcaption><p>Откройте раздел «Страницы»</p></figcaption></figure>

На открывшейся странице нажмите кнопку «Создать» и вставьте нижеприведенный HTML код.

<figure><img src="/files/IlnCGckVy51z5ymlukJO" alt=""><figcaption><p>Нажмите кнопку «Создать»</p></figcaption></figure>

Перед вами откроется форма создания файла с полями:

* Путь к файлу
* Тип файла
* Содержимое файла

<figure><img src="/files/9tIWqYHSriDoUWaF2d5D" alt=""><figcaption></figcaption></figure>

Введите путь файла:

```
/recaptcha.html
```

Укажите тип файла **`«HTML»`** и в поле «содержимое страницы» скопируйте этот HTML код, где поле **XXXXXXXXXXXX** заменить на ваш **публичный ключ** из настроек reCaptcha:

<pre><code>&#x3C;html>
  &#x3C;head>
    &#x3C;title>reCAPTCHA&#x3C;/title>
    &#x3C;script
      src="https://www.google.com/recaptcha/api.js?render=<a data-footnote-ref href="#user-content-fn-1">XXXXXXXXXXXXXXXXXXX</a>"
      async
      defer
    >&#x3C;/script>
    &#x3C;script id="recaptcha-script" async defer>&#x3C;/script>
  &#x3C;/head>
  &#x3C;body>
    &#x3C;script>
      function executeCaptcha(siteKey, action) {
        if (typeof Captcha !== "undefined") {
          grecaptcha.ready(function () {
            grecaptcha
              .execute(siteKey, { action: action })
              .then(function (token) {
                Captcha.postMessage(token);
              })
              .catch(function (error) {
                // Post the error message back to the WebView
                Captcha.postMessage("error: " + error.message);
              });
          });
        }
      }
    &#x3C;/script>

    &#x3C;script>
      function readyCaptcha(dataSiteKey, action) {
        try {
          // Assuming executeCaptcha is defined elsewhere in your code
          executeCaptcha(dataSiteKey, action);
        } catch (error) {
          Ready.postMessage(
            "An error occurred while loading reCAPTCHA:",
            error
          );
        }
      }
    &#x3C;/script>
  &#x3C;/body>
&#x3C;/html>
</code></pre>

Сохраните страницу и проверьте работоспособность reCaptcha в вашем приложении.&#x20;

## reCaptcha в приложении

Пользователи мобильного приложения будут видеть дополнительное окно проверки в течение нескольких секунд. Требуется дождаться автоматического закрытия окна проверки. Что будет означать, что проверка прошла успешно. Если же окно не будет закрываться продолжительное время, то нужно перезапустить приложение и повторить попытку.

<figure><img src="/files/yVv4PBIvQ66WVo37x5DJ" alt="" width="375"><figcaption><p>Дождитесь закрытия окна проверки для продолжения работы</p></figcaption></figure>

## Видео инструкция

{% embed url="<https://youtu.be/I5YYcQg2FI4>" %}

[^1]: Публичный ключ reCaptcha из настроек


# Конструктор приложения

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

1. [Создать канал продаж на основе шаблона Zenky App](https://help.zenky.io/app/builder/channel)
2. [Настроить визуальное оформление приложения](https://help.zenky.io/app/builder/visual)
3. [Настроить страницы приложения](https://help.zenky.io/app/builder/pages)
4. [Настроить навигацию в приложении](https://help.zenky.io/app/builder/navigaciya-v-prilozhenii)
5. [Настроить интеграции](https://help.zenky.io/app/builder/integracii)
6. [Настроить виджеты](https://help.zenky.io/app/builder/vidzhety)


# Создать канал продаж

## Создать канал продаж - мобильное приложение

Нажмите на кнопку **«Сайт»** в левой верхней части страницы. В выпадающем меню нажмите на **«Новый канал продаж»**.

<figure><img src="/files/3IcAeeyTF7lbLHCLNJnh" alt=""><figcaption></figcaption></figure>

Укажите название канала продаж. Например, «Приложение».&#x20;

Выберите тип — мобильное приложение

Шаблон приложения — Zenky App (официальное приложение от команды Zenky)

> В будущем можно будет разабатывать свои шаблоны приложений, размещать тут и получать доход от продаж шаблона.

<figure><img src="/files/5f8n66AZum5VBPcqf9IT" alt=""><figcaption></figcaption></figure>

## Видео инструкция

{% embed url="<https://www.youtube.com/watch?v=ubsZMKHGCrg>" %}


# Предпросмотр приложения

Загрузите демо приложение, которое отобразит ваше приложение с актуальными настройками.

## Загрузите демо-приложение Zenky Store

1. Перейдите в  [AppStore](https://apps.apple.com/pl/app/zenky-store-доставка/id6446293917) или [Google Play](https://play.google.com/store/apps/details?id=io.zenky.store)
2. Установите наше демо приложение Zenky Store на свой телефон

<figure><img src="/files/Q0bdBlwmSDkGV92Gfd9R" alt=""><figcaption></figcaption></figure>

## Откройте QR-код с ID вашего магазина

1. Откройте админку вашего магазина [my.zenky.io](https://my.zenky.io)
2. На главной странице админки нажмите ссылку «показать техническую информацию о магазине»
3. В открывшемся блоке технической информации нажмите на иконку QR-кода<br>

   <figure><img src="/files/4yjhDBSGkCvHOhcXhqAA" alt=""><figcaption></figcaption></figure>
4. Откроется окно с QR-кодом, содержащем ID вашего магазина<br>

   <figure><img src="/files/J2qeDYZgHej8nKGvd4PB" alt=""><figcaption></figcaption></figure>

## Отсканируйте QR-код приложением Zenky Store

1. Перейдите в установленное приложение Zenky Store
2. Отсканируйте этим приложением QR-код вашего магазина
3. Для этого в Zenky Store нажмите иконку QR-кода в правом верхнем углу
4. Наведите камеру на QR-код с ID вашего магазина
5. Нажмите «Сохранить»

## Смотрите как выглядит ваше приложение

1. Приложение подгрузит визуальные настройки вашего магазина
2. Подгрузятся каталог, акции, коллекции и остальной контент вашего магазина
3. Для автоматического обновления изменений зажмите на 3 секунды иконку «Главная страница» в нижнем меню
4. Новые настройки из конструктора будут подгружаться каждыенесколько секунд.
5. Структурные изменения: типа каталога, отображение страницы, виджетов, обновляются путем закрытия и открытия приложения заново.
6. Когда закончите настройку внешнего вида, можете сделать скриншоты экранов.you

## Видео инструкция

{% embed url="<https://youtu.be/G2BEyp2WmjE>" %}


# Визуальное оформление

## Настроить визуальное оформление приложения

Визуальное оформление состоит из блоков:

* Отступы закругления элементов и тени.
* Цвета
* Верхнее меню
* Нижнее меню
* Кнопки
* Тексты
* Картинки

### Отступы

<figure><img src="/files/ReHcFuaZiWTcgZZqT3Ry" alt=""><figcaption></figcaption></figure>

### Цвета

* Акцентированный цвет приложения (цвет кнопок)
* Цвет фона приложения
* Цвет уведолмния об ошибках (ошибка адреса, отсутствие товара на складе и пр)
* Цвет информационных уведомлений
* Цвет текстовых инпутов (полей ввода текста - фио, телефон, адрес и пр.)
* Цвет информационных виджетов (статусы заказа, бронирование столов и пр.)

<figure><img src="/files/ImERWyucb0zxHVlCubRZ" alt=""><figcaption></figcaption></figure>

### Верхнее меню приложения

* Цвет верхнего меню
* Цвет текста верхнего меню
* Размер шрифта в верхнем меню

### Нижнее меню

* Цвет нижнего меню
* Цвет активной иконки и текста в меню
* Цвет неактивной иконки и текста в меню
* Размер шрифта в нижем меню

### Кнопки в приложении

* Цвет основных кнопок
* Цвет вспомогательных кнопок
* Цвет текста основных кнопок
* Цвет текста вспомогательных кнопок

### Тексты в приложении

* Размер шрифта заголовков
* Размер шрифта заголовков карточек
* Размер шрифта подзаголовков карточек
* Размер шрифта описания карточек

<figure><img src="/files/cPh6RPxt1SnGmp3wZkl7" alt=""><figcaption></figcaption></figure>

### Картинки в приложении

* Настройки размеров картинок коллекций
  * Выбрать соотношение сторон (1:1, 1:2, 1:3, 3:2, 4:3)
* Настройки расположения картинок коллекций
  * Растягивать изображение по наименьшей стороне
  * Растягивать изображение по наибольшей стороне стороне
  * Вписать картинку в область
  * Использовать пропорции оригинальной картинки
* Настройки размеров картинок каталога
  * Выбрать соотношение сторон (1:1, 1:2, 1:3, 3:2, 4:3)
* Настройки расположения картинок каталога
  * Растягивать изображение по наименьшей стороне
  * Растягивать изображение по наибольшей стороне стороне
  * Вписать картинку в область
  * Использовать пропорции оригинальной картинки

## Видео инструкция

{% embed url="<https://youtu.be/l4NKgYRoMB4>" %}


# Изменить картинку на заставке приложения

У вас есть возможность поменять стандартную заставку приложения с логотипом Zenky&#x20;

<figure><img src="/files/bovq6P4ETjr9i8PAt0EC" alt=""><figcaption></figcaption></figure>

на свою кастомную. Для этого первым делом нам надо подготовить изображением размером 1290х2796 пикселей.\
\
Затем, идем в `Конструктор приложения`, `Визуальное оформление`, и листаем в самый низ

<figure><img src="/files/IVRGwLCUuMUf3Owyjj2T" alt=""><figcaption></figcaption></figure>

Выбираем цвет фона и загружаем изображение

<figure><img src="/files/xAZ8MGMAS00sDkfVrdKi" alt=""><figcaption></figcaption></figure>

Вуа-ля!

<figure><img src="/files/13KsaYS19t3Dc205NBa4" alt=""><figcaption></figcaption></figure>

{% embed url="<https://youtu.be/2RgcCswIKJc>" %}


# Страницы приложения

## Настройка страниц приложения

В конструкторе доступны настройки следующих страниц:

* Главная страница
* Каталог
* Страница карты лояльности
* Страница «О компании»

## Настройка главной страницы

На данной странице можно вкючить или отключить отображение блоков:

* Виджет выбора доставки
* Слайдер с акциями
* Коллекции товаров
* Избранные категории
  * Показывать только заголовки категорий
  * Показывать товары категорий
* Виджет статусов активного заказа
  * Таймаут отображения виджета на главной странице
* Виджет ссылок на другие приложения и ресурсы
* Виджет бронирования столов Restoplace
* Страница карты лольности

<figure><img src="/files/6592pg0OAlEjMOGmR9LW" alt=""><figcaption></figcaption></figure>

## Настройка каталога

В каталоге можно настроить отображение категорий плиткой, либо списком, либо как меню в таббаре, а также отступы между изображениями

<figure><img src="/files/Gqht1kA00lcQ6HuCRJkP" alt=""><figcaption></figcaption></figure>

Также здесь можно настроить цветовую палитру страницы, и отображение остатков товаров

<figure><img src="/files/2phZ7QwxWUJfKMjC4JJo" alt=""><figcaption></figcaption></figure>

## Настройка страницы карты лояльности

Эта страница доступна, если ее отображение включить в меню "[Навигация в приложении](https://help.zenky.io/app/builder/navigaciya-v-prilozhenii)"

<figure><img src="/files/FhJDdTVbNWpe5uQ37Zda" alt=""><figcaption></figcaption></figure>

Здесь можно задать заголовок и описание программы лояльности

## Страница оформления заказа

<figure><img src="/files/ZfLixQGsyPG3oXa3wUrS" alt=""><figcaption></figcaption></figure>

Здесь можно настроить время, в течение которого заказ будет считаться отложенным

## Страница "О компании" и страница профиля

На странице "О компании" можно сделать логотип круглым

<figure><img src="/files/grbs6Vg24bChYbfMdQOk" alt=""><figcaption></figcaption></figure>

А у страницы профиля задать кастомную аватарку профиля и сделать ее круглой, а также настроить отображение трат, кэшбека и уровня лояльности

## Видео инструкция

{% embed url="<https://youtu.be/_ndTqvbToFE>" %}


# Скрыть траты и кэшбек

Вот так выглядит страница профиля пользователя по умолчанию.

<figure><img src="/files/uN0BWMeDZjb2hK4tCFK9" alt=""><figcaption></figcaption></figure>

На ней отражается бонусный уровень, количество трат и процент кэшбека. Иногда случается так, что по каким-то причинам вы не хотите, чтобы клиент видел эти данные. Как же их скрыть от него?<br>

Все просто. Идем в `Конструктор приложения`, `Настройка страниц приложения` и листаем в самый низ.

<figure><img src="/files/FBRQXFdvx1eIJ0iAM7Cn" alt=""><figcaption></figcaption></figure>

Видим бегунки, которые отвечают, за траты,  кэшбек и бонусный уровень.&#x20;

<figure><img src="/files/lOSg42Htw9cOi2t5dkdG" alt=""><figcaption></figcaption></figure>

Выключаем те, которые не хотим чтобы видел клиент, сохраняем, и смотрим что получилось.


# Аватарки профиля

По умолчанию, аватарки в профиле клиента - стандартные, имеющие вид, как на картинке ниже:<br>

<figure><img src="/files/XYzihZMmti3mgDb3J4z7" alt=""><figcaption></figcaption></figure>

В своем приложении вы можете добавить кастомную аватарку для пользователей. И вот как это сделать.\
Идем в конструктор приложения, раздел `Настройка страниц приложения` и листаем до блока `Страница профиля`

<figure><img src="/files/rtJczR7EI0oVLEAgOe6R" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/bxUnXZ3Nhxwp1Or5xck6" alt=""><figcaption></figcaption></figure>

В результате вышеперечисленных манипуляций, имеем нетривиальную аватарку пользователя, которая может улыбнуть и слегка повысить выручку ;)

{% embed url="<https://youtu.be/Nczh3cslUnY>" %}


# Навигация в приложении

В конструкторе приложения Zenky  можно менять порядок расположения страниц в нижнем меню, а так же вкл/выкл отображение некоторых страниц

<figure><img src="/files/w0EkF2HQFh5VRZTPudEw" alt=""><figcaption></figcaption></figure>

На вкладке "Навигация в приложении" можно легко и непринужденно перетаскивать страницы меню, меняя их порядок, а так же скрыть или отобразить такие страницы как:

* О компании
* Профиль
* Бонусная карта

## Видео инструкция

{% embed url="<https://youtu.be/Ld0nbqFDrKY>" %}


# Интеграции

Также в приложение можно добавить интеграции сторонних сервисов, таких как:

## Сервис пуш-уведомлений Onesignal

<figure><img src="/files/6uMC8tu3J0hljmpSkO8W" alt=""><figcaption></figcaption></figure>

Для этого необходимо выбрать сервис в качестве провайдера пуш уведомлений и вставить ID своего приложения из консоли [OneSignal](https://help.zenky.io/push/create-onesignal)

## Сервис сбора статистики по приложениям AppMetrica

<figure><img src="/files/M2Y5rru7NLXpIgQkfxAd" alt=""><figcaption></figcaption></figure>

Установка настолько проста, что сводится лишь к вставке API ключа, который можно получить в кабинете [AppMetrica](https://help.zenky.io/app/appmetrica)

## Сервис бронирования столов Restoplace

Он пригодится вам, если вы, например, владелец ресторана

<figure><img src="/files/s70HVzPpap2Hntvn40sb" alt=""><figcaption></figcaption></figure>

Здесь можно отредактировать заголовок и описание виджета, его фон и цвет текста, а также вставить для него картинку. Для интеграции потребуется лишь зарегистрироваться на этом сервисе и вставить ссылку на свое приложение в нем.

## Видео инструкция

{% embed url="<https://youtu.be/x66SKNAmr7k>" %}


# Сервис бронирования столиков Restoplace

Данный сервис позволяет вашим клиентам бронировать столы через ваше мобильное приложение.

Для начала следует пройти по ссылке <https://app.restoplace.cc/>, заегистрировать себя и свое заведение, прописав адреса, телефоны, режим работы и задать прочие настройки. После выполнения этих действий вам будет подарен пробный бесплатный период на 14 дней, и выдан доступ к вашему кабинету, в котором нам нужно будет скопировать ссылку на виджет для гостей.

<figure><img src="/files/sDobxpofgnCL7NHcYWCL" alt=""><figcaption></figcaption></figure>

Далее отправляемся в конструктор приложения, раздел `Интеграции`, и листаем до блока `Интеграция с Restoplace`.

<figure><img src="/files/zXdzcGEqOipxUvEiaaco" alt=""><figcaption></figcaption></figure>

Здесь можно задать заголовок виджета, его описание, цвет текста и фона, при желании  - картинку. А в самом конце - вставить ту ссылку, что мы скопировали с сайта Restoplace. Обязательно ставим перед ней "https\://", иначе из приложения виджет открываться не будет.

<figure><img src="/files/sjtevOeqjngE3uSKxjd3" alt=""><figcaption></figcaption></figure>

В результате нас перебрасывает на видежт, в котором можно забронировать столик.

<figure><img src="/files/E27hnVeFOuBQlgI0pxiA" alt=""><figcaption></figcaption></figure>

{% embed url="<https://youtu.be/325BUP17_os>" %}


# Виджеты

Еще в приложение можно добавить ссылки на сторонние ресурсы или другие ваши сайты и приложения. Делается это на вкладке "Виджеты"

<figure><img src="/files/ASnruYh6uMYjTZcBnxBT" alt=""><figcaption></figcaption></figure>

Здесь можно дать название блоку, отрегулировать шрифт заголовка, а также настроить отображение виджетов: ввиде горизонтального слайдера или сетки в 2 или 3 колонки. Еще можно настроить выравнивание виджетов.

<figure><img src="/files/BIdLk9qK20B0KKYQD1xx" alt=""><figcaption></figcaption></figure>

Есть возможность добавить кастомные ссылки с изображением, настроить цвет фона и теста, задать заголовок, и указать, где стоит открывать ссылку, в браузере, или в самом приложении, если такое у вас установлено.

На этом данный раздел не заканчивается. Также здесь можно настроить систему отзывов о вашем приложении.

<figure><img src="/files/G4RZyENqccTI9bor4j5v" alt=""><figcaption></figcaption></figure>

И сделать так, чтобы положительные отзывы падали прямиком на вашу страницу в 2ГИС, Яндекс картах и многих других сервисах.

<figure><img src="/files/qm7ZNVji9jHyD7iJcltJ" alt=""><figcaption></figcaption></figure>

Еще в данном разделе настраивается внешний вид и отображение карты лояльности

<figure><img src="/files/8dPe4DrBA09xQUHHEFsc" alt=""><figcaption></figcaption></figure>

А также виджет активного заказа, который висит у покупателя в приложении до тех пор, пока его заказ активен.

<figure><img src="/files/UyLuMFAfhCg79a84ODWQ" alt=""><figcaption></figcaption></figure>

## Видео инструкция

{% embed url="<https://youtu.be/3g8n9FgN3bA>" %}


# Отзывы

В нашей время отзывы о том или ином продукте являются порой определящим фактором в принятии решения покупателем. Поэтому к системе отзывов лучше с асамого начала подходить со всей ответственностью.\
\
Чтобы настроить свою систему отзывов, необходимо перейти в конструктор приложения, а далее в раздел `Виджеты`, а затем пролистать вниз до соответствующего блока.

<figure><img src="/files/7c5q2NDyEskGZXnxLegT" alt=""><figcaption></figcaption></figure>

Первое что можно здесь сделать - это включить или выключить запрос отзыва у клиента. После того, как его заказ будет выполнен, клиенту будет предложено оставить отзыв.

<figure><img src="/files/1lkNk3a2kQYyB6C77Q3C" alt=""><figcaption></figcaption></figure>

\
Далее, стоит задать минимальную хорошую оценку, при которой отзыв из приложения будет автоматически падать в такие сервисы, как Гугл Карты, Яндекс Карты, 2ГИС и многие другие.

Затем можно отредактировать тексты заголовков и описаний на различных стадиях отсавления клиентом отзыва.

<figure><img src="/files/yflWrl6NoQH5dtjCdPGX" alt=""><figcaption></figcaption></figure>

Далее следует добавить ссылки на свой магазин в желаемых сервисах, карптинки к ним, и описание. Не забываем сохранять изменения.

<figure><img src="/files/4sjDLuEsKydlvb5fIGqz" alt=""><figcaption></figcaption></figure>

После добавления иконок. ссылок и описаний, на последнем этапе оставления отзыва клиенту будет предложено кликнуть по соответствующему значку и оставить отзыв там.

<figure><img src="/files/FMspKkAYQ6TJTRpMgBtO" alt=""><figcaption></figcaption></figure>

{% embed url="<https://youtu.be/yftTC6z5J4s>" %}


# Создание промо баннеров приложения

Для публикации в AppStore и Google Play

## Сделайте скришоты страниц приложения

1. Откройте демо приложение Zenky Store
2. Сделайте скриншоты нужных страниц
   1. главная
   2. каталог
   3. внутренняя страница каталога с товарами
   4. страница товара
   5. страница «О компании»
   6. Профиль клиента
3. Отправьте скрины на свой компьютер или сохраните в облачный диск для дальнейшего использования в дизайне скриношотов для публикации

## Скопируйте готовый дизайн макет скриншотов для публикации

1. Чтобы придать продающий вид скриншотам, мы сделали дизайн макет
2. Дизайн макет сделан в программе Figma
3. Откройте дизайн макет по этой [ссылке](https://www.figma.com/file/BLfOd5sKXIp9ZOwsDl2YKq/Zenky-Store-Demo-AppStore?type=design\&node-id=0%3A1\&mode=design\&t=IqreBSrvLIjIBBEE-1)
4. Если у вас нет аккаунта в Figma, то зарегистрируйтесь
5. Сделайте копию этого макета в свой аккаунт Figma
6. Далее вы сможете редактировать этот макет

   <figure><img src="/files/oi5CwvSWdIDHcejhw2pg" alt=""><figcaption></figcaption></figure>

## Отредактируйте дизайн макет

1. В макете указаны инструкции куда вставлять скрины и текстовые заголовки
2. Вставьте скрины приложения в блок скринов

   <figure><img src="/files/UZppOmaoI6G0IoWBP8kC" alt=""><figcaption></figcaption></figure>
3. Вставьте текстовые заголовки скринов в блоке заголовков

   <figure><img src="/files/84Q8DcjvtwI48vWaYxFa" alt=""><figcaption></figcaption></figure>
4. Вставьте логотип в иконки для iOS и Android \
   ![](/files/VJHoho8k78oXpz3oLpYp)
5. Отредактируйте баннер для Play Market\
   ![](/files/VwxFwAazVkwZj3hgKnCC)
6. Отредактируйте первый баннер. Вставьте свой лога и пропишите свой текст\
   ![](/files/ETG2NwBodyvsoRXBbGbT)

## Экспортируйте промо баннеры и иконки приложения в PNG формате

1. Экспортируйте баннеры размера 5.5 дюйма
2. Для этого в левой колонке слоев найдите группо слоев 5.5\
   ![](/files/Nr6aaSZksayludO4H7Sr)
3. Выделите внутренние слои
4. Нажмите кнопку **`Export 6 layers`** в правой колонке редактора\
   ![](/files/ghVjYJSjh1tBdhKvHqGj)
5. Сохраните баннеры в отдельную папку на вашем компьютере
6. Экспортируйте таким же образом баннеры размера 6.5 дюйма и 6.7 дюйма\
   ![](/files/bmG9bXYmxTq3zWqKydmh)![](/files/IsurtrbZ3IKEiv1LOP2F)
7. Экспортируйте иконки приложений и баннер для PlayMarket, выделив слои в левой колонке и нажав **`Export 3 layaers`** в правой колонке редактора\
   ![](/files/vk1PzbzjnPA8vHixuSgR)![](/files/MkF0lXdMmmnQZlgdDpKu)

## Загрузите промо баннеры в AppStore и Google Play аккаунты

1. Если вы размещаете приложения на нашем аккаунте, то напишите нам в чат техподдержки и отправьте ссылку на облачный диск, где сохранены экспортированные файлы баннеров и иконок прилоежния.
2. Если вы размещаете приложение в своих AppStore и Play Market аккаунтах, то зайдите в них и загрузите баннеры и подготовьте аккаунты к публикации. У нас есть отдельные инструкции [как оформить AppStore](/app/ios/app-store-publish) и как оформить [Play Market](/app/android/google-play-publish).

## Видео инструкция

{% embed url="<https://youtu.be/Z-2DZXzcbuw>" %}


# Диплинки, deeplinks

Диплинки это ссылки на вашем сайте, которые открывают приложение на нужной странице.

## Зачем нужны диплинки?

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

Например, покупатель нашел ваш сайт в гугле, яндексе или 2гис и кликает на ссылку, в этот момент вместо браузера открывается приложение. Это очень удобно.

Другой пример. Вы отправили пуш рассылку с указанием ссылки на сайт. Клиент, получивший пуш, кликнет на него и попадет в приложение на нужную вам страницу.

## Как настроить диплинки на моем сайте

Нужно зайти в админку **`my.zenky.io`**, клинкуть на кнопку **`Сайт`** и перейти в пункт **`Страницы`**.

<figure><img src="/files/cb4RgESYC9mtu4KY4nor" alt=""><figcaption></figcaption></figure>

## Диплинк для Android приложений

На открывшейся странице нажмите кнопку **`Создать`**. И заполните полня создания новой страницы. В поле **`Путь`** введите:

```
/.well-known/assetlinks.json
```

В поле **`Тип файла`** выберите **`JSON`** как на картинки ниже.

<figure><img src="/files/xhagJoQe0F6NekRGXfKL" alt=""><figcaption></figcaption></figure>

В поле **`Содержимое страницы`** укажите данный текст. Где **`package_name`** это ваш bundle id приложения, а **`sha256_cert_fingerprints`** это ключ который вам нужно получить в Google Play консоли.

```
[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "io.zenky.vashsite",
      "sha256_cert_fingerprints": [
        "3A:D2:3E:FE:36:B8:AA:1D:68:77:CF:4B:87:27:CC:96:63:AE:78:C0:9B:59:D1:33:9B:FB:BB:69:4D:54:11:98"
      ]
    }
   } 
  ]
```

**`sha256_cert_fingerprints`** в консоли можно найти вот здесь

<figure><img src="/files/OPT1V0WtDbuVyiRggQRq" alt=""><figcaption></figcaption></figure>

## Диплинк для iOS приложений

Нужно зайти в админку my.zenky.io, клинкуть на кнопку **`Сайт`** и перейти в пункт **`Страницы`**.

На открывшейся странице нажмите кнопку **`Создать`**. И заполните полня создания новой страницы. В поле **`Путь`** введите:

```
/apple-app-site-association
```

В поле **`Тип файла`** выберите **`JSON`** как на картинки ниже.

<figure><img src="/files/mHubNAbgIHF9Qu6OldVK" alt=""><figcaption></figcaption></figure>

В поле **`Содержимое страницы`** укажите данный текст. Где в поле **`appID`** нужно указать **`TeamID`** Apple Developer аккаунта и **`BundleID`** приложения.

```
"appID": "TeamID.BundleID",
```

Если приложение размещено на аккаунте Zenky, то укажите TeamID → NPKAZGS99H

Bundle ID приложения можете найти в админке в разделе **`Магазин - Каналы продаж`**. Bundle ID выглядит примерно так: **`io.zenky.vashsite`**

```
{
      "applinks": {
          "apps": [],
          "details": [
              {
                  "appID": "NPKAZGS99H.io.zenky.vashsite",
                  "paths": [ "/", "/catalog/*","/offers/*","/about-us/"]
              }
          ]
      }
  }
```

Созраните изменения. И теперь при переходе на ваш сайт у клиентов будет открываться сразу ваше приложение, если оно установлено на устройстве. А также при клике на пуш будет открываться нужная страница приложения, а не главная страница.


# Apple АppStore


# Добавление ссылки на iOS приложение на сайт

Зайдите в `Магазин — Каналы продаж`  и добавьте ID приложения в AppStore.

Для этого найдите страницу приложения в AppStore и скопируйте ссылку на страницу приложения. У вас получится ссылка:

* `https://apps.apple.com/ru/app/название приложения/id`**`1494877615`**

Нужно скопировать ID приложения — это цифры в конце ссылки. И вставить ID в соответствующее поле на странице настройки приложения&#x20;

<figure><img src="/files/GIO9g9SF63qizESNpKOz" alt=""><figcaption></figcaption></figure>

После добавления ссылки у вас в подвале сайта появится логотип со ссылкой на приложение. По клику на иконку приложения клиент перейдет в AppStore и скачает приложение.

![](/files/-MASBF0fPo821MIS3zcz)


# Создание Apple ID

Перейдите на [страницу регистрации Apple ID](https://appleid.apple.com/account#!\&page=create). Заполните поля имя, фамилия, страна, дата рождения, емейл, пароль для Apple ID и ответьте на три секретных вопроса, чтобы в будущем восстановить доступ, если забудете пароль.

![](/files/-M5taWfDT7boMlLR5gJ6)

На следующем этапе нужно ввести код подтверждения емейл адреса. Вам на емейл был отправлен 6 значный код. Нужно найти письмо от Apple и ввести код из письма в указанные поля.

![](/files/-M5tfz-wcnNkBR31bTEn)

После подтверждения емейл адреса, вам Apple ID считается зарегистрированным и вы можете [включить двухфакторую авторизацию](/app/ios/create-apple-id/twostep-on-web) и добавить дополнительный телефонный номер для авторизации.


# Включение двухфакторной аутентификации через вебсайт

Перейдите на [страницу входа в Apple ID](https://appleid.apple.com/#!\&page=signin). Введите емейл и пароль.

![](/files/-M5tLcQMJ14-DGjv953m)

На стартовой странице в блоке «Безопасность/Security». Нажмите «Начать/Get Started» в разделе «Двухфактораня авторизация» см. фото ниже.

![](/files/-M5tKH8gAHkO_kKqCAcb)

На следующем экране отметьте галочку и нажмите кнопку «Продолжить/Continue» в правом нижнем углу окна.

![](/files/-M5tW9guJNAmOAYmYTYX)

Укажите номер телефона, на который будет приходить СМС с кодом для входа в аккаунт. Выберите страну в списке +7 Russia и укажите номер телефона. Нажмите «Continue»

![](/files/-M5tX7HYpXWktbJ76LjD)

На следующем экране нужно ввести 4х значный код из СМС, которая пришла на ваш номер.

![](/files/-M5tYDv51fG9SBRUQLf-)

После успешного ввода 4х значного кода из СМС вас направит на экран выбора подключенных устройств к  Apple ID, чтобы вы выбрали на какой из этих устройств тоже можно будет отправлять проверочный код, на случай если СМС не доступна. В нашем примере у аккаунта нет устройств. Нажимаем «Continue»

![](/files/-M5tZL_gmJ4yavC2Ue3r)

После чего, нужно записать ключ восстановления в отдельный файл, блокнот или распечатать на принтере. Он понадобится если вы потеряете номер телефона и устройства. Обязательно запишите этот номер. Так как на следующем экране вас попросят ввести его руками :)

![](/files/-M5tXAHEJhWHa29Q9fyJ)

После успешного повторного ввода ключа восстановления, останется только подтвердить включение двухфакторной авторизации. Установите галочку и нажмите «Включить/Enable»

![](/files/-M5tMjZ3v85GHst1RFMS)

Ура! Поздравляем вы включили двухфакторную авторизацию.

![](/files/-M5tXD7FUub_tbAMBjhk)


# Включение двухфакторной аутентификации через iPhone или Mac

## С помощью iPhone, iPad, iPod

Чтобы включить двухфакторную аутентификацию, можно выполнить на iPhone, iPad или iPod touch следующие действия.

### Перейти в раздел «Настройки»

Если на устройстве установлена ОС iOS 10.3 или более поздней версии, выполните следующие действия.

1. Выберите «Настройки» > \[ваше имя] > «Пароль и безопасность».&#x20;
2. Нажмите «Включите двухфакторную аутентификацию».
3. Нажмите «Продолжить».

Если на устройстве установлена ОС iOS 10.2 или более ранней версии, выполните следующие действия.

1. Выберите «Настройки» > iCloud.&#x20;
2. Выберите свой идентификатор Apple ID > «Пароль и безопасность».&#x20;
3. Нажмите «Включите двухфакторную аутентификацию».
4. Нажмите «Продолжить».

Возможно, потребуется ответить на контрольные вопросы Apple ID.

![](https://support.apple.com/library/content/dam/edam/applecare/images/ru_RU/appleid/ios13-iphone-xs-settings-apple-id-password-security-turn-on-two-factor-authentication.jpg)

![](https://support.apple.com/library/content/dam/edam/applecare/images/ru_RU/InlineIcons/spacer.png)

### Добавить доверенный номера телефона

Укажите номер телефона, на который необходимо получать коды подтверждения при входе в систему. Можно выбрать получение кодов в виде текстовых сообщений или автоматических телефонных вызовов.

При нажатии пункта «Далее» компания Apple отправляет код подтверждения на указанный вами телефонный номер.

Введите код подтверждения, чтобы подтвердить номер телефона и включить двухфакторную аутентификацию.

![](https://support.apple.com/library/content/dam/edam/applecare/images/ru_RU/appleid/ios13-iphone-xs-settings-apple-id-password-security-turn-on-two-factor-authentication-trusted-phone-number.jpg)

![](https://support.apple.com/library/content/dam/edam/applecare/images/ru_RU/InlineIcons/spacer.png)

## С помощью компьютера Mac

### Если установлена ОС macOS Catalina:&#x20;

1. Выберите меню Apple  > «Системные настройки», затем нажмите Apple ID.&#x20;
2. Щелкните «Пароль и безопасность» (под своим именем). &#x20;
3. Щелкните «Включить двухфакторную аутентификацию».

![](/files/-M64NoJFqmZnfkT1-Vf4)

### Если установлена ОС macOS Mojave или более ранней версии:&#x20;

1. Перейдите в меню Apple  > «Системные настройки», затем нажмите iCloud и выберите «Сведения об учетной записи».
2. Щелкните значок «Безопасность».
3. Щелкните «Включить двухфакторную аутентификацию».

Некоторые идентификаторы Apple ID, созданные в ОС iOS 10.3 или macOS 10.12.4 и более поздних версий, защищены двухфакторной аутентификацией по умолчанию. В этом случае двухфакторная аутентификация будет уже включена.

![](/files/-M64NrfCPKBBxCizWmHB)


# Регистрация Apple Developer аккаунта

Регистрируем аккаунт разработчика Apple

Заходим [на сайт Apple](https://developer.apple.com/programs/enroll/). Нажимаем кнопку «Start Your Enrollment», после чего нас отправит на экран ввода Apple ID, который у нас уже есть.

![](/files/-M5gKekjaSUKU8h5Mrxi)

Вводим Apple ID (e-mail) и пароль, который мы [регистрировали по инструкции](/app/ios/create-apple-id).

![](/files/-M5gLgKfe2KSlXu45XxG)

Если вы регистрировали Apple ID по нашей инструкции, то у вас включена двухфакторная авторизация и все Ок и вы продолжите регистрацию. Но если двухфакторная НЕ включена, то вас перекинет на экран с предупреждением и вам придется [включать двухфакторую авторизацию](/app/ios/create-apple-id/twostep-on-web) :)

![](/files/-M5gY2z_jVZwAp1em7Nw)

А если у вас с двухфакторкой все норм, то вас перекинет подтверждение условий программы, где нужно отметить галочку согласия с условиями и нажать на кнопку «Submit».

![](/files/-M5gNuoR3wMxVNPdfM7M)

Оказываемся ввода персональных данных владельца аккаунта разработчика. Как правило тут указываются данные владельца приложения. Раздел `State/Province` может не содержать некоторых регионов России, можно указать ближайший другой регион.&#x20;

![](/files/-M5gPUpCW0RjlX_8_hiG)

Вот шаблон заполнения, если у вас возникают трудности с заполнением.

![](https://lh4.googleusercontent.com/niJVbFS6Pbp_koy0WHxtl2gVR95_zQurGd54A5iSjk2Y_1MoNnsQozA7QrNRz7wYQ80zUgPhzhVmNcNMgQAXDUHgoPC7sKeMlAYV5OHufuZngWDw9zVzT2eFPeB4pL7E1Wbc4VXt)

Теперь два пути: присоединиться к программе как физическое лицо (Individual / Sole Proprietor) или как юридическое (Company/Government Organization).‌

Стоимость — 99 и 199 долларов соответсвенно. Отличие тоже одно — статусность. В графе «продавец» будет значиться либо Ivan Ivanov, либо Touch Instinct, LCC.

![](/files/-M5gRo8x82RrAOD-cgUZ)

Нужно выбрать индивидуальный тип (`Individual / Sole Proprietor`) и нажать `Continue`&#x20;

![](/files/-M5gSUCxmXdvY4fVRtX8)

Тут нужно отметить галочку для принятия условий и нажать Continue и вас отравит на экран подтверждения оплаты.

## **Оплачиваем аккаунт**

![](/files/-M5gTAA59yKG5OiFXKN1)

Добрались до оплаты! Тут просто нажимаем `Purchase`

![](/files/-M5gTeGd8yOMXv85K0Qq)

Вводим платежные данные и нажимаем `Continue`  и аккаунт будет зарегистрирован.

## **Подтверждение аккаунта**

Финальный штрих в истории — письмо с подтверждением, которое придет на почту. Как только пришло — порядок, можно выкладывать приложение.

Для удобства последующего размещения приложения, нужно[ добавить телефонный номер ](/app/ios/add-trusted-phone)разработчика в с список доверенных. Чтобы при загрузке приложения не тревожить владельца аккаунта просьбами выслать код подтверждения, который пришел ему на телефон.

## Регистрация как компания

Если хотите зарегистрироваться как компания, вас ждут похожие поля и немного ада. Чтобы пройти проверку Apple, нужно добыть D-U-N-S number организации.

Duns можно [добыть бесплатно на официальном сайте](https://habrahabr.ru/company/touchinstinct/blog/342046/) или [купить за 12240 рублей](https://www.dnb.ru/login/?next=%2Forder%2Fadd%2F\&message_info=order_add). Последнее — наказание для тех, кто не знает английского. Через 14 дней после получения номера информация окажется у Apple. Закладывайте минимум 19 рабочих дней на ожидание. Обратите внимание, что название вашей компании на сайтах Apple и D\&B должны полностью совпадать.&#x20;


# Добавление номера к Apple ID

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

На период разработки приложения в некоторых случаях оптимальным является добавление номера разработчика в Apple ID авторизацию, чтобы ускорить процесс публикации.

Разработчику нужно будет входить в ваш аккаунт для публикации приложения несколько раз и каждый раз вам нужно будет передавать ему код авторизации, который приходит на ваш мобильный номер. Код авторизации активен несколько минут.

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

Итак. Нужно [зайти в ваш Apple ID аккаунт](https://appleid.apple.com). Ввести логин и пароль. Вас направит на главный экран, где нужно нажать на кнопку `Редактировать/Edit`

![](/files/-M5tilm1eE0M4m3IuqNZ)

В открывшемся окне, нужно нажать на ссылку добавления нового номера.

![](/files/-M5tjhCmV-OXzOw663na)

Далее нужно выбрать страну и ввести телефонный номер.

![](/files/-M5tkOIm9wxjps9etHhV)

После ввода номера вам будет выслана СМС с кодом, который нужно будет ввести в этом окне.

![](/files/-M5tlOqVWRtoIxELygTo)

После успешного ввода пин кода, этот номер считается подтвержденным. Теперь разработчик сможет оперативно настроить кабинет и разместить приложение.&#x20;

После публикации приложения, номер разработчика можно будет удалить из доверенных.


# Оформление страницы приложения в App Store

## Подготовка приложения к публикации в  App Store

Заранее готовим материалы, чтобы не терять время во время релиза. Заходим в кабинет <https://appstoreconnect.apple.com/> и вносим все заранее приготовленные данные.

Нажимаем кнопку «+» и «Новое приложение»

<figure><img src="/files/KMtHEKp365n7xHmCRJ7h" alt=""><figcaption></figcaption></figure>

Далее заполняем форму. Указываем платформу iOS, название (30 символов), язык, ID пакета выбираем из списка (если там пусто, значит разработчик не создал сертификат и пакет. Нужно, чтобы он это сделал), SKU, полный доступ.

### Новое приложение

* После того, как мы приступили к созданию нового приложения, выбираем платформу для будущего приложения. В нашем случае - это платформа «iOS».
* Далее вводим название проекта. Название проекта должно быть «уникальным», в противном случае App Store сообщит вам, что приложение с данным названием уже существует - введите другое.
* Выбираем на каком языке будет наше приложение. В нашем случае «русский».
* ID пакета, например: **io.zenky.project**
* В предыдущей статье - [Шаг 6](https://zenky.io), можно подробно ознакомиться с системой создания ID пакета. Этот ID вам сообщит команда разработки, если вы его не знаете.
* Заполняем SKU - можно сделать копией «ID пакета». Особые ограничения по заполнению отсутствуют. SKU - уникальный ID пакет, который не отображается в App Store.
* Пользовательский доступ - можно не заполнять. Если у вас уже присутствуют пользователи в личном кабинете App Store Connect, можно применить «ограниченный доступ», если пользователей нет, то нажимаем «полный доступ».

  <figure><img src="/files/Bu5fBPZ6KvbeXHth3l7k" alt=""><figcaption></figcaption></figure>

### App Store Connect: Мои приложения

После того, как мы создали проект, переходим в раздел «Мои приложения». В данном разделе присутствует карточка нового проекта. Переходим в новый проект и выбираем раздел «Информация о приложении».

Заполняем:

* «Название» - поле для названия проекта.
* «Подзаголовок» - подразумевает под собой краткое описание проекта (рекламный текст, выводится в App Store).

<figure><img src="/files/CD8NmuCwO5eN4kSOWTv0" alt=""><figcaption></figcaption></figure>

* Добавляем языки на которых будет доступно приложение. В нашем случае «русский»
* «Категория» - на скриншоте можно увидеть лишь некоторые из списка. Выбираем основную категорию и дополнительную, если проект объединяет или несет в себе несколько категорий. Например, `«Еда и напитки»`.

  <figure><img src="/files/G25euZAj2ZKB8TxYn5fU" alt=""><figcaption></figcaption></figure>
* Далее заполняем декларации `«Права на контент»` и `«Возрастное ограничение»`

  <figure><img src="/files/SGPNwOP5hIjxRxpQpuTS" alt=""><figcaption></figcaption></figure>

### Ценообразование и доступность

На данной странице мы можем выбрать, стоимость приложения. Встроенные покупки не подразумеваются, указывается конкретная стоимость приложения при скачивании (покупке).

* В нашем случае приложение бесплатное, поэтому в блоке «Цена» указываем - **0 рублей**.

  <figure><img src="/files/dyExJlE4sLs1o6fcob0L" alt=""><figcaption></figcaption></figure>

В разделе «Доступность», выбираем страну «Россия», т.к. наше приложение будет работать только на территории этой страны.

### Конфиденциальность приложения

В данном разделе нам необходимо заполнить декларацию конфиденциальности

* «URL адрес» - политика конфиденциальности. У нас это ссылка автоматическая вида **<https://client-site.ru/legal/privacy-policy>**

  <figure><img src="/files/TZo7YLl5MHdyrKqEkXY2" alt=""><figcaption></figcaption></figure>

Теперь пошагово заполняем декларацию

<figure><img src="/files/zT8Ww3IKSADyc1H9KJPz" alt=""><figcaption></figcaption></figure>

Листаем вниз и ставим галочки как на скриншотах

<figure><img src="/files/hDExxyGtzXyTIc5le4J1" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/vnlIHvXmB11CajAqEW10" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Xi6cvzNo5OUBvrv2jTPO" alt=""><figcaption><p>Не забываем нажать на кнопку <strong>"Сохранить"</strong></p></figcaption></figure>

После того как проставили все флажки - их необходимо настроить

<figure><img src="/files/3PvuG7YGgyx2LRYliKsS" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/4oGweWXMN7tTwO6b8im8" alt=""><figcaption><p>Ставим флажки на "персонализация продукта" и "Функциональные возможности приложения"</p></figcaption></figure>

<figure><img src="/files/tuEk8mvvPZwaH6PPOmar" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/pQZANlkDW4Nj9qjR8DP0" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/uuXSKesvHPebePlQwlJF" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/zZp7yi2YCCAszubGfmJn" alt=""><figcaption></figcaption></figure>

Готово! Аналогичным образом заполняем поля: Адрес электронной почты, Номер телефона, Физический адрес.

<figure><img src="/files/L7CVQhdeocpGBMUEF69F" alt=""><figcaption></figcaption></figure>

Поля Приблизительная геолокация, ID устройства и Данные о сбоях заполняем соласно скриншоту ниже

<figure><img src="/files/8IsHeqUL5EsP8LfO5oCY" alt=""><figcaption></figcaption></figure>

### Подготовка к отправке

Возвращаемся в раздел `Приложение для iOS` и выбираем версию приложения 1.0 (первую версию проекта).

Это основной раздел в котором необходимо добавлять (редактировать) информацию о проекте.

В разделе присутствует большой блок со скриншотами:

* iPhone 6,5 дюймовый дисплей — iPhone XS Max и аналог
* iPhone 5,5 дюймовый дисплей — iPhone 6+ и аналог
* iPad Pro (3-го поколения) 12,9 дюймовый дисплей и аналог
* iPad Pro (2-го поколения) 12,9 дюймовый дисплей и аналог

Информация для iPad в нашем случае **НЕ заполняется**, т.к. у нашего приложения нет отдельной визуализации для планшетов.

App Store автоматически генерирует скриншоты для остальных устройств на базе скриншотов 6,5 и 5,5 дюймов.

Информация по оформлению [скриншотов](https://help.apple.com/app-store-connect/#/devd274dd925) и [видео](https://help.apple.com/app-store-connect/#/dev4e413fcb8) доступна по указанным ссылкам.

App Store приложение

* Блок «Рекламный текст» - это единственное поле которое можно менять без обновления приложения в маркете. Его можно редактировать в любое время дня и ночи сколько угодно раз. Рекламный текст отображается под названием приложения.
* Блок «Ключевые слова» - в разделе через запятую перечисляются ключевые слова актуальные для данного проекта.
* Блок «Описание» - общее описание проекта.

  <figure><img src="/files/ZfsxvzeFyXFeOcnsHD36" alt=""><figcaption></figcaption></figure>

### Общая информация о приложении

* “Значок для App Store” - Автоматически устанавливается при загрузке файла сборки проекта в App Store.
* «Версия приложения» - ставится по умолчанию (1.0), можно отредактировать и изменить.
* также заполняем блоки "Рекламный тест", "Описание" и "Ключевые слова"
* В поле URL-вдрес службы поддержки указываем адрес своего сайта
* С правой стороны заполняем блок «Авторские права» — пишем «2024 Название компании»

  <figure><img src="/files/UZ6QYvQOwNmbZSswo2EX" alt=""><figcaption></figcaption></figure>

### Информация для проверки приложения

* Необходимо заполнить контактную информацию ответственного лица от партнера, чтобы модераторы App Store в случае необходимости могли с вами связаться. Имя и телефон.
* В блоке «Информация для входа» указываем наш тестовый логин, чтобы модераторы смогли проверить личный кабинет и другие функции зависящие от авторизации.
  * имя пользователя +79641234567
  * пароль secretsecret
* Блок «Примечание». Оставляем пустым.
* «Выпуск версии» в данном блоке выбирается `«Выпуск версии автоматически»`
* Далее нажимаем сверху кнопку «Сохранить»

  <figure><img src="/files/JcKOmIpq7RJpy5oZ2hI3" alt=""><figcaption></figcaption></figure>

### Финал! Загрузка сборки приложения

Ну вот и подготовили страницу приложения и остался последний шаг — Загрузить само приложение. Вам нужно :

1. внести учетные данные Apple ID в таблицу внедрения проектов
2. добавить номера разработчиков к Apple ID
3. подготовить страницу приложения к публикации
4. уведомить команду разработки, о готовности проекта к загрузке сборки приложения и отправке на публикацию

## Данные для создания страницы приложения в App Store

### 1. Название приложения

Будет отображаться в App Store. До 30 символов.

### 2. Ключевые слова

Одно или несколько ключевых слов, описывающих приложение. Поиск в App Store по ключевым словам дает более точные результаты. Разделяйте ключевые слова запятыми. До 100 символов.

### 3. Описание

Описание приложения также будет использовано в приложении для Apple Watch. Максимум 4000 символов.

### 4. E-mail службы поддержки

В формате <support@client.ru>

### 5. Имя разработчика

Указываем имя и фамилию, на кого регистрировали аккаунт или название компании, если аккаунт регистрировали на юр. лицо.

### 6. Категория&#x20;

Нужно выбрать меньшее из зол.&#x20;

Бизнес, Газеты и журналы, Дети, Еда и напитки, Здоровье и фитнес, Игры, Каталоги, Книги, Медицина, Музыка, Навигация, Новости, Образ жизни, Образование, Погода, Покупки, Производительность, Путешествия, Развлечения, Социальные сети, Спорт, Справочники, Утилиты, Финансы, Фото и видео.

### 7. Номер версии

Номер версии приложения передает разработчик вместе с билдами самого приложения.&#x20;

### 8. URL-адрес рекламного сайта&#x20;

URL-адрес сайта клиента. Будет отображаться в App Store.

### 9. Политика конфиденциальности&#x20;

Нужно вставить ссылку на политику конфиденциальности [https://site-name.ru/legal/privacy-policy](https://yarollov.ru/legal/privacy-policy). Подставив домен клиента.

### 10. Снимки экрана&#x20;

Снимки экрана должны быть в формате JPG или PNG и цветовом пространстве RGB.&#x20;

Не более пяти снимков для каждого типа устройства. Типов устройств шесть:&#x20;

* 6,5-дюймовый дисплей
* 5,8-дюймовый дисплей (генерируется из 6,5-дюймового дисплея)
* 5,5-дюймовый дисплей
* 4,7-дюймовый дисплей (генерируется из 5,5-дюймового дисплея)
* 4-дюймовый дисплей (генерируется из 5,5-дюймового дисплея)
* 3,5-дюймовый дисплей (генерируется из 5,5-дюймового дисплея)

С подробной информацией о требованиях к графическим данным можно ознакомиться [на сайте Apple](https://help.apple.com/app-store-connect/#/devd274dd925). Итого, нужно загрузить скриншоты для 6,5 и 5,5 дюймовых экранов и остальные размеры сгенерируются на базе этих.

Видео о приложении — по желанию. Требования: формат M4V, MP4 или MOV. Не более 500 MB.&#x20;

### 11. Иконка

В формате JPG или PNG, в цветовом пространстве RGB и с разрешением не менее 72 точек на дюйм. Никаких закругленных углов, Apple сам все сделает. Разрешение 1024 x 1024 пикселей.

### 12. Авторские права&#x20;

Имя лица или название организации, которые владеют уникальными правами на приложение. Указывается после года получения прав (если применимо). Например, «2008 ИП Иванов И.И.»

### 13. URL-адрес службы поддержки

URL-адрес службы поддержки приложения. Будет отображаться в App Store.

### 14. Контактная информация

Сотрудник вашей организации, с которым можно связаться в случае возникновения вопросов при публикации. Укажите имя, почту, номер телефона сотрудника.&#x20;

### 15. Примечания&#x20;

Дополнительная информация о приложении, которая может помочь при проверке. До 4000 символов.

### 16. Пользовательское соглашение

Указываем эпловское соглашение.

### 17. Что нового

Предоставьте информацию о том, что нового в этой сборке и что необходимо протестировать. До 3 600 символов.

### 18. Возрастной лимит&#x20;

Если есть.

### 19. Демонстрационная учетная запись&#x20;

Предоставьте имя пользователя и пароль для учетной записи с полным доступом. Если Apple не сможет залогиниться в приложении для проверки, то отклонит его. Если предусмотрена авторизация через смс, обязательно предоставьте номер телефона для Apple, на который компания может позвонить и запросить код подтверждения для входа в приложение.&#x20;

### <br>


# Перенос Apple приложения в свой аккаунт разработчика

1. В разделе «Приложения» выберите свое приложение.
2. Нажмите «Информация о приложении» в разделе «Общие» на боковой панели и прокрутите до раздела «Дополнительная информация».
3. Нажмите «Перенести приложение».

   Вам может быть предложено ввести код проверки двухфакторной аутентификации для продолжения.&#x20;
4. Если все критерии выполнены, нажмите Продолжить. В противном случае нажмите `Отмена` и решите проблемы.
5. Введите Apple ID владельца учетной записи получателя и идентификатор команды для учетной записи и нажмите «Продолжить». При переносе приложения к нам, следует указать следующие данные:\
   **teamID:** NPKAZGS99H\
   **apple id:** <tech@zenky.io>
6. Ознакомьтесь с условиями, выберите «Я прочитал(а) и согласен(сна) с соглашением, представленным выше», затем нажмите «Запросить передачу».
7. Нажмите «Готово», чтобы вернуться на страницу информации о приложении.


# Продление подписки Apple Developer Program

1. Потребуется доступ к аккаунту владельца `owner` в `Apple Developer Program`. Для оплаты будем использовать счет мобильного телефона. Рекомендуется использовать оператора МТС.
2. Нужно взять сим-карту МТС иополнить ее на 10000 рублей, немного с запасом, для спокойствия
3. Далее понадобится iPhone или iPad. Авторизоваться на этом устройстве при помощи учетной записи, которая является владельцем аккаунта в `Apple Developer Program`.
4. В настройках iPhone нужно перейти в раздел аккаунта (верхний пункт, названный именем аккаунта), далее в Оплата и доставка `Payment & Shipping`.
5. Затем выбрать пункт **Добавить способ оплаты** `Add Payment Method`, мобильный телефон, выбрать **Использовать этот номер** `Use This Mobile Number`, если сим-карта вставлена в этот iPhone, или выбрать соседний пункт и ввести номер руками, продолжить. Произвести подтверждение через код из смс.
6. Теперь скачиваем приложение `Apple Developer`, авторизовываемся.

   <figure><img src="/files/g2bXk9uD1zjwNLOF7GO5" alt=""><figcaption></figcaption></figure>

   <figure><img src="/files/vm4EB6ec3tvUJWvVAevY" alt=""><figcaption></figcaption></figure>
7. Далее следует открыть приложение `Apple Developer`, перейти в раздел `Account`, нажать на `Renew`, и подтвердить оплату.

   <figure><img src="/files/yc6YQBFrPT4xfXQUlAYZ" alt=""><figcaption></figcaption></figure>


# Google PlayMarket


# Добавление ссылки на Android приложение на сайт

Зайдите в `Магазин - Каналы продаж` и добавьте ID приложение в Google Play Market.

Для этого найдите страницу приложения в Play Market и скопируйте ссылку на страницу приложения. У вас получится ссылка:

* `https://play.google.com/store/apps/details?id=`**`io.zenky.yaposha`**`&hl=ru`

Нужно скопировать ID приложения — **`io.zenky.yaposha`** И вставить ID в соответствующее поле на странице настройки приложения&#x20;

<figure><img src="/files/UH3Np6CmTTWOpPcrSElp" alt=""><figcaption></figcaption></figure>

После добавления ссылки у вас в подвале сайта появится логотип со ссылкой на приложение. По клику на иконку приложения клиент перейдет в Play Market и скачает приложение.

![](/files/-MASBF0fPo821MIS3zcz)


# Создание аккаунта разработчика в Google Play

### Создаем аккаунт разработчика в Google Play

Чтобы получить доступ к загрузке своих приложений, нужно зарегистрироваться в Google Play Console. Для этого у вас должен быть Google-аккаунт. Рекомендуем заводить не на личный, а создать новый, вдруг будете продавать приложение.

Ссылка на [создание Google Аккаунта](https://accounts.google.com/?ref=vc.ru).

![Создание Google-аккаунта](https://leonardo.osnova.io/713dc119-9748-4f63-6b84-a5ce86b9d4da/-/resize/1100/)

Нажмите «Создать аккаунт» и выберите, с какой целью регистрируете аккаунт: для себя или для бизнеса.

![Создание Google-аккаунта](https://leonardo.osnova.io/30f5e6dd-0d8c-ae80-e965-d30c2f7e4b6d/-/resize/1100/)

Введите свой номер телефона и подтвердите его. Если вы ранее регистрировали аккаунт с помощью этого номера телефона, то Google может запретить его использовать. В таком случае легче всего использовать другой номер.

![Создание Google-аккаунта](https://leonardo.osnova.io/32c4746f-4c50-2381-97ee-56c43e8d874c/-/resize/700/)

Заполните анкету и нажимайте кнопку «Далее».

![Создание Google-аккаунта](https://leonardo.osnova.io/47321c04-da84-f53f-39db-c595c68f78b8/-/resize/700/)

Примите пользовательское соглашение, и ваш аккаунт готов.\
Можно переходить по ссылке на [Google Play Console](https://play.google.com/apps/publish/signup/)

![Регистрация в Google Play Console](https://leonardo.osnova.io/44d18105-19bd-7c49-13e5-2da3dc7cc3ea/-/resize/1100/)

Примите пользовательское соглашение.

![Регистрация в Google Play Console](https://leonardo.osnova.io/507c5c6b-0687-aa3b-ead8-948dc52f8f06/-/resize/1100/)

И переходите к оплате. Удовольствие иметь аккаунт разработчика в Google стоит $25, платится один раз и навсегда.

![​Регистрация в Google Play Console](https://leonardo.osnova.io/bf479caf-713f-59ae-3ee5-7445ddecda9c/-/resize/1100/)

После оплаты у вас появится доступ к Google Play Console и [можно будет загружать приложение](/app/android/google-play-publish).


# Оформление страницы в Google Play

Зарегистрировав [аккаунт разработчика](/app/android/google-play), вы сможете загружать приложения в Google Play с помощью Play Console.

## Создать новое приложение

1. Откройте [Play Console](https://play.google.com/apps/publish/).
2. Выберите **Создать приложение.**

   <figure><img src="/files/LqbdvIiunpQ3QEN5dPym" alt=""><figcaption></figcaption></figure>

3\. Выберите язык по умолчанию и укажите название, под которым приложение будет доступно в Google Play

<figure><img src="/files/h453Xm5pzfUCInXabYWw" alt=""><figcaption></figcaption></figure>

Прожимаем два флажка и жмем кнопку "Создать приложение"

<figure><img src="/files/nI2pfqWSzXAbTmwtNgeW" alt=""><figcaption></figcaption></figure>

## Блок «Описание приложения»

1. Теперь заходим в только что созданное приложение и литаем левое меню до блока `Развитие`
2. Добавьте информацию о приложении кликнув в левом меню `Страница приложения → Описание приложения` &#x20;

* Название приложения
* Краткое описание приложения
* Полное описание приложения.

  <figure><img src="/files/JCZB9bJveadZ8QyUSqz2" alt=""><figcaption></figcaption></figure>

3\. Добавьте иконку приложения размером 512x512 пикселей, а также картинку описания 1024х500 БЕЗ прозрачности, в PNG формате.

<figure><img src="/files/YPPcBggtY1Fuoko7HSHC" alt=""><figcaption></figcaption></figure>

4\. Добавьте скриншоты основных экранов приложения и рекламную картинку для отображения в каталоге приложений. Формат JPG или PNG без прозрачности. Минимум два и максимум 8 скриншотов. Минимальная ширина скриншота 320px и максимальная высота 3840px.  <br>

<figure><img src="/files/JVy8W0wJwPnM8ik6edq9" alt=""><figcaption></figcaption></figure>

5\. Далее идем на страницу Настройки для `Google Play` и указываем `Тип приложения → Приложение` и `Категорию → Еда и напитки` (пример), а также заполняем контактную информацию ответственного лица магазина

<figure><img src="/files/BCVS0Hxbfja0jAnNu8Tu" alt=""><figcaption></figcaption></figure>

6\. Добавьте теги к вашему приложению для более удобного поиска

<figure><img src="/files/DgFcWvZy2c80RDRph4F3" alt=""><figcaption></figcaption></figure>

В поисковой строке вводите желаемый тег и выбираете его из списка, кликнув кнопку Добавить.

<figure><img src="/files/6XCVk5gQ4llQejVHuqyL" alt=""><figcaption></figcaption></figure>

## Блок «Контент приложения»

Листаем левое меню до раздела `Правила и программы`, затем кликаем на строку `Контент приложения`

<figure><img src="/files/poZO6zr4cvM0DC101LSF" alt=""><figcaption></figcaption></figure>

Начинаем поочередно заполнять декларации

<figure><img src="/files/sLpSZwNp9qazy20ZC0zk" alt=""><figcaption></figcaption></figure>

### 1. Политика конфиденциальности

Нажимаем кнопку `Заполнить деларацию` и переходим на страницу ввода ссылки на текст политики конфиденциальности, где указываем ссылку  вида `https://ваш-сайт.ru/legal/privacy-policy`

<figure><img src="/files/RuXKsFWfQ2DVkVqK94Bi" alt=""><figcaption></figcaption></figure>

Жмем кнопку "Сохранить" и возвращаемся обратно в `Контент приложения`

### 2. Реклама в приложении

Наше приложение не содержит рекламы, поэтому выбираем вариант `Нет` и жмем `Сохранить`.

<figure><img src="/files/ylLzUELcjRxerH5d3ekR" alt=""><figcaption></figcaption></figure>

### 3. Доступ к приложениям

<figure><img src="/files/yFdpcUP392itQCVIYc9l" alt=""><figcaption><p>Выбираем, что есть ограниченный доступ и кликаем "добавить инструкцию"</p></figcaption></figure>

Заполняем строки согласно скриншоту, затем листаем в самый низ, ставим галочку и в конце нажимаем синюю кнопку `Добавить`, а затем `Сохранить`

<figure><img src="/files/82yfM0F4BEmfKBAYiEWO" alt=""><figcaption></figcaption></figure>

### 4. Возрастные ограничения

<figure><img src="/files/QMZtJIh5Gwb12u7hzBxU" alt=""><figcaption></figcaption></figure>

В категории прописываем имейл клиента для связи по вопросам ограничений, или <zenkyapp@gmail.com>. Выбираем пункт `Все другие типы приложений`. Жмем кнопку `Далее`.

<figure><img src="/files/jo0EinD6rHXPFfvF5Da7" alt=""><figcaption></figcaption></figure>

Затем отвечаем на вопросы анкеты. Как правило, везде ставится `Нет`, но бываются исключения, например, если магазин торгует алкоголем, товарами с возрастными ограничениями и т.п. Как заполнили, жмем кнопку `Сохранить`, затем `Далее`. В 3м пункте `Сводка` жмем `Сохранить`.

<figure><img src="/files/Rf9RGmykmL59LwxJDyIv" alt=""><figcaption></figcaption></figure>

Попадаем в окно со сводкой введенной информации, где всегда можно изменить email и пройти опрос заново

<figure><img src="/files/tn9mot7ZNCUypAPQfd7D" alt=""><figcaption></figcaption></figure>

### 5. Целевая аудитория и контент

Здесь, во избежание всеразличных подстав, рекомендуется указывать возраст от 18 лет

<figure><img src="/files/QvdGPWPx1x8iBLt7UmTi" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Hymr7BGuzmqqj1PoAqVk" alt=""><figcaption><p>Жмем <code>Нет</code> и в следующей вкладке - <code>Сохранить</code></p></figcaption></figure>

### 6. Новостные приложения

<figure><img src="/files/rjrw73Fp3wuyUakfvd3q" alt=""><figcaption><p>Жмем <code>Нет</code> и затем <code>Сохранить</code></p></figcaption></figure>

### 7. Безопасность данных

<figure><img src="/files/QfoihxVqb4FLrQsdcThH" alt=""><figcaption></figcaption></figure>

Далее заполняем согласно скриншоту, а в последнее поле ввода вставляем ссылку [`https://zenky.io/tpost/bas48cikb1-udalenie-akkaunta-v-prilozhenii`](https://zenky.io/tpost/bas48cikb1-udalenie-akkaunta-v-prilozhenii)\
Больше здесь ничего заполнять не нужно

<figure><img src="/files/WQhx5qycwUHTV3cj1aL1" alt=""><figcaption></figcaption></figure>

В пункте `Типы данных` необходимо проставить галочки на `Приблизительное местоположение`

<figure><img src="/files/l38wYbY4hvTTg7fUx3XI" alt=""><figcaption></figcaption></figure>

`Имя`, `Электронный адрес`, `Адрес`, `Номер телефона`

<figure><img src="/files/6bwoNfSVLJ27MZTRglX2" alt=""><figcaption></figcaption></figure>

`Отчеты об ошибках`

<figure><img src="/files/Eu4ntQt8NouvmLOrQEmi" alt=""><figcaption></figcaption></figure>

`Идентификаторы устройства или другие идентификаторы`

<figure><img src="/files/iMxpb3baMerWSMY9UBtZ" alt=""><figcaption></figcaption></figure>

Теперь поочередно заполняем все выбранные пункты.&#x20;

<figure><img src="/files/APa7MksQOws4DhxJurQh" alt=""><figcaption></figcaption></figure>

Для первых 4х галочки выглядят так:

<figure><img src="/files/3J7i0ozvLeDaJW60uwDj" alt=""><figcaption></figcaption></figure>

`Приблизительное местоположение`

<figure><img src="/files/8daCWISjka5YcsO6RQI9" alt=""><figcaption></figcaption></figure>

`Отчеты об ошибках`

<figure><img src="/files/K3rV3CEjKCIw7UPjxnvH" alt=""><figcaption></figcaption></figure>

`Идентификаторы`

<figure><img src="/files/HrQPskD0dRYIA9d3ldDO" alt=""><figcaption></figcaption></figure>

Когда все заполнили - жмем `Далее`, и на следующем экране - `Сохранить`

### 9. Рекламный идентификатор

<figure><img src="/files/sdKJN7XvXswQbZpCcJQM" alt=""><figcaption></figcaption></figure>

### 10. Приложения гос. учреждений

<figure><img src="/files/yzLu7ddFNv8n8QuZOwVo" alt=""><figcaption></figcaption></figure>

### 11. Финансовые функции

<figure><img src="/files/rCXqk4eIeWvibxfKTjoN" alt=""><figcaption><p>После нажатия кнопки <code>Далее</code> - жмем на три точки в правом нижнем углу и сохраняем</p></figcaption></figure>

### 12. Приложения для здоровья

<figure><img src="/files/XCN0jkbUqzlKBwb3kTQN" alt=""><figcaption></figcaption></figure>

Поздравляем! Вы справились с заполнением деклараций! Осталось совсем чуть-чуть!

## Загрузить рабочую версию приложения

<figure><img src="/files/H6TGYNMyKVn1BA5mMKs5" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/FgEFDPrjs8mwTBShDl3r" alt=""><figcaption></figcaption></figure>

И финальное действие - Опубликовать рабочую версию и нажать кнопку `Далее`

<figure><img src="/files/cLSLm4jCZQ4egyE6z9AG" alt=""><figcaption></figcaption></figure>

УРА! Поздравляем! Приложение ушло на проверку и публикацию и в течение 1-3 дней приложение будет выпущено в Play Market


# Перенос Android приложения в свой аккаунт разработчика

Как перенести приложение к себе на аккаунт и обновить его, заменив своей новой сборкой и не потерять установки.

## Перенос android приложения на ваш Google аккаунт <a href="#id-obnovlenieprilozheniyaandro-razrabotannogostoronnimrazrabotchikom-dlyaperenosaprilozheniyananuzhn" id="id-obnovlenieprilozheniyaandro-razrabotannogostoronnimrazrabotchikom-dlyaperenosaprilozheniyananuzhn"></a>

### Войти в раздел переноса приложений на аккаунте Источнике

**Войти в Google console - Источник** и перейти в раздел переноса приложения по ссылке и заполнить форму → <https://play.google.com/console/developers/app-transfer>

<figure><img src="/files/bwI4osSXBWwpxfmRQ8gd" alt=""><figcaption><p>Раздел "Перенос приложений"</p></figcaption></figure>

{% hint style="info" %}
Ниже представлена форма переноса. Заполнив ее вы сможете отправить запрос на перенос в целевой аккаунт.
{% endhint %}

<figure><img src="/files/D2iExZ8hZ68btlKrz50h" alt=""><figcaption><p>Форма переноса приложения</p></figcaption></figure>

### Идентификатор транзакции (первое поле)

Идентификатор транзакции для аккаунта разработчика, из которого переносятся приложения (Источник). Эти данные указаны в письме, отправленном после оплаты регистрации на электронную почту владельца исходного аккаунта.

### Новый аккаунт разработчика

Это имеется ввиду Целевой - ваш аккаунт. Укажите почту на которую он зарегистрирован.

### Идентификатор транзакции для нового аккаунта

Данный индентификаторы вы найдете в почте в пиьме от Google Payments или на сайте Google Payments.

### Причина переноса и деловые отношения

Укажите подходящие причины или укажите "Другое".

После заполнения формы нажмите кнопку внизу экрана `Проверить и перенести`.

<figure><img src="/files/9gm8LxSeK7dhxjY6FnLP" alt=""><figcaption></figcaption></figure>

### **Теперь требуется подождать. Перенос займет до 2-х рабочих дней.**

Приложение появится в вашем аккаунте, когда Google проверит трансфер и одобрит его. После этого вы сможете оновить приложение с заменой на новое без потери установок и отзывов. [Как заменить приложение читайте в инструкции.](#obnovit-android-prilozhenie-v-google-play-zameniv-svoim)

{% hint style="info" %}
Ссылка на инструкцию по переносу приложения от Google: [https://support.google.com/googleplay/android-developer/answer/623024](https://support.google.com/googleplay/android-developer/answer/6230247?visit_id=636940402360220865-424994289\&rd=1)
{% endhint %}

### **Где найти идентификатор транзакции аккаунта?**

#### 1. Можно найти на почте от аккунта

Письмо от Google Payments с темой Google: информация о покупке, номер заказа Google

<figure><img src="https://wiki.foodsoul.pro/download/thumbnails/48365632/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202019-05-21%20%D0%B2%2016.02.13.png?version=1&#x26;modificationDate=1558444841000&#x26;api=v2" alt=""><figcaption></figcaption></figure>

#### 2. Можно найти на странице Google Payments

Чтобы получить индетификтаор:

1. Войдите в [Google Payments](https://payments.google.com/payments/home) по емейлом от аккаунта аразработчика.
2. В меню слева выберите **Подписки и услуги**.
3. На карточке "Другие покупки" выберите **Просмотреть покупки**.
4. Выберите регистрационный платеж Google Play (или Android Market).

Идентификаторы транзакций имеют один из следующих форматов:

* `01234567890123456789.token.0123456789012345`
* `0.G.123456789012345`
* `Registration-1234ab56-7c89-12d3-4567-8e91234567f8`
* `PDS.1234-5678-9012-3456`

Копируйте идетификатор и вставляйте в форму переноса приложения.

## Обновить android приложение в Google Play, заменив своим

После того как вы перенесли приложение от предыдущего разработчика на свой аккаунт - его можно обновить на наше приложение.&#x20;

Чтобы не потерять аудиторию вам нужно обновить приложение, заменив его нашим. И после обновления клиенты передут на новое приолжение и не будут потеряны.

{% hint style="info" %}
Для обновления приложения стороннего разработчика потребуется ключ подписи. Этим ключом подписывается приложение при выпуске в Google Play.&#x20;
{% endhint %}

Ключ подписи - это файл с расширением .keystore.&#x20;

Так же нужны данные для ключа:

* key store password
* key alias
* key password

**Без ключа подписи и данных** обновить стороннее приложение **не получится**.

Если ключ и данные есть, необходимо, чтобы приложение было на Вашем аккаунте. При наличие ключа и данных, а так же приложения на Вашем аккаунте, необходимо к нам в техподдержку, чтобы осуществить обновление приложения.

Если приложение находится на вашем аккаунте и у вас есть ключ и данные к нему, то напишите в техподдержку и запросите обновление.<br>

\ <br>


# Обновить и заменить android приложение в Google Play на новое

Если вы хотите старое приложение заменить на наше не потеряв установки, отзывы и рейтинг.

После того как вы перенесли приложение от предыдущего разработчика на свой аккаунт - его можно обновить на наше приложение.&#x20;

Чтобы не потерять аудиторию вам нужно обновить приложение, заменив его нашим. И после обновления клиенты передут на новое приолжение и не будут потеряны.

{% hint style="info" %}
Для обновления приложения стороннего разработчика потребуется ключ подписи. Этим ключом подписывается приложение при выпуске в Google Play.&#x20;
{% endhint %}

Ключ подписи - это файл с расширением .keystore.&#x20;

Так же нужны данные для ключа:

* key store password
* key alias
* key password

**Без ключа подписи и данных** обновить стороннее приложение **не получится**.

Если ключ и данные есть, необходимо, чтобы приложение было на Вашем аккаунте. При наличие ключа и данных, а так же приложения на Вашем аккаунте, необходимо к нам в техподдержку, чтобы осуществить обновление приложения.

Если приложение находится на вашем аккаунте и у вас есть ключ и данные к нему, то напишите в техподдержку и запросите обновление.


# Для чего необходима подпись приложения?

Приложения, которые планируется публиковать в сторах, необходимо подписать сертификатом разработчика. Подпись гарантирует, что разработчик приложения именно вы. Подпись всегда проверяется при обновлении приложения.&#x20;

Подпись необходимо хранить также, как и свой пароль. Потеряв подпись, вы не сможете больше обновлять свое приложение.&#x20;

Подписание приложение - обязательная процедура для приложений всех платформ.&#x20;


# Как получить подпись для приложений Android?

Вы можете сгенерировать ключ разработчика двумя способами:&#x20;

**Генерация ключа подписи с помощью Android Studio**&#x20;

Установите Android Studio на свой компьютер и запустите программу.&#x20;

Вам потребуется создать ключ загрузки и хранилище ключей. Сделать это можно следующим образом:&#x20;

1\. В строке меню выберите “Сборка" - "Сборка" - "Создать подписанный пакет / APK”.&#x20;

2\. В диалоговом окне "Создать подписанный пакет или APK" выберите "Пакет приложений Android" или "APK" и нажмите "Далее".

3\. Ниже поля для Путь к хранилищу ключей нажмите “Создать новый”.&#x20;

4\. В окне "Новое хранилище ключей" укажите следующую информацию о вашем хранилище ключей и ключе:&#x20;

**- Keystore**&#x20;

* **Путь к хранилищу ключей:** выберите место, где должно быть создано хранилище ключей.&#x20;
* **Пароль:** создайте и подтвердите безопасный пароль для вашего хранилища ключей.&#x20;

**- Ключ**

* **Псевдоним:** введите идентифицирующее имя для вашего ключа.&#x20;
* **Пароль:** создайте и подтвердите безопасный пароль для вашего ключа. Это должно отличаться от пароля, который вы выбрали для хранилища ключей&#x20;
* **Срок действия (в годах):** установите период времени, в течение которого ваш ключ будет действителен. Ваш ключ должен быть действителен в течение не менее 25 лет, чтобы вы могли подписывать обновления приложения одним и тем же ключом в течение срока службы вашего приложения.&#x20;
* **Сертификат:** введите некоторую информацию о себе для своего сертификата. Эта информация не отображается в вашем приложении, но включена в ваш сертификат как часть APK.&#x20;

7\. Заполнив форму, нажмите кнопку ОК.&#x20;

Теперь вы можете перейти в папку, которую указали для хранения ключей и скопировать файл \*keystore.&#x20;

**Генерация ключа подписи с помощью Keytool**&#x20;

1\. Загрузите и установите [Java](https://www.java.com/en/download/).&#x20;

2\. Установить каталог [Java\_Home](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/index.html).

3\. Откройте командную строку (cmd.exe) как администратор, затем выполните следующую команду:\
`$ keytool -genkey -v -keystore [keystore_name].keystore -alias [alias_name] -keyalg RSA -keysize 2048 -validity 10000`

4\. Keytool запросит пароль хранилища ключей. Введите пароль и подтвердите.&#x20;

5\. Далее keytool запросит дополнительную информацию - имя, страну и т.д. Укажите всю требуемую информацию.&#x20;

6\. Затем keytool запросит пароль для псевдонима. Вернитесь, если он совпадает с паролем хранилища ключей. В противном случае введите пароль и подтвердите.

7\. Готово - ваш ключ готов к копированию!&#x20;

Скопированный файл ключа, вы можете добавить в Личном кабинете в качестве подписи для приложения Android.


# Как получить Sender ID и Server Key в Firebase

1. Перейдите в [консоль Firebase](https://console.firebase.google.com/). Если у вас ещё нет учётной записи, создайте её, авторизовавшись через gmail-аккаунт, и воспользуйтесь [инструкцией по регистрации приложения в Firebase](https://docs.edna.ru/kb/kak-zaregistrirovat-prilozhenie-v-firebase/).
2. Перейдите к проекту приложения, нажмите на иконку Настройки и выберите **Project Settings**.

<figure><img src="https://docs.edna.ru/wp-content/uploads/2022/02/firebase-key-1-1024x281.png" alt=""><figcaption></figcaption></figure>

3\. Выберите вкладку **Cloud Messaging** и скопируйте параметры **Sender ID** и **Server key**.

<figure><img src="https://docs.edna.ru/wp-content/uploads/2022/02/SenderIDandAPIKey-2-1.png" alt=""><figcaption></figcaption></figure>

4\. Вставьте параметры Sender ID и Server key в соответствующие поля настроек Андроид-приложения в edna.


# Обновление приложения с версии 1.0 на 2.0

🔄 Обновление приложения с версии 1.0 на 2.0

Так как наш конструктор постоянно обновляется - периодически нужно будет обновлять и интерфейс приложения.

Теперь каждый магазин сможет ускорить обновление своего приложения, настроив конструктор и нарисовав баннеры для AppStore и Google Play.\
\
Для этого необходимо будет:

1. Настроить конструктор приложения
2. Обновить скриншоты и баннеры приложения

По первому пункту есть [исчерпывающая инструкция](https://help.zenky.io/app/builder/visual).

По второму пункту - вы можете воспользоваться [нашим шаблоном](https://www.figma.com/file/BLfOd5sKXIp9ZOwsDl2YKq/Zenky-Store-Demo-AppStore?type=design\&node-id=0%3A1\&mode=design\&t=IqreBSrvLIjIBBEE-1) и отредактировать его.&#x20;

Если не нравится наш шаблон, то можете [подготовить свой дизайн по образцу](https://help.zenky.io/app/builder/appbanners).&#x20;

В итоге у вас должны присутствовать вследующие материалы:

{% hint style="info" %}
1\. По 6 скриншотов для  мобильных устройств с дисплеями 5.5'', 6.5'', 6.7''\
2\. Иконки приложения для AppStore (1024х1024) и Google Play (512x512) в формате .png без прозрачного фона.\
3\. Баннер для Google Play (1024х500)
{% endhint %}

Если приложение выпускалось на наших девелоперских аккаунтах - необходимо передать эти материалы нам в [тех поддержку](https://t.me/ZenkyBizBot).

Если у вас свой девелоперский аккаунт - необходимо разместить все материалы  самостоятельно как в этих статьях - [Apple](/app/ios/app-store-publish) и [Google](/app/android/google-play-publish), обновить описания, информацию, если требуется, и отправить на проверку.\
\
Если у вас нет людей которые могли бы заняться производством материалов выше - напишите нам в [тех поддержку](https://t.me/ZenkyBizBot) для платного обновления.


# AppMetrica

Для отслеживания целевых действий в приложении - необходимо подключить к нему AppMetrica

Для того, чтобы подключить АппМетрику - необходимо уже иметь счетчик ЯндексМетрики. \
Создать его самому можно воспользовавшись [этой инструкцией](https://help.zenky.io/website/metrika/sozdanie-schetchika).

Идем по адресу - <https://appmetrica.yandex.ru/> и логинимся через свою яндекс почту.\
Далее, жмем на список приложений в левом верхнем углу и тыкаем кнопку "Добавить приложение".

<figure><img src="/files/sguKFVv6Pn9jp9L2pmuu" alt=""><figcaption></figcaption></figure>

В открывшемся окне - вставляем ссылки на наше приложение, которые берем прямо в сторах. Заполняем необходимые данные и жмем - продолжить.

<figure><img src="/files/rmgb57foXEZhtXkcneJt" alt=""><figcaption></figcaption></figure>

В появившемся окне копируем свой API key

<figure><img src="/files/TJLtUA9l28NeaAq2XsqE" alt=""><figcaption></figcaption></figure>

И идем с ним в Админку в конструктор приложения

<figure><img src="/files/dESgYOjTWOI9B4JKnvQ2" alt=""><figcaption></figcaption></figure>

Выбираем интеграции в левом меню и вставляем ключ в соответствующее поле\
![](/files/k4H2K8nABrSaVzJclzrn)

Затем опять идем на сайт АппМетрики, жмем настройки и заполняем данные, в том числе привязываем уже имеющийся у нас счетчик ЯндексМетрики.<br>

<figure><img src="/files/1fnhsnt25BZkAKLTaaJ8" alt=""><figcaption></figcaption></figure>

Вставляем ваш bundle ID  в соответствующее поле и кликаем две галочки. Затем сохраняем.

<figure><img src="/files/w2yRQ7Oy5L7eAR7SNGWt" alt=""><figcaption></figcaption></figure>

Свой bundle ID можно найти в админке. Магазин - Каналы продаж.

<figure><img src="/files/7165JYKZ2EV2sJuUY8aT" alt=""><figcaption></figcaption></figure>

Теперь выдаем доступы на яндекс почты всем, кому надо, особенно если делаем АппМетрику не для себя.

<figure><img src="/files/bXNLgmfD4g312F92qBHI" alt=""><figcaption></figcaption></figure>

Остался последний шаг! Создать трекер и сгенерировать умную ссылку!

<figure><img src="/files/BOXoeftwNT2JQsOGRy3h" alt=""><figcaption></figcaption></figure>

Вписываем название вашего магазина и создаем нового партнера

<figure><img src="/files/I1P7U1FsEXh3JEfLxBCv" alt=""><figcaption></figcaption></figure>

Добавляем три ссылки как на изображении, где Fallback - это ссылка на ваш сайт.

<figure><img src="/files/ffy59M3mfrvNRKPqF8zV" alt=""><figcaption></figcaption></figure>

Здесь обычно нужно подождать, пока данные подгрузятся в АппМетрику, потому что кнопка "Сохранить" становится активной только после этого. Для ускорения процесса можно скачать свое приложение, установить его и полазить/потыкать в меню, каталоге, на страницах. Когда на вкладке "Обзор" появятся хоть какие-то данные - можно повторить операцию по созданию трекера, и кнопка будет активной.

<figure><img src="/files/z93ih0cvawj0ro78XNBq" alt=""><figcaption></figcaption></figure>

Не забываем скопировать умную ссылку. Ее можно зашить в QR-код и использовать в промо-материалах!


# Импорт клиентской базы

Для переноса вашей клиентской базы из внешних систем в Zenky вы можете воспользоваться импортом покупателей через файлы CSV (Comma-separated values) или XLSX (Excel).

## Требования к файлу импорта

Перед тем, как загружать файл с покупателями, его нужно привести в определённый формат:

1. На первой строке файла должны идти заголовки полей: `phone,first_name,last_name,birth_date,gender,email,balance,bonuses_level_id` (именно в таком порядке);
2. На второй и последующих строках должны идти данные каждого покупателя (один покупатель — одна строка). Описание и порядок полей см. ниже;
3. Каждый файл может содержать **не более 1 000** покупателей. Если в файле перечислено больше покупателей, они будут проигнорированы. Для загрузки более 1 000 покупателей вам нужно разбить вашу базу на несколько файлов;
4. Файл должен иметь кодировку **UTF-8** без заголовка (BOM). При использовании иных кодировок могут возникнуть проблемы с отображением имён и фамилий;
5. У файла должно присутствовать расширение **.csv** или **.xlsx**. Если файл имеет другое расширение или не имеет его, он будет расценен как **.csv**-файл.

## Описание полей

Каждый покупатель может иметь следующий набор полей:

* `phone` — номер телефона (с 8 или +7). Обязательное поле **\[1]**;
* `first_name` — имя покупателя;
* `last_name` — фамилия покупателя;
* `birth_date` — дата рождения в формате **ГГГГ-ММ-ДД** (например: 1991-09-20);
* `gender` — пол покупателя. Возможные значения: `male` (мужской), `female` (женский) и `other` (не указан);
* `email` — адрес электронной почты покупателя;
* `balance` — баланс бонусов покупателя **\[2]**;
* `bonuses_level_id` — ID бонусного уровня, который нужно назначить покупателю. ID нужных уровней можно скопировать в разделе **"Лояльность" -> "Бонусные уровни"**, нажав на кнопку в столбце **"ID"**.

***\[1]** Если телефон не указан или указан неправильно, этот покупатель будет пропущен (лимит в 1000 покупателей при этом не увеличивается). Если один и тот же номер телефона присутствует в одном файле (или в нескольких), все данные будут перезаписаны последней позицией.*&#x20;

***\[2]** Если баланс не указан (поле пропущено через запятую), то текущий баланс существущего покупателя не будет перезаписан. Однако, если в этом поле указано любое значение, баланс будет изменён. Обратите внимание, что **знак пробела будет преобразован в 0** и баланс покупателя **обнулится**.*

## Пример файла

Ваш файл импорта должен выглядеть примерно следующим образом:

```
phone,first_name,last_name,birth_date,gender,email,balance,bonuses_level_id
+79641234567,Иван,Иванов,1996-10-31,male,ivanov@example.org,500,94494c63-e7b3-4f1a-bea3-59fb8c482405
+79831234567,Полина,Петрова,1991-03-29,female,petrova@example.org,,
+79021234567,Анна,,,,,1024,
```

На первой строке файла расположены обязательные заголовки полей. На второй строке перечислены все поля для покупателя Иван Иванов. На третьей строке у покупателя Полина Петрова указаны все поля кроме баланса и ID бонусного уровня. На четвёртой строке у покупателя Анна указаны только номер телефона, имя и баланс бонусов.

## Импорт данных

После того, как вы подготовите файл, перейдите в раздел **"Продажи" -> "Покупатели"** в панели администратора Zenky и нажмите на кнопку **"Импорт"** справа над таблицей.

<figure><img src="/files/LiBK7rcg81CmMyNzOqah" alt=""><figcaption></figcaption></figure>

В интерфейсе импорта покупателей вы сможете отслеживать статус обработки загруженного файла. Имейте в виду, что вы не сможете загрузить новый файл, пока не завершится обработка предыдущего.

<figure><img src="/files/Pv06K2wMbBHuEYnB4j9e" alt=""><figcaption></figcaption></figure>

Нажмите на кнопку **"Выбрать файл"** и укажите расположение нужного вам файла. После выбора начнётся автоматическая загрузка.

Когда загрузка файла будет завершена, начнётся его обработка, а под кнопкой "Выбрать файл" появится информационное окно.

В информационном окне будет указан ID задачи импорта, её статус и количество импортированных покупателей. **Скопируйте и сохраните ID задачи на случай, если возникнут проблемы.** Этот ID нужно будет передать в техническую поддержку, без него нам будет сложно определить причину проблем.

<figure><img src="/files/HdHfGduZ58QC82mYgExO" alt=""><figcaption></figcaption></figure>

Вы можете не ждать и закрыть браузер, импорт в этом случае не прервётся. После завершения импорта статус задачи в информационном окне изменится на "Выполнен".

<figure><img src="/files/593yJ5IeM0lUhpMBTzII" alt=""><figcaption></figcaption></figure>

Если вы закрыли окно во время импорта, а после открытия информационного окна нет, это означает, что импорт завершился. Если вы считаете, что во время импорта что-то пошло не так, напишите нам в чат или на <tech@zenky.io>, предоставив название магазина, ID задачи и описание проблемы.

**Обратите внимание, что данные существующих покупателей будут перезаписаны, в том числе их баланс (если указан) и бонусный уровень (если указан).**


# Интеграция с iiko

Интеграция сайта и мобильного приложения с iiko

* Необходимые лицензии и требования к настройке
* Настройка/регистрация iiko.biz/Transport
* Настройка iikoOffice
* Выгрузка внешнего меню для сайта в iikoOffice
* Подключение сайта и приложения Zenky к iiko.biz/Transport для обмена
* Ручная синхронизация
* Возможные ошибки


# Интеграция iikoDelivery с сайтом и приложением Zenky

## Что необходимо для подключения iiko к сайту?

Чтобы принимать заказы с сайта в iiko и обмениваться позициями меню с сайтом, вам потребуется:

* Купить лицензию на модуль iikoDelivery, если у вас одна точка — 11 490₽
* Купить дополнительно iikoCallCenter, если у вас несколько точек и нужно распределять заказы между точками на основе зон доставки — 14 390₽
* Зарегистрироваться в iiko.biz
* Купить подписку в iiko.biz на модуль API iikoDelivery — 500₽ в месяц
* Выгрузить внешнее меню для сайта в iikoOffice
* Подключить сайт и приложение Zenky к iiko.biz
* Сделать первую синхронизацию
* Исправить возможные ошибки

## Регистрация iiko.biz

Начиная с версии iiko 4.2 регистрация осуществляется через iikoOffice.&#x20;

Для регистрации в iiko.Biz зайдите в iikoOffice, выберите в левом меню раздел `«Обмен данными → iiko.Biz → Состояние подключения»`. Если вы еще не зарегистрированы система предложит Вам совершить регистрацию на портале iiko.Biz.

В открывшемся окне введите данные в поля:

![](/files/-MMMMC7zmd5Bg4IsYvBO)

* **Название предприятия** – наименование, которое вводится системой автоматически в соответствии с настройками вашего торгового предприятия.
* **Адрес** – адрес места расположения вашего торгового предприятия.
* **Валюта** – валюта, в которой ваше торговое предприятие выполняет продажи. Поле заполняется системой автоматически в соответствии с настройками валюты.
* **ФИО администратора** – фамилия, имя, отчество сотрудника, ответственного за управление учетной записью вашей организации на портале iiko.biz.
* **E-mail (логин)** – адрес электронной почты. Этот адрес будет использоваться вами для входа в личный кабинет на сайте iiko.biz.

  | ![Information](https://ru.iiko.help/resources/Storage/iikocard/info.png) | Электронный адрес должен быть уникальным на сайте iiko.biz, ранее не использовавшимся для регистрации. |
  | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
* **Пароль** – пароль для входа в личный кабинет на сайте iiko.biz.

Если уже `зарегистрированы`, то система покажет вам окно с состоянием подключения. Убедитесь, что все значения горят зеленым цветом.

![](/files/-MMMNvxyLShsMeAy1RP7)

## Подключить модуль API iikoDelivery на сайте iiko.biz

* Войдите в свой личный кабинет на сайте [iiko.biz](http://iiko.biz/) под учетной записью, которую вы создали ранее.
* Перейдите в меню `Приложения → Список`**.**
* Подключите приложение `API iikoDelivery` - найдите его в списке приложений, выберите и нажмите `Подключить`
* Введите логин и пароль и обязательно его запишите и сохраните в удобном месте. В будущем этот пароль не будет храниться на сайте и вы не сможете его вспомнить. **Поэтому обязательно сохраните**.
* Именно этот логин и пароль нужно будет внести в настройки обмена с сайтом (см. ниже)
* На адрес электронной почты, который вы указали при регистрации, вам придет счет на оплату лицензий. Оплатите его в течение месяца. Иначе через месяц доступ к API будет запрещен.

![](/files/-MMM_7Aj0UeMqwxZYq3w)

## Подготовка меню для выгрузки на сайт

* Откройте iikoOffice
* Выберите пункт в левом меню `Доставка → Терминалы доставки` - это список точек на которые будут отправляться заказы.
* В списке должен быть хотя бы один зарегистрированный терминал.&#x20;
* Нажмите `Зарегистрировать`, если таких зарегистрированных терминалов.
* Перейдите в левом меню в раздел `Обмен данными → iiko.Biz → Выгрузка меню`

![](/files/-MMMR_0NKJqeKR9zX_dJ)

* Перед вами откроется окно с двумя секциями. В верхней секции будет расположено меню со структурой для выгрузки на сайт. В нижней секции будет указан список номенклатуры с товарами как они забиты в вашу систему.
* Поэтому задача  — в верхней части добавить категории товаров `кнопка «Добавить группу».`&#x20;
* Добавить блюда из номенклатуры — выделите категорию в верхней таблице и в нижней таблице выбелите нужные блюда удерживая кнопку `Shift или Ctrl` для множественного выделения.&#x20;
* Затем нажмите `«Добавить выбранные товары»`
* Как сформируете полное меню для выгрузки, нажмите на кнопку под нижней таблицей `«Выгрузить»`
* После этого iikoOffice выгрузит все товары в iiko.biz, от куда их уже заберет сайт и мобильное приложение Zenky

![](/files/-MMMU65yMOWntfy8-iWg)


# Подключение и настройка Iiko Biz

## Подключение Iiko Biz к вашему магазину Zenky

* Перейдите в раздел [«Магазин» -> «Обмен данными»](https://my.zenky.io/dashboard/store/profile/exchange) в панели управления Zenky;
* В выпадающем списке **«Внешняя система»** выберите систему учета **«Iiko Biz»**`;`

<figure><img src="/files/U4CME1jyN8HHusNsNm2h" alt=""><figcaption><p>Выбор внешней системы</p></figcaption></figure>

* После выбора внешней системы вам станут доступны дополнительные поля – **«Логин API Iiko Biz»**, **«Пароль API Iiko Biz»** и **«Организация»**. Сначала введите логин и пароль от API Iiko Biz, а затем нажмите на кнопку **«Загрузить список организаций»** под полем ввода пароля.\
  \
  Если логин и пароль указаны верно, в поле **«Организация»** появится список организаций, которые подключены к указанному логину API Iiko Biz. В случае ошибки проверьте введённые данные;
* Выберите нужную организацию и нажмите на кнопку **«Подключить внешнюю систему»**;

<figure><img src="/files/F2cEsbF99xtyD8cc2LY1" alt=""><figcaption><p>Настройки подключения к API Iiko Biz.</p></figcaption></figure>

### Настройки обмена с Iiko Biz

После успешного подключения вам станут доступны дополнительные настройки обмена. Некоторые из них следует настроить сразу после подключения обмена, чтобы все функции интеграции работали корректно (сопоставление способов оплаты; сопоставление статусов заказов).

Часть настроек обмена расположены в форме, которая отображается на странице, часть же – в **дополнительных действиях**, список которых расположен в начале страницы.

<figure><img src="/files/CLBga1hzVYLPHVi09HgR" alt=""><figcaption><p>Список дополнительных действий Iiko Biz.</p></figcaption></figure>

#### Сопоставление способов оплаты

Для того, чтобы мы могли отправлять заказы в Iiko с правильным указанием способа оплаты, вам необходимо сопоставить типы оплаты из Iiko со способами оплаты Zenky. Сделать это можно в дополнительном действии **«Сопоставление способов оплаты»**, которое доступно в начале страницы.

Нажмите на ссылку **«Сопоставление способов оплаты»**. Вы увидите всплывающее окно, в левой части которого будут перечислены доступные типы оплаты Iiko, а в правой – выбор способа оплаты Zenky для каждого типа оплаты Iiko.

Выберите нужный способ оплаты Zenky для каждого типа оплаты Iiko и сохраните список. **Обратите внимание, что каждый способ оплаты Zenky можно выбрать только один раз.**

<figure><img src="/files/75bF55UYJyy6AQ60auFQ" alt=""><figcaption><p>Окно сопоставления способов оплаты Iiko и Zenky.</p></figcaption></figure>

#### Сопоставление статусов заказов

Если вы хотите, чтобы статусы заказов автоматически изменялись в Zenky после их изменения в Iiko, сначала вам нужно сопоставить статусы из Iiko со статусами из Zenky.

Нажмите на ссылку **«Сопоставление статусов заказов»** в верхней части страницы. Во всплывающем окне вам нужно будет выбрать аналогичный статус из Iiko для статуса Zenky (необязательно сопоставлять абсолютно все статусы).

<figure><img src="/files/On6xfgy7J6Zj759rk7Eo" alt=""><figcaption><p>Окно сопоставления статусов заказов Iiko и Zenky.</p></figcaption></figure>

Как минимум один статус должен быть отмечен как **«Завершающий»**. Это означает, что как только заказ в Iiko перейдёт в один из таких статусов, мы перестанем запускать проверку статуса для такого заказа. Обычно завершающими статусами являются **«Закрыта»** («Выполнен») и «Отменена» (**«Отменён»**).

**Обратите внимание, что каждый статус Iiko можно выбрать только один раз.**

После того, как вы завершите сопоставление статусов, нажмите на кнопку **«Сохранить»** (может потребоваться проскроллить всплывающее окно).

<figure><img src="/files/cyaXU8npG09ZGKBAoxPM" alt=""><figcaption><p>Окно сопоставления статусов заказов Iiko и Zenky.</p></figcaption></figure>

#### Сопоставление терминалов Iiko и складов Zenky

Если вы хотите, чтобы оформленные заказы падали сразу на конкретный терминал (в зависимости от склада, с которым связан заказ Zenky), вам нужно сопоставить каждый терминал Iiko с нужным складом Zenky.

{% hint style="warning" %}
Если вы используете **колл-центр** и распределяете заказы самостоятельно, **не выполняйте это сопоставление**. Если вы уже сопоставили терминалы со складами и хотите отменить это, выполните очистку данных ([см. ниже](#ochistka-dannykh)), выбрав только опцию **«Удалить терминалы»**.
{% endhint %}

Нажмите на ссылку **«Сопоставление терминалов и складов»** в списке дополнительных действий (в верхней части страницы). В этом окне выберите терминал Iiko для подходящего склада Zenky (сопоставлять все склады необязательно).

<figure><img src="/files/Ezv8fYf6anuL6C924hAK" alt=""><figcaption><p>Окно сопоставление терминалов Iiko со складами Zenky.</p></figcaption></figure>

После завершения сопоставления нажмите на кнопку **«Сохранить»**.

#### Настройки номенклатуры

{% hint style="info" %}
Здесь и далее (если не указано иначе) будут перечислены настройки, которые находятся в основной форме.
{% endhint %}

В настройках номенклатуры вы можете отключить автоматическую синхронизацию каталога (из вашего Iiko в ваш магазин Zenky), выбрать режим обмена фотографиями и уточнить, что именно использовать в качестве категорий товаров – группы товаров или категории товаров.

<figure><img src="/files/9nEeOPc14YDk9fcSaC6J" alt=""><figcaption><p>Список настроек номенклатуры.</p></figcaption></figure>

Если вы отключите синхронизацию каталога, вам по-прежнему будет доступна ручная синхронизация ([см. ниже](#ruchnaya-sinkhronizaciya-kataloga)).

По умолчанию для товаров используются только фотографии из Iiko, но если вы хотите дополнительно загрузить фотографии в панели управления Zenky, измените настройку **«Режим обмена фотографиями товаров»** на **«Использовать фотографии из Iiko и загруженные вручную»**. Режим **«Использовать только фотографии, загруженные вручную»** полностью отключает импорт фотографий товаров из Iiko.

Если во время подключения интеграции вы выбрали неправильное значение настройки **«В качестве категорий использовать»**, после её изменения вам потребуется очистить обменник Iiko и выполнить ручную синхронизацию каталога ([см. ниже](#ruchnaya-sinkhronizaciya-kataloga)).

Настройка **«Использовать фотографии групп»** позволяет загружать изображения групп из Iiko в категории товаров Zenky (но только если в качестве категорий у вас используются группы).

#### Настройки заказов

В настройках заказов вы можете отключить или включить **отправку заказов** в Iiko (при этом возможность оформления заказа на сайте или в приложении отключена не будет; так же вы продолжите получать уведомления о новых заказах в Telegram или на почту), **проверку статусов** (для работы этой функции необходимо сопоставить статусы заказов; [см. выше](#sopostavlenie-statusov-zakazov)), добавление номера заказа и связанного склада в комментарии к заказам.

<figure><img src="/files/U1zMiKnZ7A5yQIDecMB3" alt=""><figcaption><p>Список настроек заказов.</p></figcaption></figure>

Настройка **«Проверять статусы перенесённых заказов»** может быть полезна, если у вас несколько точек и вы переносите оформленные заказы между ними. С выключенной настройкой перенесённый заказ получит статус **«Отменён»**, который отобразится в истории заказов на сайте или в мобильном приложении (так же покупатель может получить пуш-уведомление об отмене заказа, если они у вас подключены).

Вместо этого мы можем попытаться отследить статус нового заказа (перенесённого на другую точку) и обновлять исходный заказ в Zenky  с его информацией. ID нового заказа определяется с помощью API Iiko Biz (мы проверяем поле `movedDeliveryId`).

Эта функциональность может отслеживать цепочку до 5 заказов. Если заказ был перенесён более 5 раз, мы завершим проверку статусов и отметим его как отменённый.

#### Покупатели

Раздел **«Покупатели»** позволяет уточнить, какие данные покупателей будут отправляться в базу Iiko (во время отправки заказов).

<figure><img src="/files/5Hq5Gq9xYODTlxfqexBT" alt=""><figcaption><p>Список настроек покупателей.</p></figcaption></figure>

* В режиме **«Перезаписывать всегда»** имя, фамилия и дата рождения покупателей будут перезаписываться данными из Zenky в любом случае, даже если они указаны в профиле Iiko. Например, если в базе Iiko покупатель записан как «Иван Иванов», а в базе Zenky – «Ivan Ivanov», после отправки заказа в базе Iiko имя и фамилия станут «Ivan Ivanov»;
* В режиме **«Перезаписывать пустые значения»** данные покупателя будут отправлены в Iiko, только если они не указаны. Например, покупатель с именем Иван (но без фамилии) после отправки заказа будет записан как «Иван Ivanov». Мы рекомендуем использовать этот режим.

Важно отметить, что если какие-то данные покупателя не указаны в базе Zenky, информация в базе Iiko не будет перезаписана пустыми значениями в любом из указанных режимов.

#### Iiko Card

Если вы используете Iiko Card и у вашего магазина Zenky подключена программа лояльности, в этом разделе вы можете указать дополнительные параметры обмена бонусами.

<figure><img src="/files/P3oVhhcvIGk3ikDA5P5l" alt=""><figcaption><p>Список настроек Iiko Card.</p></figcaption></figure>

* Настройка **«Тип кошелька бонусной программы»** отвечает за то, кошельки с каким типом будут использоваться для синхронизации бонусов между Iiko Card и Zenky. В большинстве случаев её значением должно быть **«Вещественный кошелёк IikoCard (IikoCard)»**, но в некоторых случаях может использоваться другой тип. Обратитесь к вашему системному администратору Iiko или интегратору, чтобы уточнить необходимый тип.
* С помощью настройки **«Способ синхронизации бонусов из Iiko Card в Zenky»** вы можете выбрать как именно бонусы из Iiko Card будут передаваться в программу лояльности Zenky. \
  \
  Способ **«Корректировка баланса»** будет создавать одну транзакцию пополнения или списания бонусов в Zenky – например, если баланс покупателя в Zenky – 500 бонусов, а в IikoCard – 250, то во время синхронизации будет создана одна транзакция корректировки на списание 250 бонусов (при этом изначально баланс в Iiko мог быть изменён несколькими транзакциями). \
  \
  Способ **«Изменение баланса»** будет создавать отдельные транзакции пополнения или списания бонусов после каждой операции в iiko.\
  \
  Мы рекомендуем использовать способ **«Корректировка баланса»**.
* Настройка **«Поведение при корректировке бонусов»** может быть полезна, если вы используете несколько кошельков Iiko Card. По умолчанию при корректировке мы берём баланс только из первого кошелька с нужным типом (настройка **«Тип кошелька бонусной программы»**). При работе с несколькими кошельками бонусы могут синхронизироваться некорректно, поэтому вы можете поменять значение на **«Использовать баланс всех подходящих кошельков»** – в этом случае мы просуммируем баланс бонусов.
* В списке **«Начисления бонусов Zenky, которые нужно отправлять в Iiko Card»** вы можете выбрать типы транзакций Zenky, которые должны изменять баланс покупателя в Iiko Card. Например, если вы используете программу «Пригласи друга» в Zenky, бонусы за приглашения друзей не будут отправляться в Iiko Card, пока вы не выберете тип **«Награда за приглашение»** в этом списке.\
  \
  **Важно**: если вы начисляете кэшбэк на стороне Iiko Card, не выбирайте тип транзакции **«Кэшбэк»** из этого списка. Так же в настройках бонусной программы (раздел [**«Лояльность» -> «Бонусная система»**](https://my.zenky.io/dashboard/store/profile/loyalty)) вам нужно поменять значение настройки **«Обработчик кэшбэка»** на **«Внешняя система»**. В противном случае покупатель может получить два кэшбэка – один от Zenky и один от Iiko Card.
* В настройке **«Кошелёк для пополнения баланса в Iiko Card»** вы можете выбрать конкретный кошелёк, в который будут отправляться бонусы из Zenky. Если вы используете один кошелёк, можете оставить значенеи этой настройки по умолчанию (**«Использовать первый подходящий кошелёк»**).

#### Стоп-листы

{% hint style="info" %}
Для работы стоп-листов необходимо включить проверку остатков товаров при добавлении товара в корзину или во время оформления заказа. Сделать это можно включив настройку **«Проверка остатков товаров»** в разделе **«Магазин» -> «Настройка заказов»**. Выберите любой режим проверки и укажите этап проверки остатков.
{% endhint %}

Если синхронизация стоп-листов включена, остатки всех товаров из вашего стоп-листа будут передаваться в Zenky. Когда остатки в стоп-листе достигнут нуля, заказы с этим товаром нельзя будет оформить (если включена проверка остатков).

<figure><img src="/files/ZapzlSAlWoHZGYSFSmSg" alt=""><figcaption><p>Список настроек стоп-листов.</p></figcaption></figure>

Настройка **«Поведение остатков при удалении товара из стоп-листа»** отвечает за поведение, когда товар **удаляется** из стоп-листа. Например, вы добавили некий товар в стоп-лист с нулевыми остатками. Через какое-то время вы вернули его в продажу и удалили из стоп-листа. В зависимости от того, какое значение выбрано у этой настройки, товар либо станет доступен для заказа в Zenky, будет снят с продажи или же будет проигнорирован (остатки в Zenky не изменятся).

Так же вы можете выбрать откуда брать стоп-лист – либо только из организации, для которой подключен обмен с Iiko, либо из всех доступных организаций, которые подключены на вашем аккаунте API Iiko Biz.

#### Правила форматирования улиц

В некоторых базах Iiko могут наблюдаться проблемы с приёмом заказов с сайта или из приложения – бывает, что локальная база адресов имеет некоторые различия и из-за этого не может определить адрес доставки. Например, в вашей базе все улицы могут быть записаны как «Ленина улица», «Октябрьская улица» и т.д., в то время как мы отправляем адрес доставки без указания типа улицы – просто «Ленина» или «Октябрьская».\
\
Если вас коснулась эта проблема, мы можете добавить свои правила форматирования улиц, и мы будет формировать адрес доставки в соответствии с этими правилами.

<figure><img src="/files/nnsbuYMZjW5zeB6jIOGo" alt=""><figcaption><p>Раздел «Правила форматирования улиц»</p></figcaption></figure>

Вы можете добавить несколько правил для тех типов улиц, которые в вашей базе записаны по-особому. Поле **«Расположение»** отвечает за то, где подставлять тип улицы – до названия («улица Ленина») или после («Ленина улица»). Поле **«Тип названия»** задаёт короткое название типа улицы («ул») или полное («улица»).

Заполните все поля, чтобы увидеть предпросмотр строки улицы, которая будет отправлена в Iiko.

{% hint style="info" %}
Перед тем, как добавлять правила, проконсультируйтесь с вашим системным администратором Iiko или с интегратором. Возможно, в вашей базе улицы заполнены без типов, поэтому добавлять правила не потребуется.

Мы используем базу ФИАС, которую получаем от сервиса Dadata.ru.&#x20;
{% endhint %}

### Ручная синхронизация каталога

Вы можете выполнить ручную синхронизацию каталога из базы Iiko в базу Zenky, не дожидаясь автоматической выгрузки (происходит раз в 20 минут, если каталог в Iiko изменился).

В верхней части страницы вы увидите список дополнительных действий Iiko Biz. Найдите пункт **«Ручная синхронизация»** и нажмите на него. В открывшемся окне вы можете указать дополнительные параметры ручной синхронизации.

<figure><img src="/files/EksMxFWb3DaPeB4zjHQZ" alt=""><figcaption><p>Окно ручной синхронизации каталога из Iiko в Zenky.</p></figcaption></figure>

* **«Игнорировать ревизию каталога»** – синхронзация будет выполнена, даже если каталог в Iiko не изменился. Если настройка не выбрана и каталог не менялся, данные не будут повторно выгружены в Zenky;
* **«Выгрузить весь каталог»** – если выбрано, в Zenky будет передан весь каталог Iiko (товары, категории и модификаторы). В противном случае мы выгрузим только те данные, которые были изменены после последней синхронизации.

После запуска синхронизации данные поступят в каталог Zenky спустя несколько минут (обычно – не более 5 минут, но в некоторых случаях время ожидание может быть увеличено).

### Проверка номенклатуры

Если какие-то товары или категории в вашем каталоге не отображаются (или отображаются неправильно), вы можете проверить актуальный ответ API номенклатуры от Iiko Biz.

Сделать это можно, нажав на пункт **«Проверка номенклатуры»** в списке дополнительных действий Iiko Biz (в начале страницы).

В открывшемся окне нажмите на кнопку **«Загрузить номенклатуру»**. Ответ API будет доступен в текстовом поле (формат JSON). Для проверки данных вам может потребоваться помощь вашего системного администратора Iiko или интегратора.

<figure><img src="/files/9afgCYLFWKgm4x0Jk8e2" alt=""><figcaption><p>Окно проверки ответа API номенклатуры Iiko Biz.</p></figcaption></figure>

При проверке обращайте внимание на номер ревизии (поле `revision`) и дату последней выгрузки (поле `uploadDate`). Если необходимые данные присутствуют в выгрузке, но не появляются в каталоге Zenky после принудительной ручной синхронизации, вам может потребоваться очистка данных обменника Iiko.

### Очистка данных

Мы храним копию вашего каталога Iiko в промежуточном сервисе, который мы называем обменником Iiko. С его помощью мы определяем какие данные изменились (чтобы не синхронизировать весь каталог постоянно), принимаем заказы из Zenky и отправляем их в Iiko, а так же выполняем дополнительные сервисные действия (проверка статусов заказов, синхронизация бонусов и стоп-листов и т.д.).

Если вы заметили какие-то неточности в каталоге или хотите полностью сбросить все данные и начать с чистого листа, вам поможет очистка данных в обменнике Iiko.

{% hint style="info" %}
Мы удаляем только те данные, которые храним у себя. Никакие очистки данных не удалят информацию из вашей базы Iiko.
{% endhint %}

Найдите пункт **«Очистка данных»** в списке дополнительных действий Iiko Biz (в начале страницы) и нажмите на него. В открывшемся окне вы можете выбрать, какие именно данные нужно удалить.

<figure><img src="/files/Iwzm0sGGpF8HIQXN3BIe" alt=""><figcaption><p>Окно очистки данных в обменнике Iiko.</p></figcaption></figure>

* **«Удалить категории»** – из обменника будут удалены все категории товаров (или группы товаров, если в качестве категорий вы используете группы);
* **«Удалить товары»** – из обменника будут удалены все товары;
* **«Удалить модификаторы»** – из обменника будут удалены все модификаторы товаров (групповые и одиночные);
* **«Удалить стоп-листы»** – из обменника будут удалена вся информация о стоп-листах. Остатки товаров в Zenky не будут изменены;
* **«Удалить заказы»** – из обменника будут удалены все заказы, которые были ранее отправлены в Iiko (в самой базе Iiko заказы удалены не будут). Если какие-то заказы ещё находились в стадии проверки статусов, их статусы больше не будут обновляться;
* **«Удалить статусы заказов»** – из обменника будет удалено сопоставление статусов заказов Iiko и Zenky;
* **«Удалить способы оплаты»** – из обменника будет удалено сопоставление способов оплаты Iiko и Zenky;
* **«Удалить терминалы»** – из обменника будет удалено сопоставление терминалов Iiko и складов Zenky.

Выберите нужные опции и нажмите на кнопку **«Удалить данные»**. В течение нескольких минут (до пяти) данные в обменнике будут удалены, после чего вы сможете выполнить ручную синхронизацию для импорта свежих данных.

#### Очистка каталога Zenky

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

{% hint style="danger" %}
Очистка каталога Zenky крайне **не рекомендуется** для магазинов, которые уже начали работу и принимают заказы. В случае удаления товаров все заказы покупателей в Zenky будут обнулены, и у покупателей не будет возможности просмотреть историю заказов.

Так же изменятся ссылки на товары или категории. Если вы размещали ссылки на конкретные категории товаров, они перестанут работать.
{% endhint %}

Очистка каталога Zenky доступна в разделе [**«Магазин» -> «Очистка данных»**](https://my.zenky.io/dashboard/store/profile/cleanup). Очистку данных может запустить только сотрудник магазина с ролью **«Владелец»** и не чаще одного раза в 24 часа.&#x20;

После очистки каталога Zenky, повторно очистите данные обменника, подождите несколько минут и выполните ручную синхронизацию.


# Подключение и настройка Iiko Transport

Рассказываем, как подключить Iiko Transport (CloudAPI) к вашему магазину Zenky.

## Переход с Iiko Biz на Iiko Transport

Если вы переходите с Iiko Biz на Iiko Transport, вам может потребоваться дополнительная настройка на стороне Iiko. Воспользуйтесь этой статьёй из справочного центра Iiko, чтобы подготовиться к переходу с Biz на Transport – <https://ru.iiko.help/articles/#!api-documentations/perevod-klienta-s-bizapi-na-cloud-api>

Вам может потребоваться помощь ваших специалистов по Iiko.

## Подключение интеграции

Для подключения интеграции с Iiko Transport перейдите в раздел ["Интеграции"](https://my.zenky.io/dashboard/marketplace) в панели управления Zenky. На этой странице в левом меню выберите раздел **«PoS-системы»**, а затем нажмите на карточку интеграции.

<figure><img src="/files/LB89byCPnvopw8ze2Hid" alt=""><figcaption><p>Выбор интеграции с Iiko Transport.</p></figcaption></figure>

На новой странице вы увидите информацию о подключаемой интеграции. Пожалуйста, прочитайте описание полностью, потому что оно может содержать важную для вас информацию (особенно, если вы переходите с API Iiko Biz).

Так же вы можете просмотреть какие разрешения API-токена Zenky требуются интеграции, а так же какие вебхуки будут отправляться в интеграцию.

После ознакомления нажмите на кнопку **«Подключить интеграцию»** в правом боковом меню.

<figure><img src="/files/5Gz8ILiVpfplZ974PDbF" alt="" width="375"><figcaption><p>Кнопка подключения интеграции.</p></figcaption></figure>

На новой странице вам потребуется ввести ваш логин API IIko Transport. В зависимости от того, когда вы настраивали ключи на стороне Iiko, они могут выглядеть по-разному. В большинстве случаев они могут выглядеть так:

* `fdd1dc29914a43e1a5767b82a88c8c53` – 33-значная строка;
* `e22240e8-6fe` – 12-значная строка с разделителем;
* 8-значная строка или короче. Такие ключи могут иметь короткий срок жизни, поэтому их использовать не рекомендуется.

{% hint style="info" %}
Если у вас ещё нет API-логина для Iiko Transport, воспользуйтесь инструкцией в справочном центре Iiko – <https://ru.iiko.help/articles/#!api-documentations/podklyuchenie-poluchenie-api-klyucha>

Вам может потребоваться помощь ваших специалистов по Iiko.

Статья по срокам действия ключей – <https://ru.iiko.help/articles/#!api-documentations/sroki-deystviya-api-klucha>
{% endhint %}

Введите этот ключ в поле на первом этапе настройки, согласитесь с передачей токена и отправкой вебхуков разработчику интеграции, после чего нажмите на **«Подключить интеграцию»**.

<figure><img src="/files/E5unzHawBAwdjPVSO76x" alt=""><figcaption></figcaption></figure>

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

* **Импорт каталога.** Мы будем синхронизировать каталог только из этой организации (даже если на вашем логине доступны другие организации);
* **Работу Iiko Card.** Бонусы будут синхронизироваться только для покупателей, которые доступны внутри этой организации.

<figure><img src="/files/kGfpNMRnbhOfHQGRmgvc" alt=""><figcaption><p>Выбор основной организации Iiko Transport.</p></figcaption></figure>

## Настройки обмена с Iiko Transport

После успешного подключения вам станут доступны дополнительные настройки обмена. Некоторые из них следует настроить сразу после подключения обмена, чтобы все функции интеграции работали корректно (сопоставление способов оплаты; сопоставление статусов заказов; сопоставление терминалов со складами).

### Сопоставление способов оплаты

Для того, чтобы мы могли отправлять заказы в Iiko с правильным указанием способа оплаты, вам необходимо сопоставить типы оплаты из Iiko со способами оплаты Zenky. Сделать это можно в дополнительном действии **«Сопоставление способов оплаты»**, которое доступно в начале страницы.

Найдите в списке настроек блок **"Оплата".** Вы увидите окно, в левой части которого будут перечислены доступные типы оплаты Iiko, а в правой – выбор способа оплаты Zenky для каждого типа оплаты Iiko. Если у вас несколько способов оплаты - жмите кнопку `Добавить значение.`

Выберите нужный способ оплаты Zenky для каждого типа оплаты Iiko и сохраните список. **Обратите внимание, что каждый способ оплаты Zenky можно выбрать только один раз.**

<figure><img src="/files/hXFCyMjpAwhwABAMle2m" alt=""><figcaption><p>Блок сопоставления способов оплаты Iiko и Zenky.</p></figcaption></figure>

### Сопоставление статусов заказов&#x20;

Если вы хотите, чтобы статусы заказов автоматически изменялись в Zenky после их изменения в Iiko, сначала вам нужно сопоставить статусы из Iiko со статусами из Zenky.

Листаем настройки до блока **"Заказы"**. В этом окне вам нужно будет нажать на кнопку **Добавить значение** столько раз, сколько статусов вы хотите автоматизировать, а затем выбрать аналогичный статус из Iiko для статуса Zenky (необязательно сопоставлять абсолютно все статусы).

<figure><img src="/files/4g3t4RCGJ0hr6V8SHSFX" alt=""><figcaption><p>Окно сопоставления статусов заказов Iiko и Zenky.</p></figcaption></figure>

Как минимум один статус должен быть отмечен как **«Завершающий»**. Это означает, что как только заказ в Iiko перейдёт в один из таких статусов, мы перестанем запускать проверку статуса для такого заказа. Обычно завершающими статусами являются **«Закрыта»** («Выполнен») и **«Отменена»** («Отменён»).

{% hint style="info" %}
**Обратите внимание, что каждый статус Iiko можно выбрать только один раз.**
{% endhint %}

После того, как вы завершите сопоставление статусов, нажмите на кнопку **«Сохранить»** (может потребоваться проскроллить всплывающее окно).

<figure><img src="/files/c2icBwOCRGbdyoOomzWF" alt=""><figcaption></figcaption></figure>

### Сопоставление терминалов Iiko и складов Zenky

Для отправки заказов напрямую на терминалы, необходимо сопоставить склады Zenky с соответствующими терминалами Iiko.

{% hint style="warning" %}
**Обратите внимание**

По умолчанию мы будем отправлять заказы напрямую на терминалы. Это значит, что если вы работаете с Колл-центром Iiko, заказы не будут попадать к операторам КЦ, а вместо этого будут падать напрямую на кассы.

Если для вас это неприемлемо, вы можете воспользоваться **черновиками заказов** (см. ниже).
{% endhint %}

<figure><img src="/files/UOLBNdmlJfJ1geTymtaV" alt=""><figcaption><p>Сопоставление терминалов и складов.</p></figcaption></figure>

Для каждого терминала можно выбрать опцию **«Отправлять заказы напрямую»**. Если опция выбрана, то все заказы, которые будут связаны с выбранным складом Zenky, будут отправлены напрямую на сопоставленный терминал. Связь заказа со складом Zenky происходит в одном из двух случаях:

1. Если покупатель оформил заказ на самовывоз и выбрал склад в качестве точки самовывоза;
2. Если покупатель оформил заказ на доставку, а зона доставки, в которую входит адрес, привязана к текущему складу.

Кроме этого, для одного терминала можно выбрать опцию **«Использовать по умолчанию»**. На терминал, отмеченный такой опцией, будут отправляться заказы, которые не связаны ни с одним складом Zenky.

После завершения сопоставления нажмите на кнопку **«Сохранить»**.

### Настройки номенклатуры

В настройках номенклатуры вы можете отключить автоматическую синхронизацию каталога (из вашего Iiko в ваш магазин Zenky), выбрать режим обмена фотографиями и уточнить, что именно использовать в качестве категорий товаров – группы товаров или категории товаров.

<figure><img src="/files/IqrzSDOUEIHgKE8iQdHb" alt=""><figcaption></figcaption></figure>

Если вы отключите синхронизацию каталога, вам по-прежнему будет доступна ручная синхронизация ([см. ниже](#ruchnaya-sinkhronizaciya-kataloga)).

По умолчанию для товаров используются только фотографии из Iiko, но если вы хотите дополнительно загрузить фотографии в панели управления Zenky, измените настройку **«Режим обмена фотографиями товаров»** на **«Использовать фотографии из Iiko и загруженные вручную»**. Режим **«Использовать только фотографии, загруженные вручную»** полностью отключает импорт фотографий товаров из Iiko.

Если во время подключения интеграции вы выбрали неправильное значение настройки **«В качестве категорий использовать»**, после её изменения вам потребуется очистить обменник Iiko и выполнить ручную синхронизацию каталога ([см. ниже](#ruchnaya-sinkhronizaciya-kataloga)).

Настройка **«Использовать фотографии групп»** позволяет загружать изображения групп из Iiko в категории товаров Zenky (но только если в качестве категорий у вас используются группы).

### Настройки заказов

В настройках заказов вы можете отключить или включить **отправку заказов** в Iiko (при этом возможность оформления заказа на сайте или в приложении отключена не будет; так же вы продолжите получать уведомления о новых заказах в Telegram или на почту), **способ отправки заказов в Iiko**, **проверку статусов** (для работы этой функции необходимо сопоставить статусы заказов; [см. выше](#sopostavlenie-statusov-zakazov)), добавление номера заказа и связанного склада в комментарии к заказам.

<figure><img src="/files/3ho3kOaKzrrsIYu1mUtq" alt=""><figcaption><p>Настройки заказов Iiko Transport.</p></figcaption></figure>

#### Способ отправки заказов в Iiko

Интеграция с Iiko Transport поддерживает три способа отправки заказов из Zenky в Iiko:

1. **На терминалы.** Как было описано выше, с этой настройкой мы будем отправлять заказы напрямую на связанный со складом терминал (или на терминал, выбранный по умолчанию, если к заказу не привязан склад);
2. **Автораспределение.** В этом случае Iiko будет распределять заказы по терминалам самостоятельно. Для работы этой опции потребуется включить автораспределение на стороне Iiko;
3. **Черновики заказов.** Вместо отправки на терминалы мы будет создавать черновики заказов, которые будут доступны операторам облачного Колл-центра Iiko. Операторы смогут переводить черновики в подтверждённые заказы и отправлять их на конкретные терминалы самостоятельно. Для работы черновиков необходимо настроить <mark style="color:red;">**внешнее меню**</mark>. Если у вас есть терминалы со включенной опцией **«Отправлять заказы напрямую»** (в настройках интеграции Zenky с Iiko Transport), черновики для них создаваться не будут, а заказы будут уходить напрямую на такие терминалы.

<figure><img src="/files/kqgmIgViWGc0vcwwPPsF" alt=""><figcaption><p>Выбор способа отправки заказов в Iiko.</p></figcaption></figure>

#### Внешнее меню для черновиков

Для работы черновиков необходимо настроить и выгрузить в API Iiko Transport внешнее меню. После того, как вы это сделаете, в настройке **«Внешнее меню по умолчанию»** появится выбор ваших меню. Выберите нужное (если несколько) и сохраните настройки. После этого вы сможете получать заказы в виде черновиков.

<figure><img src="/files/ZaAtNUdzGQvnHuM8HDyX" alt=""><figcaption><p>Выбор внешнего меню по умолчанию.</p></figcaption></figure>

#### Проверка статусов перенесённых заказов

Настройка **«Проверять статусы перенесённых заказов»** может быть полезна, если у вас несколько точек и вы переносите оформленные заказы между ними. С выключенной настройкой перенесённый заказ получит статус **«Отменён»**, который отобразится в истории заказов на сайте или в мобильном приложении (так же покупатель может получить пуш-уведомление об отмене заказа, если они у вас подключены).

Вместо этого мы можем попытаться отследить статус нового заказа (перенесённого на другую точку) и обновлять исходный заказ в Zenky  с его информацией. ID нового заказа определяется с помощью API  (мы проверяем поле `movedDeliveryId`).

Эта функциональность может отслеживать цепочку до 5 заказов. Если заказ был перенесён более 5 раз, мы завершим проверку статусов и отметим его как отменённый.

### Покупатели

Раздел **«Покупатели»** позволяет уточнить, какие данные покупателей будут отправляться в базу Iiko (во время отправки заказов).

<figure><img src="/files/PkpMj5BiP6eHpypzUWsQ" alt=""><figcaption></figcaption></figure>

* В режиме **«Перезаписывать всегда»** имя, фамилия и дата рождения покупателей будут перезаписываться данными из Zenky в любом случае, даже если они указаны в профиле Iiko. Например, если в базе Iiko покупатель записан как «Иван Иванов», а в базе Zenky – «Ivan Ivanov», после отправки заказа в базе Iiko имя и фамилия станут «Ivan Ivanov»;
* В режиме **«Перезаписывать пустые значения»** данные покупателя будут отправлены в Iiko, только если они не указаны. Например, покупатель с именем Иван (но без фамилии) после отправки заказа будет записан как «Иван Ivanov». Мы рекомендуем использовать этот режим.

Важно отметить, что если какие-то данные покупателя не указаны в базе Zenky, информация в базе Iiko не будет перезаписана пустыми значениями в любом из указанных режимов.

### Iiko Card

Если вы используете Iiko Card и у вашего магазина Zenky подключена программа лояльности, в этом разделе вы можете указать дополнительные параметры обмена бонусами.

<figure><img src="/files/rbAVV7sN8jqKqLO8fiaM" alt=""><figcaption></figcaption></figure>

* С помощью настройки **«Способ синхронизации бонусов из Iiko Card в Zenky»** вы можете выбрать как именно бонусы из Iiko Card будут передаваться в программу лояльности Zenky. \
  \
  Способ **«Корректировка баланса»** будет создавать одну транзакцию пополнения или списания бонусов в Zenky – например, если баланс покупателя в Zenky – 500 бонусов, а в IikoCard – 250, то во время синхронизации будет создана одна транзакция корректировки на списание 250 бонусов (при этом изначально баланс в Iiko мог быть изменён несколькими транзакциями). \
  \
  Способ **«Изменение баланса»** будет создавать отдельные транзакции пополнения или списания бонусов после каждой операции в iiko.
* Настройка **«Источник бонусов для корректировки»** может быть полезна, если вы используете несколько кошельков Iiko Card. По умолчанию при корректировке мы берём баланс только из первого кошелька с нужным типом (настройка **«Кошелек для пополнения бонусов Zenky»**). При работе с несколькими кошельками бонусы могут синхронизироваться некорректно, поэтому вы можете поменять значение на **«Использовать баланс всех подходящих кошельков»** – в этом случае мы просуммируем баланс бонусов.
* В списке **«Начисления бонусов Zenky, которые нужно отправлять в Iiko Card»** вы можете выбрать типы транзакций Zenky, которые должны изменять баланс покупателя в Iiko Card. Например, если вы используете программу «Пригласи друга» в Zenky, бонусы за приглашения друзей не будут отправляться в Iiko Card, пока вы не выберете тип **«Награда за приглашение»** в этом списке.\
  \
  **Важно**: если вы начисляете кэшбэк на стороне Iiko Card, не выбирайте тип транзакции **«Кэшбэк»** из этого списка. Так же в настройках бонусной программы (раздел [**«Лояльность» -> «Бонусная система»**](https://my.zenky.io/dashboard/store/profile/loyalty)) вам нужно поменять значение настройки **«Обработчик кэшбэка»** на **«Внешняя система»**. В противном случае покупатель может получить два кэшбэка – один от Zenky и один от Iiko Card.
* В настройке **«Кошелёк для пополнения баланса в Iiko Card»** вы можете выбрать конкретный кошелёк, в который будут отправляться бонусы из Zenky. Если вы используете один кошелёк, можете оставить значение этой настройки по умолчанию (**«Использовать первый подходящий кошелёк»**).

### Стоп-листы

{% hint style="info" %}
Для работы стоп-листов необходимо включить проверку остатков товаров при добавлении товара в корзину или во время оформления заказа. Сделать это можно включив настройку **«Проверка остатков товаров»** в разделе **«Магазин» -> «Настройка заказов»**. Выберите любой режим проверки и укажите этап проверки остатков.
{% endhint %}

Если синхронизация стоп-листов включена, остатки всех товаров из вашего стоп-листа будут передаваться в Zenky. Когда остатки в стоп-листе достигнут нуля, заказы с этим товаром нельзя будет оформить (если включена проверка остатков).

<figure><img src="/files/tUypJVyIKVKxXmwncz9A" alt=""><figcaption></figcaption></figure>

Настройка **«Поведение остатков при удалении товара из стоп-листа»** отвечает за поведение, когда товар **удаляется** из стоп-листа. Например, вы добавили некий товар в стоп-лист с нулевыми остатками. Через какое-то время вы вернули его в продажу и удалили из стоп-листа. В зависимости от того, какое значение выбрано у этой настройки, товар либо станет доступен для заказа в Zenky, будет снят с продажи или же будет проигнорирован (остатки в Zenky не изменятся).

### Адреса доставки

В некоторых базах Iiko могут наблюдаться проблемы с приёмом заказов с сайта или из приложения – бывает, что локальная база адресов имеет некоторые различия и из-за этого не может определить адрес доставки. Например, в вашей базе все улицы могут быть записаны как «Ленина улица», «Октябрьская улица» и т.д., в то время как мы отправляем адрес доставки без указания типа улицы – просто «Ленина» или «Октябрьская».\
\
Если вас коснулась эта проблема, мы можете добавить свои правила форматирования улиц, и мы будет формировать адрес доставки в соответствии с этими правилами.

<figure><img src="/files/yPTK2VTcoSApCUVO28nj" alt=""><figcaption></figcaption></figure>

Вы можете добавить несколько правил для тех типов улиц, которые в вашей базе записаны по-особому. Поле **«Расположение»** отвечает за то, где подставлять тип улицы – до названия («улица Ленина») или после («Ленина улица»). Поле **«Тип названия»** задаёт короткое название типа улицы («ул») или полное («улица»).

Заполните все поля, чтобы увидеть предпросмотр строки улицы, которая будет отправлена в Iiko.

{% hint style="info" %}
Перед тем, как добавлять правила, проконсультируйтесь с вашим системным администратором Iiko или с интегратором. Возможно, в вашей базе улицы заполнены без типов, поэтому добавлять правила не потребуется.

Мы используем базу ФИАС, которую получаем от сервиса Dadata.ru.&#x20;
{% endhint %}

### Импорт каталога

Вы можете выполнить ручную синхронизацию каталога из базы Iiko в базу Zenky, не дожидаясь автоматической выгрузки (происходит раз в 20 минут, если каталог в Iiko изменился).

В столбце слева найдите пункт **"Действия"** и нажмите на него.  В открывшемся окне вы можете указать дополнительные параметры ручной синхронизации.

<figure><img src="/files/CVmOZeiSEZwJBq2E18U1" alt=""><figcaption></figcaption></figure>

* **«Игнорировать ревизию»** – синхронзация будет выполнена, даже если каталог в Iiko не изменился. Если настройка не выбрана и каталог не менялся, данные не будут повторно выгружены в Zenky;
* **«Полная выгрузка»** – если выбрано, в Zenky будет передан весь каталог Iiko (товары, категории и модификаторы). В противном случае мы выгрузим только те данные, которые были изменены после последней синхронизации.

После запуска импорта данные поступят в каталог Zenky спустя несколько минут (обычно – не более 5 минут, но в некоторых случаях время ожидание может быть увеличено).

### Проверка номенклатуры

Если какие-то товары или категории в вашем каталоге не отображаются (или отображаются неправильно), вы можете проверить актуальный ответ API номенклатуры от Iiko Biz.

Сделать это можно, с помощью блока **"Проверка номенкулатуры"**

<figure><img src="/files/gE4gtFdDQ055PCtkPYvF" alt=""><figcaption></figcaption></figure>

В открывшемся окне нажмите на кнопку **«Загрузить номенклатуру»**. Ответ API будет доступен в текстовом поле (формат JSON). Для проверки данных вам может потребоваться помощь вашего системного администратора Iiko или интегратора.

<figure><img src="/files/9cKrAdEh1OqO1CAwMOcA" alt=""><figcaption></figcaption></figure>

При проверке обращайте внимание на номер ревизии (поле `revision`) и дату последней выгрузки (поле `uploadDate`). Если необходимые данные присутствуют в выгрузке, но не появляются в каталоге Zenky после принудительной ручной синхронизации, вам может потребоваться очистка данных обменника Iiko.

### Очистка данных

Мы храним копию вашего каталога Iiko в промежуточном сервисе, который мы называем обменником Iiko. С его помощью мы определяем какие данные изменились (чтобы не синхронизировать весь каталог постоянно), принимаем заказы из Zenky и отправляем их в Iiko, а так же выполняем дополнительные сервисные действия (проверка статусов заказов, синхронизация бонусов и стоп-листов и т.д.).

Если вы заметили какие-то неточности в каталоге или хотите полностью сбросить все данные и начать с чистого листа, вам поможет очистка данных в обменнике Iiko.

{% hint style="info" %}
Мы удаляем только те данные, которые храним у себя. Никакие очистки данных не удалят информацию из вашей базы Iiko.
{% endhint %}

Найдите пункт **«Очистка данных» -** он находится в самом низу страницы **"Действия"**. В открывшемся окне вы можете выбрать, какие именно данные нужно удалить.

<figure><img src="/files/n7k4P4mrWD0g1dSsiW8i" alt=""><figcaption></figcaption></figure>

* **«Удалить категории»** – из обменника будут удалены все категории товаров (или группы товаров, если в качестве категорий вы используете группы);
* **«Удалить товары»** – из обменника будут удалены все товары;
* **«Удалить модификаторы»** – из обменника будут удалены все модификаторы товаров (групповые и одиночные);
* **«Удалить стоп-листы»** – из обменника будут удалена вся информация о стоп-листах. Остатки товаров в Zenky не будут изменены;
* **«Удалить заказы»** – из обменника будут удалены все заказы, которые были ранее отправлены в Iiko (в самой базе Iiko заказы удалены не будут). Если какие-то заказы ещё находились в стадии проверки статусов, их статусы больше не будут обновляться;
* **«Удалить статусы заказов»** – из обменника будет удалено сопоставление статусов заказов Iiko и Zenky;
* **«Удалить способы оплаты»** – из обменника будет удалено сопоставление способов оплаты Iiko и Zenky;
* **«Удалить терминалы»** – из обменника будет удалено сопоставление терминалов Iiko и складов Zenky.

Выберите нужные опции и нажмите на кнопку **«Удалить данные»**. В течение нескольких минут (до пяти) данные в обменнике будут удалены, после чего вы сможете выполнить ручную синхронизацию для импорта свежих данных.

#### Очистка каталога Zenky

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

{% hint style="danger" %}
Очистка каталога Zenky крайне **не рекомендуется** для магазинов, которые уже начали работу и принимают заказы. В случае удаления товаров все заказы покупателей в Zenky будут обнулены, и у покупателей не будет возможности просмотреть историю заказов.

Так же изменятся ссылки на товары или категории. Если вы размещали ссылки на конкретные категории товаров, они перестанут работать.
{% endhint %}

Очистка каталога Zenky доступна в разделе [**«Магазин» -> «Очистка данных»**](https://my.zenky.io/dashboard/store/profile/cleanup). Очистку данных может запустить только сотрудник магазина с ролью **«Владелец»** и не чаще одного раза в 24 часа.&#x20;

После очистки каталога Zenky, повторно очистите данные обменника, подождите несколько минут и выполните ручную синхронизацию.

## Обновление API-логина Iiko Transport

Если ваш API-логин Iiko Transport истёк, вы можете обновить его в разделе **«Действия»** вашей интеграции с Iiko Transport в панели управления магазином Zenky.

{% hint style="info" %}
Обратите внимание

В статье справочного центра Iiko дана информация о сроках действия API-ключей – <https://ru.iiko.help/articles/#!api-documentations/sroki-deystviya-api-klucha>
{% endhint %}

Перейдите в раздел ["Интеграции"](https://my.zenky.io/dashboard/marketplace) в панели управления Zenky. На этой странице выберите раздел «Установленные» и нажмите на карточку интеграции с Iiko Transport.

<figure><img src="/files/Qnxjy4muurwSr3zdK9DH" alt=""><figcaption><p>Выбор установленной интеграции Iiko Transport.</p></figcaption></figure>

На открывшейся странице выберите раздел «Действия» в левом меню. Найдите блок «Изменить API логин» и введите новый логин в поле **«Новый логин API Iiko Transport»**.

{% hint style="danger" %}
**Будьте внимательны!**

В этом поле необходимо ввести логин API, который имеет доступ к тем же организациям, что и предыдущий логин. Он должен обладать такими же разрешениями API, иначе мы не сможем корректно синхронизировать каталог и отправлять заказы в Iiko.

Пожалуйста, проконсультируйтесь с вашими специалистами по Iiko, прежде чем изменять API логин.

Если логин не подойдёт, вы увидите текст ошибки во всплывающем окне (см. ниже).
{% endhint %}

<figure><img src="/files/MfQljwPuFOnSBVsHgfnt" alt=""><figcaption><p>Интерфейс ввода нового API-логина Iiko Transport.</p></figcaption></figure>

Нажмите на **«Сохранить логин»**. После отправки данных откроется всплывающее окно, в котором вы увидите результат изменения логина.

<figure><img src="/files/AQ2DiCHvruSaQEpFZfNe" alt=""><figcaption><p>Пример успешного изменения API-логина.</p></figcaption></figure>

Выше показан пример успешного изменения логина API. Однако, вы можете увидеть одну из следующих ошибок, если что-то пошло не так:

* <mark style="color:red;">**Вы указали некорректный логин API Iiko Transport.**</mark> Возникает, когда вы ввели в поле неправильный логин. Перепроверьте значение или проконсультируйтесь с вашими специалистами по Iiko.
* <mark style="color:red;">**Не удалось получить список организаций для этого логина API Iiko Transport.**</mark> Возникает, когда введён корректный логин, но у него нет доступа ни к одной организации Iiko. Перепроверьте логин или проконсультируйтесь с вашими специалистами по Iiko.
* <mark style="color:red;">**Текущая организация отсутствует в списке организаций, полученных из Iiko Transport.**</mark> Скорее всего, вы указали логин API, который относится к другой организации. Возникает, когда у нового токена нет доступа к текущей организации по умолчанию. Организация по умолчанию задаётся в настройке «Организация по умолчанию», а отвечает за синхронизацию каталога и бонусов. Убедитесь, что у нового логина есть доступ к этой организации.


# Интеграция c 1C:Предприятие

В этом разделе мы расскажем как выгрузить товары из 1С:Розница, Управление торговлей, Управление нашей фирмой, Комплексная автоматизация.

Наша система Zenky.io может обмениваться с разными редакциями  1С с помощью нашего собственного модуля 1C Assistant и модуля 1С-Битрикс.

На данным момент мы поддерживаем обмен со следующими редакциями 1С:

* 1C:Розница 8.3 редакция 2.х через [модуль Zenky 1C Assistant](/exchange/1c/setup-assistant)
* 1С:Управление торговлей 8.3 редакция 10, 11 через [модуль 1С-Битрикс](/exchange/1c/bitrix-for-1c)
* 1С:Управление нашей фирмой 8.3 редация 10, 11 через [модуль 1С-Битрикс](/exchange/1c/bitrix-for-1c)


# Поддерживаемые конфигурации 1С: Предприятие

В таблице ниже приведены ссылки для скачивания модуля 1С-Битрикс для 1С и модуля Zenky для 1С:Розница. Эти модули позволяют настроить обмен товарным каталогом, документами, клиентами между 1С и Zenky.

Если в таблице нет нужной конфигурации 1С, значит обмен с этой версией не возможен через модуль Zenky или Битрикс. Решением для таких ситуаций может быть ограниченный обмен через стандартный модуль обмена 1С (см. инструкцию).&#x20;

1С:Розница поддерживается также нашим модулем на базе расширения - [Zenky 1C Assistant](/exchange/1c/setup-assistant).

Актуальный список совмести модуля Битрикс для 1С [доступен по этой ссылке.](https://1c.1c-bitrix.ru/ecommerce/download.php)

| Прикладное решение 1С                                                                                    | Релиз прикладного решения | Версия модуля обмена                                                                                                | Дата выхода |
| -------------------------------------------------------------------------------------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------- | ----------- |
| **Россия (На расширениях)**                                                                              |                           |                                                                                                                     |             |
| [Управление торговлей ред. 11.5](https://1c.1c-bitrix.ru/ecommerce/download.php?section=149376)          | 11.5.12.102               | [8.1.0.25](https://1c.1c-bitrix.ru/upload/iblock/d7e/4g3v9uuyof8sz5ufdvklnq3y5jwnvv29/8.1.0.25.zip)                 | 18.12.2023  |
| [Управление нашей фирмой ред. 3.0](https://1c.1c-bitrix.ru/ecommerce/download.php?section=154174)        | 3.0.5.1                   | [8.1.0.26](https://1c.1c-bitrix.ru/upload/iblock/a0d/blztl90esk7q3s0979d9rnpkpqohnfw5/8.1.0.26.zip)                 | 26.01.2024  |
| [ERP Управление предприятием 2](https://1c.1c-bitrix.ru/ecommerce/download.php?section=156188)           | 2.5.13.104                | [8.1.0.25](https://1c.1c-bitrix.ru/upload/iblock/6f0/ljzllqwljq2ldeqg7ug51qvj1ongao5q/8.1.0.25.zip)                 | 18.12.2023  |
| [Комплексная автоматизация ред. 2](https://1c.1c-bitrix.ru/ecommerce/download.php?section=156502)        | 2.5.13.104                | [8.1.0.25](https://1c.1c-bitrix.ru/upload/iblock/fc8/kohb61gnzylf3zpgv2qa3bvdrpzcqo6s/8.1.0.25.zip)                 | 18.12.2023  |
| [Розница, редакция 2.3](https://1c.1c-bitrix.ru/ecommerce/download.php?section=137456) - 1С-Битрикс      | 2.3.9.42                  | [8.0.0.19](https://1c.1c-bitrix.ru/upload/iblock/f64/0vfkst83qpp8u7ouc5r7uop013yk22io/8.0.0.19.zip)                 | 04.04.2023  |
| [Розница](/exchange/1c/setup-assistant) - 1C Zenky Assistant модуль                                      | 2.2 - 2.3                 | 1.24.0                                                                                                              | 09.09.2020  |
| **Россия**                                                                                               |                           |                                                                                                                     |             |
| [Управление торговлей ред. 10.3](https://1c.1c-bitrix.ru/ecommerce/download.php?section=62035)           | 10.3.64.2                 | [7.0.1.11](https://1c.1c-bitrix.ru/upload/iblock/14d/7.0.1.11_UT10.3.64.2.zip)                                      | 10.11.2020  |
| [Управление торговлей ред. 11.5](https://1c.1c-bitrix.ru/ecommerce/download.php?section=144110)          | 11.5.14.74                | [7.0.2.15](https://1c.1c-bitrix.ru/upload/iblock/6fb/6erjd6y2vm23k8qsu6r9vapcj2j1dwwz/7.0.2.15_UT11.5.14.74.zip)    | 24.10.2023  |
| [ERP Управление предприятием 2](https://1c.1c-bitrix.ru/ecommerce/download.php?section=62049)            | 2.5.13.104                | [7.0.2.15](https://1c.1c-bitrix.ru/upload/iblock/2f1/8acypny58dd7unon4m2c4rrumiwsvcvy/7.0.2.15_ERP2.5.13.104.zip)   | 24.10.2023  |
| [Комплексная автоматизация ред. 2](https://1c.1c-bitrix.ru/ecommerce/download.php?section=62051)         | 2.5.13.104                | [7.0.2.15](https://1c.1c-bitrix.ru/upload/iblock/fd5/cw85byi1mt7o3e2i67ypv6jvcg3adk82/7.0.2.15_KA_2.5.13.104.zip)   | 24.10.2023  |
| [Управление нашей фирмой ред. 3.0](https://1c.1c-bitrix.ru/ecommerce/download.php?section=150674)        | 3.0.5.114                 | [7.0.1.41](https://1c.1c-bitrix.ru/upload/iblock/c13/kn5t4lfnwey41dclm3od0v73v60obhf4/7.0.1.41_UNF3.0.5.114.zip)    | 24.10.2023  |
| **Беларусь**                                                                                             |                           |                                                                                                                     |             |
| [Управление торговлей ред. 3.5](https://1c.1c-bitrix.ru/ecommerce/download.php?section=153386)           | 3.5.8.343                 | [7.0.2.12](https://1c.1c-bitrix.ru/upload/iblock/564/6q4z06mmwt02uyjzodddhvwsqxx5g32g/7.0.2.12_UT3.5.8.343_Bel.zip) | 04.04.2023  |
| [Управление торговлей ред. 2.0](https://1c.1c-bitrix.ru/ecommerce/download.php?section=62079)            | 2.0.47.1                  | [7.0.1.4](https://1c.1c-bitrix.ru/upload/iblock/a9e/7.0.1.4_UT2.0.47.1_BEL.zip)                                     | 30.08.2017  |
| **Казахстан**                                                                                            |                           |                                                                                                                     |             |
| [Управление торговлей ред. 3.4](https://1c.1c-bitrix.ru/ecommerce/download.php?section=122543)           | 3.4.4.110                 | [7.0.2.15](https://1c.1c-bitrix.ru/upload/iblock/c72/2cxcjroaz9fugeo1cm9ubi1vzykb5qpc/7.0.2.15_UT3.4.4.110_Kaz.zip) | 25.10.2023  |
| [Управление торговым предприятием ред.2.0](https://1c.1c-bitrix.ru/ecommerce/download.php?section=62087) | 2.0.9.14                  | [7.0.1.4](https://1c.1c-bitrix.ru/upload/iblock/df7/7.0.1.4_UTP_2.0.9.14_KAZ.zip)                                   | 30.08.2017  |

## Установка модуля Битрикс на 1С

Мы написали инструкцию как самостоятельно установить модуль Битрикс на вашу 1С. [Читать инструкцию](/exchange/1c/bitrix-for-1c).


# Установка модуля обмена Zenky для 1С:Розница

Мы написали свой модуль обмена для 1С:Розница, т.к. Битрикс не поддерживает эту редакцию 1С. Наш модуль называется - Zenky 1C Assistant.

## 1. О модуле обмена Zenky 1C Assistant для 1С:Розница

Модуль обмена работает с 1С:Розница версии 2.2 и 2.3 и может:

* Экспортировать товарный каталог с категориями, описанием, картинками, ценами, остатками
* Экспортировать товары с характеристиками (цвет, размеры и пр)
* Экспортировать свойства товара (бренд, состав и пр) для организации фильтров в каталоге товаров
* Экспортировать склады и остатки по складам
* Принимать заказы с сайта и приложений
* Обмениваться с сайтом и приложениями статусом заказов
* Синхронизировать бонусные счета клиентов от оффлайн и онлайн покупок, чтобы в приложении и на сайте всегда был актуальный баланс

## 2. Установка модуля Zenky 1C Assistant для 1С:Розница

Требуется скачать актуальную версию модуля [Zenky 1C Assistant](https://drive.google.com/file/d/1gNC9UUHCZj5KYk9qpkfxK5qrsvVL4nBB/view?usp=sharing) и установить по инструкции ниже.&#x20;

Открыть 1С:Розница, перейти во вкладку Администрирование в левой колонке меню. Далее перейти в раздел `«Печатные формы, отчеты и обработки»`

![](/files/-M8tSLRuQ1zS875pKpiu)

Перейти в раздел `«Расширения»`

![](/files/-M8tSIPn-lBB9l_3vcvp)

Если у вас нет предыдущих установок модуля, то нажмите на кнопку `«Добавить из файла»` и выберите на диске скачанный [модуль Zenky 1C Assistant](https://drive.google.com/file/d/1gNC9UUHCZj5KYk9qpkfxK5qrsvVL4nBB/view).&#x20;

Если вы хотите обновить модуль, то нажмите кнопку `«Обновить из файла»` и также выберите на диске скачанный файл новой версии модуля обмена и установите галочку `«Безопасный режим»`.

![](/files/-M8tSFdAJGHYj6ug-RpG)

В открывшемся окне `«Предупреждение безопасности»` нажмите на кнопку `«Продолжить»`

![](/files/-M8tSDJ4ofCfcIFmgN_y)

После этого модуль будет добавлен в систему и нужно будет перезапустить 1С, чтобы модуль начал работать.&#x20;

![](/files/-M8tSB3eMWw38iFpU2lG)

## 3. Настройка модуля Zenky 1C Assistant

Для успешной работы вам потребуется ввести в модуль данные:

* Ключ обмена Zenky
* API токен вашего магазина в Zenky
* ID вашего магазина в Zenky

![](/files/-MIIjp2U4Mb-bjE5u9nU)

### Ключ обмена и ID магазина

Зайдите в свой кабинет управления магазином в раздел «[Магазин - API](https://my.zenky.io/dashboard/store/profile/api)». Скопируйте ID магазина и ключ обмена затем вставьте эти значения в модуль Zenky 1C Assistant (см. рисунок выше)

![](/files/0iXOXpaTVNHrXf21nN6T)

### API токен вашего магазина на Zenky

Для получения API токена кликните по своей аватарке в правом верхнем углу личного кабинета и перейдите в раздел API. Или воспользуйтесь ссылкой <https://my.zenky.io/dashboard/profile/api>.

Вас перекинет на страницу создания токена, где нужно:

1. Ввести название токена, любое. Например, «1С»;
2. Выбрать `«Полный доступ»;`
3. Нажать кнопку `«Создать токен».`

![Форма создания персонального API-токена.](/files/ukraXGVsdTJGwQBec9CN)

Далее нужно скопировать ваш API токен и вставить его в модуль Zenky 1C Assistant

![Результат создания персонального API-токена.](/files/BhI0gxkbdP8fOWimWbKq)

Ура! Вы связали вашу 1С:Розница и Zenky. Теперь вам нужно включить нужные галочки в модуле обмена и запустить первую синхронизацию.


# Установка модуля обмена Битрикс для 1С

Для 1С: Управление торговлей ред. 11.4. релиз 11.4.8.73

## Порядок установки модуля

Если раньше был установлен модуль обмена 4 версии, то необходимо обновить его до последней версии, а только потом устанавливать модуль обмена 5 версии

Если раньше стояла 4 версия модуля, то после обновления модуля до 5 версии – необходимо запустить внешнюю обработку, которая сконвертирует настройки обмена до 5 версии.  Обработка находится там же, где и сам модуль обмена.

0\. Выйти из всех 1С, подключенных рабочей базе, чтобы не было конфликтов и модуль установился без проблем.

1\.   Установить скачанный установщик модуля обмена для 1С: УТ, 11.4 — [Версия модуля 7.0.1.27 (скачать)](https://1c.1c-bitrix.ru/upload/iblock/50f/7.0.1.27_UT11.4.8.73.zip). Или просто [скачать распакованный файл конфигурации 1Cv9.cf](https://drive.google.com/file/u/1/d/17o45JKbp83H9jxbjCxTbgrnLuGZ3eBZz/view?usp=sharing). Если у вас другая версия 1С, то выбрать [соответствующий модуль из таблицы соответствия](https://1c.1c-bitrix.ru/ecommerce/download.php).

2\.    Запустить систему 1С:Предприятие в режиме "Конфигуратор".

![](/files/-M4XejBkc7cKWYR4wiS_)

3\.    Сделать архивную копию информационной базы. Для этого в меню "Администрирование" выбрать пункт "Выгрузка информационной базы" и в открывшемся диалоге указать имя файла, в который будут записаны данные.

![](/files/-M4TAcOFXq1CLBNhc6gD)

4\.   Открыть конфигурацию, для этого в меню "Конфигурация" выбрать пункт "Открыть конфигурацию" или нажать на соответствующую кнопку.

![](/files/-M4TAfiUfF82zwj0yzUH)

5\.   Если конфигурация закрыта для изменения(на скриншоте в дереве конфигурации соответствующий значок), то необходимо включить возможность изменения.

![](/files/-M4TAvzgIIyKahfVoAJJ)

6\.   Для того, чтобы включить возможность изменения объектов конфигурации,  необходимо в меню "Конфигурация" выбрать "Поддержка", затем "Настройка поддержки". В открывшемся окне  нажать кнопку "Включить возможность изменения". В окне "Настройка правил поддержки" выбрать дважды "Объект поставщика редактируется с сохранением поддержки", нажать "ОК". Сохранить конфигурацию.

![](/files/-M4TAywOAXhEz5IIAJyC)

![](/files/-M4TB1YKBn8oZbOl2-I9)

![](/files/-M4TBN8_SBBSWj9nO0wY)

7\.   После выполнения операции в конфигурацию 1С можно вносить изменения. Значок в дереве конфигурации оповещает об этом. После нажатия «Закрыть» система может тормозить и подвиснуть на несколько секунд или минут, следует терпеливо подождать :)

![](/files/-M4TBQPRDcPBuFFp03dm)

8\.   Вызвать режим "Сравнить, объединить с конфигурацией из файла" из меню "Конфигурация". В этом режиме будут показаны только различающиеся объекты дополнения и используемой конфигурации, поэтому полностью идентичные объекты могут отсутствовать в окне сравнения-объединения.

![](/files/-M4TBfIyBvK22VCX1FAT)

9\.   В диалоге выбора указать файл конфигурации «XXX.cf». Который вы предварительно скачали. [Скачать файл конфигурации 1Cv8.cf](https://drive.google.com/file/d/17o45JKbp83H9jxbjCxTbgrnLuGZ3eBZz/view?usp=sharing).&#x20;

Если вы распаковывали модуль через setup.exe то, по умолчанию он лежит по следующему адресу: C:\Users\\...\AppData\Roaming\1C\1Cv82\tmplts\1С-Битрикс\ ОбменСБ24\\(конфигурация 1С).&#x20;

10\.       В окне сравнения объединения **необходимо исключить из объединения все объекты**. Для этого можно снять флаг напротив названия конфигурации.

![](/files/-M4TBp3-NdXVCzKF0N8z)

11\.       Для указания объектов только устанавливаемого модуля, необходимо нажать на кнопку "Действия" – "Отметить по подсистемам файла".

![](/files/-M4X_LapxMQqVzodieLt)

![](/files/-M4TCEcObewMoYbI-Soc)

**12.** Нужно установить флажок напротив пункта «Битрикс»

![](/files/-M4TCUtUVUUce5dnuzf0)

13\.       **Также необходимо включить  подсистему «Битрикс»: "Конфигурация"  -  "Общие" – "Подсистемы"  – "Битрикс".** Если модуль ранее уже стоял, то этот пункт выполнять не нужно.

![](/files/-M4TCYAkSNeJhayZ_8Ru)

14\.       Для выполнения объединения необходимо нажать на кнопку «Выполнить».

![](/files/-M4TCmTJh-H-2nRZqq9L)

15\.       В некоторых случаях может возникнуть окно «Неразрешимые ссылки». В этом случае нужно нажать на кнопку «**Продолжить**»

![](/files/-M4TCs8a1ChHaKwUml2a)

16\.       После выполнения объединения конфигурации сохраняем конфигурацию и обновляем базу данных. Обновить базу данных можно нажав на кнопку указанную на скриншоте.

![](/files/-M4TDGIzDnK1eDVVoGDk)

17\.       Если модуль раньше не был установлен, то высветится окно с изменениями в структуре. Нужно нажать на кнопку «Принять».

![](/files/-M4TDJIA-bRznLG-1YSa)

**18.** **После установки модуля, для работы с ним, пользователям необходимо добавить роль «Роль по работе с БУС».**

![](/files/-M4Xepl8G8DUvp51LRxs)

Выбрать нужного пользователя и кликнуть на иконку редактирования

![](/files/-M4XezibEFQq_zD3FXOQ)

В открывшемся окне, перейти на вкладку **«Прочие»**

![](/files/-M4Xf3CtqaAp4ZKg15St)

В открывшемся списке ролей домотать до самого низа и выделить галочкой **«Роль по работе БУС»**

![](/files/-M4XfA3hR6L3KCuRQIHa)

19\. Ура! модуль обмена Битрикс установлен!

## **П**ечать чеков по данным с сайта

**ТОЛЬКО ДЛЯ РОССИЙСКИХ КОНФИГУРАЦИЙ**

Если необходим функционал печати чеков по данным с сайта, то необходимо доработать объект типовой конфигурации «Модуль управляемого приложения».

1\.     В режиме конфигуратора развернуть дерево конфигурации

![](/files/-M4TKutSa-i8nSXEp2s2)

2\.     Выбрать узел «Управление торговлей», нажать на правую кнопку  мыши и выбрать пункт «Открыть модуль управляемого приложения».

![](/files/-M4TKyJKU_VMGSBLtfCm)

3\.     Находим процедуру «ПриНачалеРаботыСистемы()»

**Если конфигурация 1С – УТ,** **ERP** **2 или КА 2, то добавляем в конец 3 строки:**

&#x20; `Если Б_ПечатьЧековСервер.ЭтоНужноеРабочееМесто() тогда` \
&#x20;   `ПодключитьОбработчикОжидания("БитриксПроверкаЧеков", 300);` \
`КонецЕсли;`

![](/files/-M4TL0R-7rkvtkbwMkOZ)

**Если модуль УНФ , то добавляем в конец 1 строку**

`ПодключитьОбработчикОжидания("БитриксПроверкаЧеков", 300);`

4\.     Добавляем процедуру «БитриксПроверкаЧеков()»

`Процедура БитриксПроверкаЧеков() Экспорт`\
&#x20; `лКоличествоДоков = Б_ПечатьЧековСервер.КоличествоДокументовДляЧеков();`\
&#x20; `Если лКоличествоДоков > 0 тогда`                              \
&#x20;   `Б_ПечатьЧековКлиент.ПечатьЧеков();`           \
&#x20; `КонецЕсли;`\
`КонецПроцедуры`

**При обновлении конфигураций 1С нужно следить, чтобы обновление 1С не затерло это изменение.**


# Настройка подключения модуля обмена Битрикс 1С с Zenky

Что нужно делать после установки модуля Битрикс на вашу 1С УТ или УНФ

## Настройка подключения

После установки модуля Битрикс нужно внести авторизационные данные, чтобы модуль мог подключиться к Zenky и совершать обмен. Для этого нужно внести

* Адрес сайта вида – <https://1c.exchange.zenky.io/exchange/VRwfRfSDFFSDFDsdfdsfSDFSnO> (пример);
* Логин и пароль произвольные.

![Настройка подключения 1C Битрикс модуля к Zenky](/files/-MROLatkinG59nmCP0n3)

Ссылку, по которой должен выполняться обмен, можно найти в разделе [**«Магазин» -> «Обмен данными»**](https://my.zenky.io/dashboard/store/profile/exchange) в панели управления Zenky.

<figure><img src="/files/UBTIgerfyxCBIMagafZP" alt=""><figcaption><p>URL обмена с 1С.</p></figcaption></figure>


# Интеграция c Frontpad

Чтобы связать ваш сайт и приложение Zenky.io  с системой Frontpad, вам нужно:

1. [Настроить обмен с Frontpad](/exchange/frontpad/setup)
2. [Выгрузить товары из Frontpad в Zenky](/exchange/frontpad/products-sync)
3. [Сопоставить модификаторы](/exchange/frontpad/modifiers)
4. [Настроить бонусную систему во Frontpad](/exchange/frontpad/bonuses-sync) и продублировать настройки в Zenky
5. [Установить на браузеры операторов наш модуль Zenky Frontpad Assistant](/exchange/frontpad/assitant)


# Подключение Frontpad к Zenky

Первичное подключение

## Настройка обмена данными

Перед подключением обмена данными из Frontpad в Zenky вам потребуется **API-токен Frontpad**. Обратите внимание, что Frontpad предоставляет доступ к API только для клиентов с тарифным планом **«Корпоративный»** (опция API оплачивается отдельно) или **«Профессиональный»** (API включен в стоимость тарифного плана).

## API-токен Frontpad

Получить API токен можно в раздел **«Настройки — Общие»** [личного кабинета Frontpad](https://app.frontpad.ru).

![Переход в раздел настроек в Frontpad.](/files/-MIIzR6ffW5HhQDPQ1eR)

На этой странице в пункте **«API (подключение интернет-магазина)»** нажать на кнопку **«Настроить»**.

![Получение API-токена Frontpad.](/files/-MIJ-TrK1oAqFTLuUD0J)

В открывшемся окне вы увидите API-токен. Он потребуется вам на следующем шаге.

## Подключение Frontpad к Zenky

Перейдите в раздел [**«Магазин» -> «Обмен данными»**](https://my.zenky.io/dashboard/store/profile/exchange) в панели управления Zenky. В выпадающем списке **«Внешняя система»** выберите пункт **«Frontpad»** и вставьте API-токен в соответствующее поле.

<figure><img src="/files/1cprjMPFHRQrrkBIvWrn" alt=""><figcaption><p>Подключение обмена с Frontpad.</p></figcaption></figure>

### Маска телефонов

Работа Frontpad с номерами телефонов устроена так, что один и тот же номер телефона, записанный в разных форматах, не будет считаться одним и тем же. Например, для Frontpad номера **+7 964 123-45-67** и **+7 (964) 123-45-67** – это разные телефоны (и, соответственно, разные карточки покупателей).

Чтобы избежать дублей из-за заказов, которые отправляются во Frontpad из Zenky, вы можете указать маску телефонов, под которую попадает большинство номеров в вашей базе Frontpad.

Используйте латинские буквы **X**, чтобы задать маску (символ «+» и код страны указывайте как есть). Несколько примеров масок и результатов форматирования номеров:

* Маска **«+7 (XXX) XXX-XX-XX»** отправит телефон в формате **«+7 (964) 123-45-67»**;
* Маска **«7XXXXXXXXX»** отправит телефон в формате **«79641234567»**;
* Маска **«8XXXXXXXXXX»** отправит телефон в формате **«89641234567»** и т.д.

Если поле маски оставить пустым, номера телефонов будут отправляться в формате **E.164** (+79641234567).

После указания этих данных нажмите на кнопку **«Подключить интеграцию»**. После этого вы сможете выполнить [импорт товаров из Frontpad](/exchange/frontpad/products-sync).


# Импорт товаров из Frontpad в Zenky

Узнайте, как импортировать товары и категории из Frontpad в Zenky.

{% hint style="warning" %}
Если вы импортировали товары из Frontpad в Zenky до **22 января 2024** года, перед новым импортом обязательно прочитайте раздел [**«Предыдущая версия импорта товаров»**](#predydushaya-versiya-importa-tovarov)!
{% endhint %}

## Получение файла экспорта из Frontpad

Импорт товаров из Frontpad в Zenky происходит с помощью файла экспорта каталога, который нужно скачать из интерфейса Frontpad.

Перейдите в приложение [Frontpad](https://app.frontpad.ru) и зайдите в раздел **«Справочники» -> «Товары»**. В левой части экрана (под списком категорий) вы увидите кнопку с иконкой синей стрелки. Нажмите на неё и сохраните скачиваемый файл на компьютер.

<figure><img src="/files/q8XfIVNV57eI6IJyJF43" alt=""><figcaption><p>Кнопка скачивания файла экспорта из Frontpad.</p></figcaption></figure>

## Импорт товаров и категорий в каталог Zenky

Далее, откройте раздел [**«Магазин» -> «Обмен данными»**](https://my.zenky.io/dashboard/store/profile/exchange) в панели управления Zenky и нажмите на ссылку **«Импорт товаров»** в списке **«Дополнительные действия Frontpad»**.

<figure><img src="/files/oNJQfNBb5uZ69yNPENr8" alt=""><figcaption><p>Список дополнительных действий Frontpad.</p></figcaption></figure>

В открывшемся окне выберите сохранённый файл экспорта, отметьте необходимые галочки (если вы импортируете товары впервые, отметьте все) и нажмите на кнопку **«Импортировать товары»**.

<figure><img src="/files/BSOGQNM9Hw37vC0nb5sn" alt=""><figcaption><p>Окно импорта товаров из Frontpad.</p></figcaption></figure>

После успешной обработки файла в вашем каталоге появятся категории и товары из файла экспорта. Вы можете переименовать товары и категории, а так же изменить вложенность категорий в соответствующих разделах панели управления Zenky.

{% hint style="info" %}
Если в вашей базе Frontpad есть несколько категорий с одним и тем же названием (даже если они относятся к разным родительским категориям), они будут импортированы в Zenky как одна.

Например, у вас может быть структура категорий **«Пельмени -> Замороженные»** и **«Котлеты -> Замороженные»**. В этом случае обе категории **«Замороженные»** будут объединены в одну, и в неё попадут как пельмени, так и котлеты.

Чтобы этого избежать, перед экспортом вам может потребоваться переименовать такие категории, чтобы у них были уникальные названия.
{% endhint %}

### Повторные импорты товаров

Если в вашей базе Frontpad изменились товары или добавились новые, вам необходимо повторить весь процесс заново – скачать новый файл экспорта из Frontpad, а затем импортировать его в интерфейсе Zenky.

{% hint style="warning" %}
Если вы изменяли названия или описания товаров и/или категорий, при повторных импортах не отмечайте действия **«Обновить названия товаров»**, **«Обновить описания товаров»** и **«Обновить названия категорий»**, иначе эти поля будут перезаписаны теми данными, которые сейчас указаны в вашей базе Frontpad (и, соответственно, в файле экспорта).

Новые товары и категории будут импортированы со всеми данными, даже если эти галочки не были отмечены.
{% endhint %}

### Отсутствующие товары

Мы импортируем только те товары, у которых есть название, цена и артикул. Если какие-то из товаров не появились в каталоге после импорта, убедитесь, что у них заполнены эти данные. После изменений в базе Frontpad вам потребуется выполнить новый импорт.

### Лишние категории или товары

После импорта вы можете обнаружить, что в каталоге появились лишние категории или товары (вроде товаров-модификаторов). Чтобы скрыть их, отредактируйте категории и/или товары и отметьте их скрытыми. В последующих импортах они не будут снова становиться отображаемыми, но из панели управления, к сожалению, не исчезнут.

Если вы решите их удалить, то они снова будут созданы после очередного импорта.

## Предыдущая версия импорта товаров

До 22 января 2024 года импорт товаров из Frontpad происходил иначе. Вам нужно было загрузить весь список товаров, а затем вручную распределить категории для каждого товара (предварительно создав эти категории в каталоге Zenky).

<figure><img src="/files/dsArVCcWtKhoE8Ep6A0a" alt=""><figcaption><p>Скриншот предыдущего инструмента импорта товаров из Frontpad.</p></figcaption></figure>

Если вы выполняли такие действия, **внимательно прочитайте эту информацию перед импортом из файла экспорта**!

1. Импорт из файла создаст новые категории товаров, поэтому у вас появятся **дубли категорий**. Все товары будут перемещены в новые категории;
2. Из-за этого перестанут работать ссылки на старые категории, а так же нарушится вложенность категорий (если вы её задавали для категорий, созданных вручную);
3. Если у товаров не менялся артикул во Frontpad, дубли товаров созданы не будут, ссылки на товары продолжат работать;
4. У товаров будут обновлены название и описание (данными из файла экспорта). Загруженные изображения удалены не будут.

### Импорт с минимальными затратами

Вот, что можно сделать, чтобы минимизировать ненужные изменения:

1. Отключите галочки **«Обновить названия товаров»** и **«Обновить описания товаров»** – так вы сможете сохранить текущие данные товаров;
2. Отключите галочки **«Обновить категории товаров»**, **«Обновить категории»** и **«Обновить названия категорий»** – так вы сохраните принадлежность товаров к текущим категориям, но при этом **не будут созданы новые категории**, а новые товары будут импортированы без категорий.

Таким образом, для максимальной совместимости вам нужно **отключить все галочки** перед импортом товаров через новый инструмент. После этого вам может потребоваться:

1. Создать отсутствующие категории товаров;
2. Отредактировать новые товары, присвоив им новые категории.

Все эти действия необходимо будет учитывать во время каждого последующего импорта товаров.

### Более сложный импорт

Если же вас не беспокоят сломанные ссылки на категории и вы готовы потратить некоторое время на редактирование каталога, вы можете выполнить импорт, оставив все галочки активными (или хотя бы галочки, относящиеся к категориям).

Перед этим можно сделать следующее:

1. Создать временную категорию, отметив её скрытой;
2. В редактировании вложенностью переместить все текущие категории в неё – так вы сможете временно скрыть категории, чтобы на сайте или в приложении не было видно дублей.

Далее, после импорта (с галочками, относящимися к категориям) установить новую вложенность, а затем удалить старые категории.

Все последующие импорты выполняйте без галочек **«Обновить название/описание товаров»** (если вы меняли эти данные в панели управления Zenky) и/или **«Обновить названия категорий»** (если вы переименовывали новые категории после первого импорта).

{% hint style="info" %}
Если перед импортом вы хотите проверить, как будет выглядеть каталог, вы можете создать новый тестовый магазин и сначала подключить и импортировать товары из Frontpad в него (для этого не нужна подписка на тарифный план Zenky).
{% endhint %}


# Синхронизация статусов заказов из Frontpad

Автоматическое изменение статусов в Zenky при изменении их во Frontpad.

Сопоставление статусов необходимо для корректного изменения статусов заказов автоматически через вебхуки Frontpad.&#x20;

Список кодов API статусов заказов Frontpad можно посмотреть в справочнике «Статусы» в интерфейсе Frontpad.&#x20;

Для работы вебхуков сопоставьте статусы и отметьте нужные (но не более пяти), на которые Frontpad будет отправлять уведомления к нам, а мы в свою очередь – изменять статусы заказов.&#x20;

<figure><img src="/files/m1UsQRXQg2uVSYSboZdS" alt=""><figcaption></figcaption></figure>

Коды API статусов заказов Frontpad находятся в разделе **«Справочники → Статусы»**

<figure><img src="/files/JRbt0RwPs3ypQjrnI1iF" alt=""><figcaption></figcaption></figure>

Код API статуса находится во второй колонке таблицы

<figure><img src="/files/ypLmEgM4xjYw1h18SzK6" alt=""><figcaption></figcaption></figure>

Так же не забудьте включить опцию **«Использовать вебхуки статусов заказов»** в основных настройках обмена с Frontpad.&#x20;

<figure><img src="/files/OgaGpgKmr3ZbrrVftjo3" alt=""><figcaption></figcaption></figure>

Далее укажите наш webhook URL в настройках системы Frontpad. Для этого перейдите в раздел **«Настройки - Общие»**

<figure><img src="/files/24syKBtliowiBlfgf4BU" alt=""><figcaption></figcaption></figure>

Найдите пункт **API (подключение интернет-магазина)** и нажмите кнопку **«Настроить»**

<figure><img src="/files/ksRNSOuVpONlnwMCnlyw" alt=""><figcaption></figcaption></figure>

В поле «Webhook url» Ввести адрес следующий адрес:

{% hint style="info" %}
<https://frontpad.exchange.zenky.io/api/placeholder>
{% endhint %}

<figure><img src="/files/WNgJE79QyEPbu4VHmOXg" alt=""><figcaption></figcaption></figure>

**Внимание:** после того, как вы сопоставите статусы через этот интерфейс, список статусов в расширении **Zenky Frontpad Assistant** будет отображаться некорректно. Так же вам больше не нужно будет синхронизировать заказы вручную. Если вебхуки статусов включены, ручная синхронизация будет проигнорирована.


# Сопоставление модификаторов Frontpad

Связь модификаторов Zenky и модификаторов Frontpad.

Из-за того, что работа модификаторов в Zenky и Frontpad принципиально различается, вам потребуется создать модификаторы в Zenky вручную. Мы поддерживаем одиночные модификаторы (например, «Без палочек», «Подарочная упаковка» и т.д.) и группы модификаторов (например, покупателю можно предложить выбрать размер пиццы, уровень остроты или вид упаковки).

## Подготовка модификаторов в Frontpad

Убедитесь, что у всех товаров, для которых будут добавлены модификаторы, имеют включенную настройку **«Модификаторы»** на странице редактирования товара в Frontpad.

![Галочка «Модификаторы» должна быть включена.](/files/sJZCRhx3c8bbxPTixhdQ)

Далее, убедитесь, что у каждого товара-модификатора задан уникальный артикул. Если этого не сделать, заказ может придти в Frontpad неполным.

![Поле «Артикул» должно быть заполнено уникальным значением.](/files/cmOY6iglpHpYTfAN5oZS)

После этого вы можете начать создавать модификаторы в панели управления магазином Zenky.

## Создание одиночных модификаторов

Выберите раздел [**«Каталог» -> «Модификаторы»**](https://my.zenky.io/dashboard/modifiers) в боковом меню панели управления магазином и нажмите на кнопку **«Создать»**. Укажите название модификтора, его цену (должна совпадать с ценой в Frontpad) и задайте ему артикул из Frontpad.

![Форма редактирования модификатора Zenky. Не забудьте указать артикул из Frontpad.](/files/HS3iTzzjwKwZNF4ZuLQ5)

Если у вас уже имеются созданные одиночные модификаторы, вы можете отредактировать их, присвоив им артикул из Frontpad.

После этого вы можете прикрепить одиночные модификаторы к нужным товарам (редактирование товара, вкладка **«Модификаторы»**).

![Привязка одиночного модификатора к товару.](/files/eEzQSbkJumPSBuxBIQDK)

## Создание групп модификаторов

Выберите раздел [**«Каталог» -> «Группы модификаторов»**](https://my.zenky.io/dashboard/modifiers-groups) в боковом меню панели управления магазином и нажмите на кнопку **«Создать»**.

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

![Форма редактирования группового модификатора Zenky. Не забудьте указать артикул из Frontpad.](/files/m6PlXo6xxDAnzBqGYOO9)

Если у вас уже имеются созданные группы модификаторов, вы можете отредактировать их, присвоив каждому модификатору группы артикул из Frontpad.

После этого вы можете прикрепить группу модификаторов к нужным товарам (редактирование товара, вкладка **«Модификаторы»**).

![Привязка группы модификаторов к товару.](/files/T1HhLXuokWLnbdqK1FbW)

Ваши товары готовы для работы с модификаторами. Если покупатель выберет какой-нибудь модификатор, он появится в списке заказов в интерфейсе Frontpad.

![Заказ в интерфейсе Frontpad. У товара «Канада ролл» выбраны одиночный модификатор «Без васаби» и модификатор «Очень острый» из группы «Острота».](/files/n0nExYnRZNuQOJ5H06cL)


# Сопоставление способов оплаты Frontpad

Для того, чтобы заказы отправлялись во Frontpad с правильным указанием способа оплаты, вам нужно сопоставить их со способами оплаты Zenky.

## Получение кодов оплаты Frontpad

Перейдите в приложение [Frontpad](https://app.frontpad.ru) и зайдите в раздел **«Справочники» -> «Варианты оплаты»**. В таблице будут перечислены все доступные способы оплаты, а так же их код API.&#x20;

<figure><img src="/files/hK8QZ8mTF40umMieSSeA" alt=""><figcaption><p>Список вариантов оплаты Frontpad их кодов API.</p></figcaption></figure>

## Сопоставление способов

Перейдите в раздел [**«Магазин» -> «Обмен данными»**](https://my.zenky.io/dashboard/store/profile/exchange) в панели управления Zenky. В списке **«Дополнительные действия Frontpad»** нажмите на ссылку **«Сопоставление способов оплаты»**.

<figure><img src="/files/oNJQfNBb5uZ69yNPENr8" alt=""><figcaption></figcaption></figure>

В открывшемся окне вы увидите способы оплаты Zenky и поля ввода кодов API для каждого из них. Заполните коды API для тех способов, которые вы используете. После этого нажмите на кнопку **«Сохранить способы оплаты»** (может потребоваться проскроллить всплывающее окно).

<figure><img src="/files/EQRh6lzhzpTAtTA5qkWi" alt=""><figcaption><p>Окно сопоставления способов оплаты Frontpad и Zenky.</p></figcaption></figure>


# Настройка модуля обмена Zenky Frontpad Assistant

Обмен с Frontpad статусами, заказами, бонусами, клиентами через расширение для браузера Google Chrome

Расширение устанавливается в браузер Google Chrome и позволяет выполнять тонкую настройку связи между Frontpad и Zenky за счёт того, что оно работает напрямую с Frontpad из браузера оператора.

Для работы расширения требуется:

1. Браузер Google Chrome;
2. API-токен Zenky с **полным доступом** (создаётся от **пользователя-владельца** магазина);
3. ID магазина Zenky.

## **1. Генерация API-токена**

Для генерации API-токена необходимо сделать следующее:

1. Зайдите в [раздел персональных токенов](https://my.zenky.io/dashboard/profile/api/personal-tokens);
2. Введите название вашего нового токена (например, "Frontpad");
3. В поле **«Разрешения»** выберите **«Полный доступ»**;
4. Нажмите на кнопку **«Создать токен»**.

![Форма создания персонального API-токена.](/files/ukraXGVsdTJGwQBec9CN)

После создания токен будет отображен только один раз. Скопируйте его и сохраните в надёжном месте.

## **2. Получение ID магазина**

Перейдите на страницу [API магазина](https://my.zenky.io/dashboard/api) и скопируйте ID магазина (или нажмите на кнопку рядом с ID).&#x20;

![Раздел API с ID магазина.](/files/0iXOXpaTVNHrXf21nN6T)

Убедитесь, что вы вошли в нужный магазин (выпадающее меню в верхней части бокового меню).

## **3. Установка расширения**

* Запустите браузер Google Chrome
* Перейдите на страницу расширения [Zenky Frontpad Assistant](https://chrome.google.com/webstore/detail/zenky-frontpad-assistant/oojjhojonnegfbcfoncjfigiddmablhg?hl=ru)
* Нажмите кнопку “Установить”

![](https://lh4.googleusercontent.com/2qfySz7FJO7Ukbmb_69qoLeBbK4phfZUB2xc3pS26awpScZWOEyWuvYupzt1QHjSfkYU4jkqGITMeqPW7cDk5A52Vspi4lqUjGJRuFJTn19AeScZnnmipDjN5nsQ1DomXIeDCj63)

## **4. Настройка расширения**

Перейдите на сайт <https://app.frontpad.ru>, войдите в свой аккаунт администратора и нажмите на иконку расширения Zenky Frontpad Assistant на панели расширений браузера Google Chrome.

![](https://lh5.googleusercontent.com/EjaA97tvjefFOIl8pX_MM9ptnQFkiF82hTT7lbsYS1NXVFATR-gHJHRwUUF7WfEI_BPUVeHSd0zaKXiQ7vc9Au_CTXa93-5XyMOkPps2E6o42ZOBuIIxzkrYukP51U--KNSwZ4oU)

Вы должны увидеть следующее окно:

![](https://lh6.googleusercontent.com/wKvU5ur_hHXd2hGVzZxHDgj5FWxAYuC2CBvznirbH53WCgVOR40R4lyRLkQVRUvWskIvSGHm6JRQGnSNCOSBbJ-0bodOJBLKI8IUsK1ln-o9tabtmmcOqyP1RsfKeIlnDFGwyIoT)

Вставьте в соответствующие поля API-токен и ID магазина и нажмите “Начать работу”.

Если всё прошло успешно, расширение теперь будет открываться с таким окном (пока вы не нажмёте кнопку “Выйти из аккаунта” или не удалите расширение):<br>

![](https://lh4.googleusercontent.com/yBALiLeuLNXQuHbDO7HuRS7JkPMG00aOy0pxuCUqKwovUW3RXdE2aRrwhFzG8cgKOWrovOuMJC1rwYymaxDtMn-AVMzUzK_IHYNztSyDp58TJuDbdsedKzSRjSRvQ8g9nw5IzBYF)

### **4.1. Синхронизация точек продаж**

**Внимание: синхронизацию точек продаж нужно делать только при первоначальной настройке или если у вас изменились точки продаж. Выполнять синхронизацию точек на каждом компьютере оператора не нужно. Синхронизация должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.**

По умолчанию заказы с сайта или мобильного приложения отправляются во Frontpad с привязкой к Основной точке продаж.

1. Если у вас только одна точка продаж (Настройки -> Точки продаж во Фронтпаде), то синхронизацию складов делать **не нужно**;
2. Если точек продаж несколько, но вам достаточно того, что все заказы с сайта/приложения будут падать на основную точку → синхронизацию складов делать **необязательно**;
3. Если точек продаж несколько и вы хотите, чтобы заказы распределялись по точкам, в каждом городе магазина нужно отрисовать зоны доставки, привязав к каждой склад. Если адрес доставки будет попадать в одну из зон, заказ уйдёт на указанную точку продаж. Если адрес не попадёт ни в одну зону, заказ уйдёт на точку по умолчанию. Для работы этой функциональности синхронизация точек продаж обязательна.

Чтобы получать заказы с привязкой к точкам продаж, необходимо сопоставить точки Frontpad со складами Zenky.

* Нажмите на иконку расширения Zenky Frontpad Assistant в вашем браузере
* Выберите раздел “Синхронизировать точки продаж”.&#x20;
* Далее нужно сопоставить точки продаж со складами Zenky.

![](https://lh4.googleusercontent.com/P32bWKts-lTB400qKIOfjsZFoDVvDcIT-QdgY7Q4WDXF-CtVJc6bkE_NmMx9MYRJojGNd8M8TkxNsu7cstOunnFvsZTM4PHwhoKNFXrC1Mw5m4lNM3qcqblr04jZ6ppieoNkj1GF)

Обратите внимание, что название, указанное в заголовке, является названием склада Zenky. Названия, которые содержатся во всех выпадающих списках, являются названиями точек продаж Frontpad.

Точку продаж Frontpad можно сопоставить только с одним складом Zenky. Если вы попытаетесь привязать одну точку к нескольким складам, расширение сообщит вам об этой ошибке.

После того, как вы сопоставили склады и точки продаж, нажмите на кнопку “Синхронизировать” и не закрывайте окно расширения, пока не получите либо сообщение об успешной синхронизации, либо сообщение об ошибке.

![](https://lh4.googleusercontent.com/UjLSwh4-8clUl4ik6kM8mtnblpEw5o0l873-fF8eGvfnAlRwdEaq2Aj8oA4DsP1ZXdYM97T7d8--t_8f8aa6v0ozKe7z1t7tyjZTp5heQizUH6D3QaeSFUvIyzrUzQCDoU7Andur)

Не обязательно сопоставлять все точки. Вы можете сопоставить только часть точек продаж.&#x20;

Синхронизацию точек продаж нужно выполнить только один раз (последующие синхронизации необходимо делать только в случае добавления или удаления точек продаж во Frontpad либо в случае добавления или удаления складов в Zenky).

### **4.2. Синхронизация статусов заказов**

**Внимание: синхронизацию статусов заказов нужно делать только при первоначальной настройке или если у вас изменились статусы заказов. Выполнять синхронизацию статусов на каждом компьютере оператора не нужно. Синхронизация должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.**

Для того, чтобы при изменении заказа в интерфейсе Frontpad заказ так же обновлялся в базе Zenky, необходимо сначала выполнить сопоставление статусов заказов.

* Кликните на иконку расширения Zenky Frontpad Assistant
* Выберите раздел “Синхронизировать статусы заказов”.&#x20;
* После загрузки данных вы сможете сопоставить статусы заказов Frontpad со статусами заказов Zenky.

![](https://lh3.googleusercontent.com/lz8_f7sbGB4IDYkv3tpess50uN0a2t84gd0S0zOgm1VKfTmEfpcuG4VyOYN2Ic18aYyV9fhmicZLBBxeC9Bxf9Mu8rVzNtzCVOjRyIaBhea3-cfofC1xztzoVC6UW2PQTEiiPQRS)

Обратите внимание, что название, указанное в заголовке, является названием статуса заказа Zenky. Названия, которые содержатся во всех выпадающих списках, являются названиями статусов заказов Frontpad.

Один статус заказов Frontpad можно сопоставить только с одним статусом заказов Zenky. Если вы попытаетесь сопоставить один статус с несколькими, расширение сообщит вам об этой ошибке.

После того, как вы сопоставили статусы, нажмите на кнопку “Синхронизировать” и не закрывайте окно расширения, пока не получите либо сообщение об успешной синхронизации, либо сообщение об ошибке.

Вы можете сопоставить часть статусов, а не обязательно все.&#x20;

Синхронизацию статусов нужно выполнить только один раз (последующие синхронизации необходимо делать только в случае добавления или удаления статусов заказов во Frontpad либо в случае добавления или удаления статусов заказов в Zenky).

### **4.3 Синхронизация заказов**

**Внимание: ручная выгрузка заказов должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.**

Вы можете в любое время выгрузить в Zenky заказы из Frontpad за последние 30 дней. Это позволит выполнить массовое изменение статусов устаревших заказов (если таковые будут найдены).

Для выгрузки заказов в Zenky нажмите на иконку расширения Zenky Frontpad Assistant и в открывшемся окне выберите пункт “Синхронизировать заказы”.

![](https://lh4.googleusercontent.com/tq2HZNvTPpEeVdekP08NKxdk18IdkLWBkmpwtWth3iEUxmHQNLUlk2_R2X2v56zlLxMw7LWs1hUdFG1R0GfC28Y41wl7nPB88AB0c7MfS9crU6eYB-BnJbv95jgr64s8-VrqPdV6)

После того, как вы нажмёте на кнопку “Синхронизировать”, начнётся выгрузка всех заказов за последние 30 дней. Не закрывайте это окно, пока выгрузка не завершится.

![](https://lh5.googleusercontent.com/YcGWcVoM0dCubXZhTSzzIyEyrtAF1D-c45N3ykgEry4Hq0J3b6Tc9wHfiFs_klSHZASDddOyLFmu6vuXVmLMYvvS4927xU9dVFutA8Nbk-6ijxO2YA-Dom2LtOU-p1RsZrGYcFKs)

После окончания выгрузки вы можете закрыть окно расширения.

![](https://lh6.googleusercontent.com/QtMPpkZ4aV21vdZEnMKpU-vUJBCi_ipnjIXTfKhJTHFMcXjUdIuX9mB3R3PDhClbRLrAPjNiBF2P3QI4UdKoq-pYoLkan-VbmsY__xbLkP-btEkA3UZY2uXkT39o0pcIJMbgPFB1)

### **4.4 Синхронизация покупателей**

**Внимание: синхронизация покупателей должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.**

Внимание: эта функция доступна начиная с версии 1.1.1. Ваш браузер должен обновить расширение автоматически.

В связи с тем, что 100% заказов проводится через Frontpad (заказы по телефону, заказы напрямую в заведениях), бонусные счета ваших покупателей в Zenky могут отличаться от счетов во Frontpad.

Чтобы минимизировать такие расхождения, вы можете воспользоваться выгрузкой покупателей из Frontpad в Zenky. Для этого нажмите на иконку расширения Zenky Frontpad Assistant и в открывшемся окне выберите пункт “Синхронизировать клиентов”.

![](https://lh5.googleusercontent.com/TuItMnZd6Kfg_6GWHMGcnvzGdp27zeQVqFKC4rTJ0f984EMT0XKKrQ82TavFDf0mkUPa4-S7j1VMPxHGmHbe294Mmsc6XvXLapjYFECvWSWUit8RJ2Xmt7GKEwGkQPxKi6PerESr)

После того, как вы нажмёте на кнопку “Синхронизировать”, начнётся выгрузка всех клиентов в Zenky. Не закрывайте это окно, пока выгрузка не завершится.

![](https://lh3.googleusercontent.com/QLAYGjikd2jtQIDFq72E0wm8VfVuhqSO5KfpXiXdnGEmcd2RMtkkzUc9VSlJFQytq5s1YLfNlJw49uUd8T_925MkmEHiGGQvZm-KPRTOZ2d-2nwC3-SZcP93VjaMxtE2QBdYmieQ)

После окончания выгрузки вы можете закрыть окно расширения.

![](https://lh6.googleusercontent.com/1plcUa9bW6bwOwwCmjLI_yGVcd-RQUgasgi-Z6SLIo7XBaiZ_royZqE06GNX9Hn5N2x_H1OEZqLYjaLaunCBirhnXlKiCkoqIiI9D4sGRdkdkecqR7pj5EZy7ChZmcFW2nHC4UsW)

#### 4.4.1 Автоматическая выгрузка покупателей

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

Расширение отслеживает действия операторов и в моменты, когда оператор работает с профилем покупателя, расширение пытается получить баланс бонусного счета покупателя и отправить его в Zenky.

Автоматическая отправка срабатывает в следующих случаях:

1. Покупатель был прикреплён к заказу с помощью поиска по номеру дисконтной карты;
2. Покупатель был прикреплён к заказу с помощью поиска по номеру телефона;
3. Оператор открыл окно статистики покупателя;
4. Оператор вручную начислил бонусы покупателю (в профиле покупателя);
5. Оператор вручную списал бонусы покупателя (в профиле покупателя).

## **5. Работа с расширением**

После того, как вы закончили настройку расширения, его необходимо установить на все рабочие места вашей компании, из которых ведётся работа с Frontpad.

API токен и ID магазина можно переиспользовать для всех сотрудников. **Повторную синхронизацию точек продаж и статусов выполнять НЕ нужно.**

Кассиру не нужно выполнять никаких дополнительных действий при работе с Frontpad.&#x20;

Расширение будет само реагировать на изменение статуса заказа и отправлять необходимые данные в Zenky<br>


# Настройка бонусной системы Zenky и Frontpad

Инструкция для настройки синхронизации бонусных баллов клиентов

## Видео инструкция настройки бонусных систем

{% embed url="<https://youtu.be/wbSbencRKOU>" %}

## Особенности работы Frontpad

В системе [Frontpad.ru](http://frontpad.ru/) каждому клиенту присваивается один номер телефона. При этом телефоны 7900, +7900, 8900, 8(900) считаются разными и поэтому фронтпад создает дубликаты клиентов. Так в базе появляется много дублей клиентов.&#x20;

#### Примеры дублей клиентов в системе Frontpad

* Василий  79005551133
* Василий  +79005551133
* Василий +7(900)555-11-33
* Василий 89005551133 и тд.

#### Ограничения системы Frontpad

* Нельзя массово удалить дубли
* Нельзя склеить дубли в один аккаунт
* Удаление дублей возможно только в ручную

## Подготовка к синхронизации бонусов между Zenky и Frontpad

1. Выбрать один формат номера телефона, на котором больше всего клиентов в базе.
2. Сделать так, чтобы все заказы из сайта, приложения, агрегаторов приходили с номером телефона в одинаковом формате.
3. [Указать выбранную маску ](/exchange/frontpad/phone-mask)телефона в [настройках обмена my.zenky.io](https://my.zenky.io/dashboard/store/profile/exchange)
4. Договориться с другими источниками, чтобы они привели маску номера к единому виду.
5. Обнулить бонусные счета клиентов во Фронтпаде, если программа стартует с нуля. Обнулить можно написав письмо в техподдержку на емейл [info@frontpad.ru ](mailto:info@frontpad.ru)с указанием своего аккаунта и маски номеров клиентов, кому нужно обнулить балансы.
6. [Настроить бонусную систему во Frontpad](/exchange/frontpad/bonuses-sync#frontpad)
7. [Настроить бонусную систему в Zenky](/exchange/frontpad/bonuses-sync#zenky)
8. Установить и [настроить расширение Zenky Frontpad Assistant](/exchange/frontpad/assitant) на компьютерах операторов.
9. Сделать тестовые заказы на сайте и в приложении.
10. Установить заказам статус `Выполнен` во Frontpad, чтобы были начислены бонусы.
11. Проверить соответствие бонусов у клиента в приложении/сайте и во Frontpad

## Настроить бонусную систему во Frontpad

* Перейти в раздел `Настройки → Общие → Накопительные скидки`

![](/files/-M3GVY3bsztPC_Z3i7Pl)

* Включить `Накопительные скидки`
* Установить стартовый размер бонусной скидки, что соответствует первому бонусному уровню, который клиент получает с первой покупки.

![](/files/-M3GYSPf24Nt2AxmH4JW)

* Установить шаг бонусных уровней в процентах и в рублях.&#x20;
  * Например, бонусный уровень будет прирастать на 5% (поле Скидка) при покупках на 10000₽ (поле Кратна сумме).
    * Уровень 1 = 5% (Стартовая скидка)
    * Уровень 2 = 10% (при покупках на 10 000₽)
    * Уровень 3 = 15% (при покупках на 20 000₽)
* Установить максимальную скидку для ограничения бонусных уровней. Например, 15%

![](/files/-M3G_XnEGpd-i4rVOUQe)

* Перейти в раздел `Настройки → Общие → Лицевой счет и бонусная системаыв`

![](/files/-M3GaZB9t5It0QxrRkNV)

* Включить бонусную систему, поставив галочку
* Указать тип системы `Баллы от скидки клиента`
* Указать лимит списания баллов в процентах от суммы заказа
* Включить или отключить настройку `Не начислять баллы при оплате баллами`

![](/files/-M3GbF5M-TJLD9JDqGh1)

## Настроить бонусную систему в Zenky <a href="#zenky" id="zenky"></a>

* Авторизоваться в кабинете [my.zenky.io](< https://my.zenky.io>)
* Перейти на страницу [Лояльность → Бонусная система](https://my.zenky.io/dashboard/store/profile/loyalty)
* Установить стартовый процент бонусного начисления
* Установить какой процент от суммы чека можно оплатить бонусами
* Разрешить или запретить начислять бонусы при оплате заказа бонусами

![](/files/7EWnMU0tvODbAlYY1IBw)

* Перейти в раздел [Лояльность → Бонусные уровни](https://my.zenky.io/dashboard/store/profile/loyalty/bonuses-levels)
* Добавить бонусные уровни соответствующие уровням во Фронтпаде
* Указать название уровня. Например, Серебро.
* Указать Траты — сумма, на которую нужно сделать заказы, чтобы получить этот уровень. Например, 10 000₽.
* Указать процент вознаграждения бонусами.
* Указать какой процент от суммы заказа можно оплатить бонусами на этом уровне.

![](/files/kinxgxIeXrBodVn5voUL)

* Бонусные уровни должны совпадать по сумме и процентам с уровнями во Frontpad
* Название уровней нужно, чтобы выводить их в профиле клиента в мобильном приложении (см. картинку)

![](/files/-M3KAwGSUdtlLtSaJRGB)


# Настройка маски телефона для Frontpad

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

В учетной системе [Frontpad](http://frontpad.ru/) есть распространенная проблема - дублирование клиентов с разными номерами. Это происходит из-за того, что разные системы отправляют заказы во Forntpad с разными масками телефонов.

## Примеры масок телефоно&#x432;**:**

* Из сайта заказы приходят с телефоном вида +7 (964) 123-45-67
* Из мобильного приложения с телефоном вида +79641234567
* От аггрегатора доставок с телефоном вида 79641234567
* Операторы доставки забивают заказ с маской вида 89641234567

В данном случае используется 4 вида одного и того же номера. И во Frontpad они хранятся как 4 разных клиента с разными заказами, бонусами, адресами.

> Возникает проблема - **на каком номере хранятся актуальные бонусы?**

Для решения этой проблемы нужно привести формат номера телефона во всех источниках заказов к единому виду. Чтобы ото всюду заказы приходили с одной маской, например, 7900 (без плюса, без скобок, без пробелов, без дефисов).

## Установка маски номера телефона

Перейдите в раздел [**«Магазин» -> «Обмен данными»**](https://my.zenky.io/dashboard/store/profile/exchange) в панели управления Zenky. В форме настроек обмена с Frontpad укажите подходящую вам маску в поле **«Маска телефонов»**.

<figure><img src="/files/ZIB0Fv5yELJawwHy96m6" alt=""><figcaption><p>Настройки обмена с Frontpad.</p></figcaption></figure>

Используйте латинские буквы **X**, чтобы задать маску (символ «+» и код страны указывайте как есть). Несколько примеров масок и результатов форматирования номеров:

* Маска **«+7 (XXX) XXX-XX-XX»** отправит телефон в формате **«+7 (964) 123-45-67»**;
* Маска **«7XXXXXXXXX»** отправит телефон в формате **«79641234567»**;
* Маска **«8XXXXXXXXXX»** отправит телефон в формате **«89641234567»** и т.д.

Если поле маски оставить пустым, номера телефонов будут отправляться в формате **E.164** (+79641234567).


# Минимальная сумма заказа

Рассказываем как работают настройки минимальной суммы заказов

## Глобальная настройка

<figure><img src="/files/zGdLuPwycRu4ht1IX806" alt=""><figcaption></figcaption></figure>

Если вам необходимо установить минимальную сумму заказа, вы можете это сделать в настройках заказов вашего магазина (`Магазин` - `Настройки заказов`). Это глобальная настройка и она влияет на все виды заказов.

![Настройка минимальной суммы заказа.](/files/OF8DzIR5j9FALAIWmoYb)

Заказы с суммой меньше заданной оформить не получится – покупателям будет показано сообщение, где они смогут увидеть и текущую сумму заказа, и минимальную.

## Способы доставки

Инструкция, указанная выше, влияет на все способы доставки. Если вы хотите установить минимальные суммы отдельно для каждого способа (курьером, самовывозом или в заведении), указать их можно в секции **«Способы доставки»** настроек заказов.

![Настройка минимальной суммы для отдельных способов доставки.](/files/kmRIU8Ar0UEpRcByxgDL)

Теперь на самовывоз могут быть оформлены заказы от 1000₽ и выше, а на доставку – от 1500₽ и выше.

### Города

В редактировании [каждого города](https://my.zenky.io/dashboard/cities) вы так же можете настроить минимальные суммы для всех способов доставки.

Для этого нужно включить настройки **«Проверять минимальную сумму заказа для города»** и **«Настроить способы доставки»**, а затем заполнить поля для каждого способа доставки.

![Переопределение минимальной суммы заказа для города.](/files/0H0kGPN9WRnyBwqC3rnC)

Если вы не укажете минимальную сумму, будет использована сумма из глобальных настроек (порядок проверки смотрите в [разделе](#poryadok-proverki) ниже). Для того, чтобы отключить минимальную сумму для конкретного способа доставки в нужном городе, установите её в **«0»**.

Так же вы можете полностью отключить какой-либо способ в для редактируемого города. Для этого просто отключите нужный способ доставки.

## Зоны доставки

Если вы используете зоны доставки, для них так же можно определить минимальную сумму заказа. Для этого зайдите в редактирование нужной [зоны доставки](https://my.zenky.io/dashboard/delivery-zones) и заполните поле **«Минимальная сумма заказа»**.

![Настройка минимальной суммы заказа для зоны доставки.](/files/oThqPG7GNRB6SPrvQFrZ)

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

![Настройка «Проверять минимальную сумму заказа для города» должна быть включена в редактировании города.](/files/hua4aQyhOpkKCcnvTb2K)

## Порядок проверки

Из-за того, что минимальную сумму заказа можно настраивать очень гибко, у вас может возникнуть вопрос о том, в каком порядке мы будем проверять заказы.

Проверка выполняется в четыре шага. Если на любом шаге мы определили минимальную сумму, дальнейшие проверки не выполняются. Порядок этих шагов следующий:

1. Зона доставки;
2. Способ доставки для города, в котором оформляется заказ (если включена настройка проверки минимальной суммы для этого города);
3. Способ доставки из настроек магазина;
4. Глобальная настройка.


# Зоны доставки

### Для чего нужны зоны доставки <a href="#dlya-chego-nuzhny-zony-dostavki" id="dlya-chego-nuzhny-zony-dostavki"></a>

Зоны доставки нужны, чтобы:

* автоматически распределять заказы по точкам изготовления
* автоматически определять сумму минимального чека
* автоматически определять стоимость платной доставки
* автоматически определять среднее время доставки
* показывать клиентам зоны доставки на карте для наглядного информирования

Зоны доставки выводятся на карте на сайте в раделе «Доставка и оплата» и в мобильном приложении в разделе «О нас»

### Создание и редактирование зон доставки <a href="#sozdanie-i-redaktirovanie-zon-dostavki" id="sozdanie-i-redaktirovanie-zon-dostavki"></a>

Для создания зон доставки нужно перейти в раздел **`«Города и зоны - Зоны доставки»`**

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FyVLUGsMIPr4vsh5axnTZ%2FScreenshot%202022-05-31%20at%2013.25.54.png?alt=media\&token=868737b9-1b1c-4fae-8bba-eaab7e9513be)

В открывшемся окне выберите город, в котором нужно отрисовать зоны доставки

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FljJPlMbcDmb9ksVch66J%2Fimage.png?alt=media\&token=8960286c-6c47-48be-8f75-0b1fd4f25f8e)

Далее нужно нарисовать на карте нужную зону доставки. Для этого нужно нажать на кнопку **`«Многоугольник»`** и кликами мышки на карте обозначить точки многоугольника зоны доставки

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2Fdtm7DtuVCn1RBDHwT2cT%2Fimage.png?alt=media\&token=cf0162e0-0bb0-4f6a-9eb8-b63a5e47a8e6)

Для завершения рисования зоны необходимо нажать на одну из точек и в выпадающем меню выбрать пункт «Завершить»

![](/files/IQEEbo3F5oS2KeeQjkT1)

После завершения рисования зоны нужно кликнуть в область нарисованной зоны, чтобы откарыть окно редактрирования свойств.

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

![](/files/XGyyJUk65pB42wFzEDx1)

Далее нужно указать минимальную сумму заказа, ниже которой не принимаются заказы вообще. Нужно указать сумму бесплатной доставки, стоимость платной доставкии среднее время доставки в эту зону.

![](/files/hX0TnxTzy8JpV7qJdRP2)

Готовые отрисованные зоны отображаются на сайте в разделе `«Доставка и оплата»`.

![](/files/UVedG8Uavf5vatoZnsni)




---

[Next Page](/llms-full.txt/1)

