Практическое руководство
Подключите свой сайт WooCommerce к Casa Signals
Установите коннектор WordPress Casa Signals, сгенерируйте ключ API вашего сайта, включите отслеживание и убедитесь, что события WooCommerce достигают вашей панели управления.
Перед началом
- Аккаунт Casa Signals.
- Магазин WooCommerce, в котором вы можете войти в систему как администратор WordPress.
Что у вас будет после завершения
- В Casa Signals существует подключение плагина WordPress для нужного сайта.
- Ключ API Casa Signals сохраняется в WordPress.
- В плагине WordPress включено отслеживание событий.
- Новые события WooCommerce начинают появляться в аналитике Casa Signals, временных графиках клиентов, отчетах о продуктах и триггерах потока.
- Дополнительные исторические продукты, пользователей и заказы можно импортировать без запуска автоматизации в реальном времени.
Как работает соединение
Casa Signals подключается к WooCommerce через плагин Customer Event Sync for Casa Signals WordPress. Плагин отслеживает важную активность WordPress и WooCommerce, ставит события в очередь внутри WordPress и отправляет их в Casa Signals в фоновых пакетах.
Соединение аутентифицируется с помощью ключа API, специфичного для сайта. Каждый сайт Casa Signals имеет свой собственный ключ, поэтому он должен исходить из той же записи сайта, что и домен WooCommerce, к которому вы подключаетесь.
Отслеживание включено. Одной установки плагина недостаточно. Ключ API должен быть сохранен, домен сайта должен быть правильным, а параметр «Включить отслеживание событий» должен быть включен.
- Сайт Casa Signals существует.
- Плагин WordPress установлен и активен.
- Ключ API вставлен в плагин.
- Отслеживание событий включено.
- Последние действия отображаются в Casa Signals.
1. Добавьте сайт WooCommerce в Casa Signals
Откройте панель управления Casa Signals.
Войдите в Casa Signals и откройте панель управления. Если это первый магазин в аккаунте, на панели управления отобразится форма «Добавить домен».
Введите название магазина
Используйте имя, которое ваша команда узнает, например «Магазин примеров». Это имя используется на панели управления и может отображаться в предварительном просмотре SMS-сообщений, если утвержденный идентификатор отправителя не активен.
Введите веб-домен
Введите действующий домен, ориентированный на клиента, например example.com. Не указывайте путь оформления заказа, путь к продукту, путь wp-admin или параметры отслеживания.
Используйте тот же домен, который клиенты используют для просмотра и покупки. Если магазин перенаправляет с www на не-www или наоборот, используйте последний общедоступный домен, который Casa Signals считает магазином.
Сохранить домен
Нажмите Добавить домен. Карточка сайта появится на информационной панели со ссылками на Аналитику, Клиентов, Продукты, Трансляции, Потоки и Настройки.
2. Создайте ключ API плагина WordPress.
Откройте настройки сайта
На панели управления Casa Signals откройте карточку сайта магазина WooCommerce и нажмите «Настройки».
Найдите панель плагинов WordPress.
В настройках найдите раздел «Подключение» под названием «Плагин WordPress». Эта панель показывает, подключен ли магазин, позволяет сгенерировать или повторно сгенерировать ключ API, а также включает загрузку плагина.
Генерация ключа
Нажмите «Создать ключ». Casa Signals создает новый ключ API для этого сайта. Если ключ уже существует и вы нажимаете «Регенерировать ключ», старый активный ключ для этого сайта заменяется.
Скопируйте ключ
Нажмите «Копировать» и сохраните ключ для WordPress. Относитесь к нему как к паролю. Любой, у кого есть ключ, может отправлять события для этого сайта Casa Signals.
- Скопированный ключ взят с того же сайта Casa Signals, что и магазин WooCommerce.
- Статус сайта показывает «Подключено» или виден ключ API.
- Пользователь не скопировал ключ из другого домена.
3. Загрузите и установите плагин WordPress.
Загрузите соединитель
На той же панели плагинов WordPress нажмите «Загрузить плагин». Файл называется customer-event-sync-casa-signals.zip.
Загрузите его в WordPress
В WordPress перейдите в «Плагины» -> «Добавить новый плагин» -> «Загрузить плагин». Выберите customer-event-sync-casa-signals.zip и нажмите «Установить сейчас».
Активируйте плагин
После того, как WordPress установит плагин, нажмите «Активировать плагин». Название плагина — Customer Event Sync for Casa Signals.
Откройте настройки плагина.
На экране «Плагины WordPress» нажмите ссылку «Настройки» в разделе «Customer Event Sync for Casa Signals».
4. Настройте плагин в WordPress
Вставьте ключ API
В поле «Ключ API» вставьте ключ, скопированный из Casa Signals. Если ключ уже сохранен, WordPress отображает замаскированный заполнитель, поэтому настоящий ключ не отображается в форме настроек.
Подтвердите домен сайта
В поле «Домен сайта» введите тот же домен, который был сохранен в Casa Signals. Таким образом входящие события связываются с нужным сайтом.
Включить отслеживание событий
Установите флажок Включить отслеживание событий. Плагин не отслеживает и не отправляет события клиентов, пока эта опция не включена.
Сохранить изменения
Нажмите «Сохранить изменения». С этого момента плагин может устанавливать собственные файлы cookie посетителей и сеансов, ставить клиентов в очередь и хранить события локально, а также отправлять их в Casa Signals в фоновом режиме.
- Установлен флажок Включить отслеживание событий.
- Ключ API присутствует.
- Домен сайта соответствует сайту Casa Signals.
- WooCommerce активен.
5. Проверьте соединение.
Создайте новое событие для клиентов
Откройте витрину в приватном окне браузера или другом браузере. Просмотрите товар, добавьте его в корзину, просмотрите корзину и начните оформление заказа.
Если возможно, введите адрес электронной почты и номер телефона при оформлении заказа. Для потоков SMS-сообщений клиентов требуется номер телефона, связанный с событием, а для потоков электронной почты — адрес электронной почты.
Вернуться в Casa Signals
Откройте панель управления сайтом в Casa Signals. Новые действия могут появиться в аналитике, графиках работы клиентов, аналитике продуктов и активности сайта в реальном времени.
Дождитесь фоновой доставки
Плагин ставит события в очередь локально и отправляет их с использованием фоновой обработки WordPress. Небольшая задержка — это нормально, особенно если на сайте низкий трафик или WP-Cron запускается только при посещении страниц.
При необходимости проверьте панель отладки WordPress.
Если события не появляются, вернитесь к настройкам плагина WordPress, включите режим отладки, сохраните, выполните другое действие на витрине, затем проверьте очередь отслеживания и последний фоновый ответ API на странице настроек.
6. Необязательно: импортируйте исторические данные.
После того, как живое соединение заработает, администраторы WordPress могут открыть Инструменты -> Импорт Casa Signals, чтобы импортировать существующие данные каталога, пользователей и заказов.
Импорт идемпотентен, поэтому повторный запуск импорта не должен дублировать одни и те же исторические записи. События исторических заказов помечаются как резервные и не вызывают потоки SMS или электронной почты.
- Сначала настройте ключ API.
- Сначала включите отслеживание событий.
- Запускайте импорт товаров, пользователей и заказов, когда у магазина будет достаточно времени для их обработки.
- Не используйте инструмент импорта в качестве теста живых событий, поскольку импортированные события намеренно пропускают автоматизацию.
Что Casa Signals начинает отслеживать
После включения плагин может отслеживать просмотры продуктов, поиск продуктов, просмотры корзины, события добавления в корзину, события удаления из корзины, изменения количества в корзине, начало оформления заказа, захват контактов при оформлении заказа, обновление адреса оформления заказа, выбранные способы оплаты и доставки, размещение заказов, успешные платежи, неудачные платежи, возвраты, отмены, активность купонов, регистрацию учетной записи, вход в систему, выход из системы, сброс пароля, обновление учетной записи, подписки, отправку форм, атрибуцию и работоспособность сайта.
Casa Signals использует эти события для аналитики, графиков работы клиентов, отчетов о продуктах, широковещательных рассылок, триггеров потоков, проверок подавления и атрибуции восстановления доходов.
Рекомендации после подключения
- Совершите реальную тестовую покупку или проверку оплаты в обычном тестовом режиме платежного шлюза WooCommerce, если он доступен.
- Храните ключ API в секрете и создавайте его повторно, если он был передан за пределы вашей команды.
- Проверьте аналитику после первого дня, чтобы убедиться в поступлении событий о продукте, корзине, оформлении заказа и заказе.
- Добавьте адрес электронной почты основного домена в настройках перед использованием потоков или рассылок электронной почты.
- Запросите идентификатор отправителя SMS, если вы хотите, чтобы в SMS-сообщениях клиентов отображалось название вашего бренда, а не отправителя по умолчанию.
- Создавайте поток отказа от корзины только после того, как станут видны события добавления в корзину или оформления заказа.
Устранение неполадок
После установки в Casa Signals не появляются события.
- Подтвердить Включение отслеживания событий отмечено в WordPress.
- Убедитесь, что ключ API сохранен в WordPress и получен с правильного сайта Casa Signals.
- Убедитесь, что поле Домен сайта в WordPress соответствует домену, сохраненному в Casa Signals.
- Посетите витрину магазина и создайте новое мероприятие после сохранения настроек. Историческая активность до настройки не будет отображаться, если ее не импортировать.
- Убедитесь, что WP-Cron запущен. Соединитель отправляет события в очереди фоновыми пакетами.
Плагин установлен, но данных нет.
- Установка плагина сама по себе не обеспечивает отслеживание. Откройте настройки плагина на экране «Плагины WordPress», вставьте ключ API, введите домен сайта, установите флажок «Включить отслеживание событий» и сохраните.
- Если в магазине используются плагины агрессивной безопасности, кэширования или отключения cron, разрешите WordPress cron и исходящие HTTPS-запросы к casasignals.com.
События задерживаются.
- Ожидается небольшая задержка, поскольку плагин ставит события в очередь локально и отправляет фоновые пакеты.
- Если события остаются зависшими, включите режим отладки и проверьте счетчик очереди отслеживания и последний фоновый ответ API.
- Если параметр DISABLE_WP_CRON включен, настройте реальное задание cron сервера для WordPress cron.
События отображаются не на том сайте.
- Ключ WordPress API, вероятно, получен с другого сайта Casa Signals, или значение домена сайта не соответствует предполагаемому сайту.
- Создайте новый ключ на правильном сайте в настройках Casa Signals, вставьте его в WordPress, подтвердите домен сайта и сохраните.
Потоки SMS-сообщений клиентов не отправляются после подключения.
- Соединение может работать, но для потоков SMS-сообщений клиентов также требуется номер телефона клиента в инициирующем событии.
- Убедитесь, что поток активен, имеет доступные кредиты и не подавляется из-за успешной оплаты во время задержки.
- Помните, что получатель, отписавшийся от СМС для магазина, будет пропущен.
Импорт завершен, но автоматизация не сработала.
- Это ожидаемо. Инструмент импорта помечает исторические события как обратную засыпку, а Casa Signals пропускает выполнение потока и маркировку восстановления для этих импортированных событий.
- Используйте новую живую витрину для тестирования автоматизации.
FAQ для агентов поддержки
Где мне найти ключ API Casa Signals?
В Casa Signals откройте магазин, перейдите в «Настройки», затем найдите панель подключения плагина WordPress. Нажмите «Сгенерировать ключ» или «Регенерировать ключ», затем «Копировать».
Где находятся настройки плагина WordPress?
В WordPress перейдите в раздел «Плагины», найдите «Customer Event Sync for Casa Signals» и нажмите «Настройки».
Плагин автоматически отправляет старые заказы?
Нет. Коннектор Live отправляет новые события после включения отслеживания. Исторические продукты, пользователей и заказы можно импортировать из Инструменты -> Импорт Casa Signals.
Будет ли импорт старых заказов вызывать поток SMS или электронной почты?
Нет. События импорта помечаются как заполнение. Casa Signals пропускает автоматизацию потока и атрибуцию восстановления для событий с обратным заполнением.