Внешние сегменты

Внешние сегменты позволяют вам таргетировать пользователей, которые уже хранятся в вашей собственной базе данных, например, в CRM или хранилище данных, вместо того чтобы экспортировать их в CSV и загружать заново при каждом изменении списка. Вы предоставляете Pushwoosh SQL-запрос, который возвращает нужные User ID, и Pushwoosh будет периодически выполнять этот запрос, чтобы поддерживать сегмент в актуальном состоянии. После настройки вы можете использовать этих пользователей так же, как и любой другой сегмент.

Требуется помощь разработчика

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

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

• Подготовить пользователя с правами только для чтения (или, для BigQuery, сервисный аккаунт с правами только для чтения)
• Подтвердить запрос, который вы планируете использовать
• Если база данных находится за файрволом, уточнить у службы поддержки Pushwoosh, какие IP-адреса нужно разрешить

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

Назовите сегмент и выберите базу данных

1. Перейдите в Audience → External Segments.
2. Нажмите Create external segment.

3. Введите Name для сегмента (до 100 символов).
4. Выберите Database type: PostgreSQL, MySQL, Google BigQuery или Microsoft SQL Server / Fabric.

Заполните поля для подключения

PostgreSQL и MySQL

Для PostgreSQL и MySQL заполните:

• Host и Port: адрес вашего сервера базы данных. Pushwoosh требует общедоступный хост и отклоняет частные, внутренние или loopback-адреса при проверке подключения или сохранении сегмента.
• Database: имя базы данных.
• User и Password: учетные данные для аккаунта с правами только для чтения.
• SSL mode (только для PostgreSQL, так как подключения MySQL не используют TLS) устанавливает, как SSL/TLS, протокол шифрования, применяется к вашему подключению к базе данных. Уточните у вашего администратора баз данных, какой режим использовать:
  • Disable: без шифрования.
  • Require: шифрует подключение, но не проверяет подлинность сервера базы данных.
  • Verify CA: шифрует подключение и проверяет, что сертификат сервера выдан доверенным центром сертификации (CA).
  • Verify full: то же, что и Verify CA, а также проверяет, что сертификат соответствует имени хоста вашей базы данных. Самый надежный вариант.
• Для любого режима, кроме Disable, предоставьте CA certificate в разделе Certificate source (Upload files или Paste PEM), а также Client certificate и Client key, если ваша база данных их требует.

BigQuery

Для Google BigQuery заполните:

• Project ID: проект GCP, в котором находится ваш набор данных.
• Service account JSON: ключ для сервисного аккаунта с доступом на чтение в BigQuery.
• Location: регион набора данных (например, EU, US или europe-west3). Оставьте поле пустым, чтобы определить местоположение автоматически из набора данных.

SQL Server / Fabric

Для Microsoft SQL Server / Fabric заполните:

• Host и Port: адрес вашего сервера базы данных или конечной точки аналитики SQL в Fabric. Pushwoosh требует общедоступный хост и отклоняет частные, внутренние или loopback-адреса при проверке подключения или сохранении сегмента.
• Database: имя базы данных.
• User и Password: учетные данные для аккаунта с правами только для чтения.
• Microsoft Entra tenant ID: необязательно. Оставьте поле пустым для входа в SQL Server. Для Microsoft Fabric, чья конечная точка аналитики SQL не имеет SQL-логинов, установите его для входа в качестве субъекта-службы. Введите его ID приложения (клиента) в поле User и его секрет клиента в поле Password.

Введите запрос

1. Введите Query. Он должен возвращать один столбец с именем user_id, с одной строкой на каждого пользователя, которого вы хотите включить в сегмент. Например:

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

Примечание

Значения user_id должны совпадать с User ID, которые вы установили для своих пользователей в Pushwoosh (тот же идентификатор, что используется в создании сегментов по User ID). Запрос, возвращающий ID, которые Pushwoosh не распознает, не будет сопоставлен ни с одним устройством.

2. Нажмите Check connection, чтобы убедиться, что Pushwoosh может подключиться к базе данных (тайм-аут через 30 секунд).
3. Нажмите Check query, чтобы убедиться, что запрос выполняется и возвращает правильный столбец (также тайм-аут через 30 секунд).

Проверьте и создайте

Когда обе проверки пройдут успешно, нажмите Create. Pushwoosh немедленно сохранит сегмент и добавит его в список External Segments.

Как сегмент остается актуальным

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

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

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

Если обновление не удается (например, база данных становится недоступной или запрос начинает выдавать ошибки), Pushwoosh записывает ошибку, но статус сегмента в списке External Segments сам по себе не меняется. После того как вы устраните проблему на своей стороне, откройте сегмент и нажмите Check connection, чтобы подтвердить исправление. Ошибка будет автоматически сброшена при следующем успешном обновлении данных сегмента.

Использование внешнего сегмента

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

Чтобы объединить его с другими условиями, добавьте его в качестве фильтра:

1. Перейдите в Audience → Segments → Create Segment.
2. Нажмите Add filter by → Segment.
3. Выберите ваш внешний сегмент по имени.

Тот же фильтр Segment доступен в составных фильтрах и при выборе аудитории в Audience-based entry. Подробнее об объединении сегментов см. в разделе Создание сегментов на основе существующих сегментов.

Как проверить, сколько человек в сегменте

В списке External Segments не отображается количество участников. Откройте обертку сегмента в Audience → Segments (см. Использование внешнего сегмента) и рассчитайте его размер там.

Управление внешними сегментами

В списке External Segments каждая строка показывает имя сегмента, Code (идентификатор, используемый для ссылки на сегмент в вызовах API), тип базы данных, хост и статус (valid или invalid).

• Нажмите Edit, чтобы изменить подключение или запрос. Тип базы данных нельзя изменить после создания. Вместо этого создайте новый сегмент.
• Нажмите Delete, чтобы удалить сегмент. Pushwoosh блокирует удаление, если сегмент используется в кампании, Journey, фильтре или всплывающей форме. Сначала удалите эти ссылки, а затем удалите сегмент. Это действие нельзя отменить.