Расширения и функции приложений

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

Расширения позволяют приложениям добавлять функциональность в такие разделы, как интернет-магазин, оформление заказа, аккаунты клиентов или Point of Sale. Например, приложение может добавить пользовательское поле на страницу оформления заказов, открыть чат-бот в вашем интернет-магазине или отобразить баллы лояльности в аккаунтах клиентов.

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

Просматривать расширения и функции установленных приложений и управлять ими можно в разделе «Настройки» > «Приложения» панели администратора Shopify. На странице информации о приложении карточки «Расширения» и «Functions» показывают, сколько расширений и функций сейчас активно и в каких разделах магазина они доступны. Наведите указатель на названия разделов, чтобы узнать, где они активны: например, «Оформление заказа», «Аккаунты клиентов», «Интернет-магазин» или «Point of Sale» для расширений и «Оформление заказа», «Скидки», «Оплата» или «Отправка и доставка» для функций.

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

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

Активация расширений и функций

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

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

Расширения

Расширения можно активировать в следующих разделах панели администратора Shopify:

Functions

Functions можно активировать в следующих разделах панели администратора Shopify:

События приложений из расширений

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

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

О работоспособности расширений

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

Особенности оценки работоспособности расширений

Перед проверкой работоспособности расширений приложения учтите следующее:

  • Работоспособность оценивается только для активных расширений оформления заказа и аккаунтов клиентов.
  • Работоспособность не оценивается для расширений в других разделах, таких как «Интернет-магазин» или «Point of Sale», а также для функций.
  • При оценке доли неудачных загрузок применяется осторожный подход, поэтому расширение с небольшим числом загрузок с меньшей вероятностью будет отмечено как проблемное из-за нескольких сбоев.

Как отображается работоспособность расширений

Для каждого расширения оформления заказа и аккаунтов клиентов отображается один из следующих статусов работоспособности:

  • В норме: устойчивых сбоев при загрузке расширения не обнаружено.
  • Предупреждение: за последние 7 дней более 5 % загрузок расширения завершились сбоем, и доля неудачных загрузок остаётся выше 5 % в течение 72 часов.
  • Критическое состояние: за последние 7 дней более 50 % загрузок расширения завершились сбоем, и доля неудачных загрузок остаётся выше 50 % в течение 48 часов.
  • Недостаточно данных: данных для оценки работоспособности расширения недостаточно. Этот статус отображается, если за последние 7 дней расширение загружалось менее 10 раз или если для его текущей версии ещё не накопилось достаточно данных. Работоспособность оценивается отдельно для каждой версии расширения. Поэтому после недавнего обновления этот статус может сохраняться, пока не накопятся данные минимум за 7 дней работы новой версии, даже если она часто загружается.

У расширений также есть страница с данными, на которой отображаются статус работоспособности и следующие метрики за последние 7 дней:

  • Доля неудачных загрузок: доля загрузок расширения, завершившихся сбоем.
  • Сбои загрузки: количество случаев, когда расширение не удалось загрузить из-за проблемы в приложении.
  • Загрузки расширения: количество загрузок расширения.

Проверка работоспособности расширения

  1. В панели администратора Shopify перейдите в раздел «Настройки» > «Приложения».

  2. Нажмите на приложение, которое хотите проверить.

  3. Нажмите «Расширения».

  4. На вкладке «Активные» проверьте столбец «Работоспособность» для каждого расширения оформления заказа и аккаунтов клиентов.

  5. Необязательно: чтобы просмотреть подробности, нажмите на название расширения.

Устранение сбоев при загрузке расширений

Если у расширения статус «Предупреждение» или «Критическое состояние», на странице с данными расширения отображается баннер. В нём указано, что сбои связаны с проблемой в приложении и что разработчик приложения уже уведомлён. Чтобы открыть расширение в редакторе, нажмите «Открыть в редакторе оформления заказа» или «Открыть в редакторе аккаунтов клиентов». Чтобы получить помощь с расширением, свяжитесь с разработчиком приложения.

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

Поиск и устранение ошибок функций

Если при выполнении функции возникает ошибка, на странице сведений о приложении на карточке Functions, а также на странице функций отображается предупреждение. На карточке вместо обычного количества доступных разделов будет указано Ошибки в [number] разделах, а в предупреждении — время обнаружения последних ошибок.

На странице Функции функции с ошибками отмечаются значком Warning. Если в функции есть ошибки, обратитесь к разработчику приложения за помощью. В некоторых случаях ошибка уже может быть устранена. Вы также можете поделиться журналами функции, чтобы помочь разработчику выявить и устранить проблему.