Подключение магазина Shopify с помощью пользовательского приложения (Admin API)

Если ваш магазин работает на Shopify, вы можете подключить его, создав пользовательское приложение (custom app) и вставив токен доступа Admin API в панель. После этого правила title и meta description для точных путей будут записываться в SEO-поля ваших товаров, страниц и коллекций, а статьи из студии контента будут добавляться в блог вашего магазина.

#Предварительные требования

• Учетная запись администратора Shopify с правом разработки приложений.
• Домен вашего магазина в формате my-store.myshopify.com.
• Для публикации блога — минимум один блог в магазине.

#Получение токена Admin API

1. В панели администратора Shopify перейдите в Settings → Apps and sales channels → Develop apps и включите разработку пользовательских приложений, нажав "Allow custom app development".
2. Нажмите Create an app, укажите название (например, SEOAsist) и откройте Configure Admin API scopes.
3. Выберите следующие разрешения (scopes): read_products, write_products, read_content, write_content, read_online_store_pages.
4. Нажмите Install app, затем отобразите и скопируйте Admin API access token (shpat_…). Shopify показывает его только один раз.

#Подключение панели к вашему магазину

1. Откройте сайт из раздела Сайты и перейдите на вкладку Каналы исправления.
2. В карточке Shopify введите my-store.myshopify.com в поле Домен магазина.
3. Вставьте токен, начинающийся с shpat_, в поле Токен доступа Admin API.
4. Нажмите Подключить. Панель запросит данные вашего магазина с помощью токена; при успешном подключении вы увидите "Shopify подключен", а статус изменится на Подключено. Токен хранится в зашифрованном виде.

#Запись SEO-правил в магазин

1. Сначала задайте правило Pixel для title или meta description с типом соответствия Точный путь: /products/…, /pages/… или /collections/….
2. Проверьте количество подходящих правил в секции Отправить SEO-правила карточки Shopify.
3. Нажмите Отправить SEO-правила. Панель сопоставит товары, страницы и коллекции по их handle и запишет значения в SEO-метаполя Shopify (global.title_tag / global.description_tag).
4. В уведомлении будет указано, сколько ресурсов было просканировано и сколько правил применено.

#Публикация статей в блоге

В студии Контента выберите Shopify в качестве Канала для статьи и опубликуйте ее. Запись будет добавлена как статья в первый блог магазина — в качестве черновика или публично. Заголовок, текст, краткое описание, теги, главное изображение, meta title и meta description передаются вместе с ней. Публиковать в Shopify можно только статьи блога.

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

#Проверка

• В карточке отображается статус Подключено, а также название магазина, домен, тарифный план Shopify и основной язык.
• После нажатия Отправить SEO-правила дата «последней отправки» обновляется.
• В Shopify в секции отображения в поисковых системах для товара видны новые заголовок и описание.

#FAQ

#Почему я получаю ошибку "Домен магазина должен выглядеть как my-store.myshopify.com"?

Панель принимает только домены, оканчивающиеся на .myshopify.com. Введите адрес myshopify.com, предоставленный вам Shopify, а не ваш пользовательский домен (например, www.mystore.com).

#Что означает "Недействительный токен"?

Введенное значение не похоже на токен Admin API пользовательского приложения. Токен начинается с shpat_; скопируйте именно Admin API access token, а не API key или API secret.

#При подключении возникает ошибка HTTP 401 или 403. Что делать?

Токен недействителен или у приложения нет необходимых разрешений (scopes). Сверьте разрешения Admin API приложения со списком выше, переустановите приложение и переподключитесь с новым токеном через Сменить токен / переподключить.

#Я отправил правила, но написано, что применилось 0 правил. Почему?

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

#Публикация статьи завершается ошибкой "в магазине нет блога". Что делать?

В вашем магазине еще нет блога. Создайте его в Shopify в разделе Online Store → Blog posts, затем повторите публикацию.

#Удалит ли отключение SEO-поля, записанные в мой магазин?

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