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

Внешние сегменты позволяют вам таргетировать пользователей, которые уже хранятся в вашей собственной базе данных, например, в 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 или Google Analytics 4 audience.

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

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.

Google Analytics 4 audience

Сегмент типа Google Analytics 4 audience берет пользователей из аудитории, созданной вами в Google Analytics, поэтому запрос для него не нужен. Заполните:

• GA4 property ID: ID ресурса Google Analytics; он указан в Google Analytics в разделе Admin → Property details.
• Service account JSON: ключ сервисного аккаунта с ролью Viewer для этого ресурса. Выдайте роль в Google Analytics в разделе Admin → Property access management и включите Google Analytics Data API и Admin API в проекте Google Cloud, к которому относится сервисный аккаунт.
• Audience: нажмите Load audiences и выберите аудиторию. Если список пуст, сначала создайте аудиторию в Google Analytics.

Затем нажмите Check connection и Create и пропустите следующий раздел. О настройке на стороне Google Analytics см. Интеграция с Google Analytics.

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

Для всех типов баз данных, кроме Google Analytics 4 audience:

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 дожидается полного обновления, прежде чем использовать сегмент.

Сегмент типа Google Analytics 4 audience обновляется по тем же правилам, но с более длинными интервалами — 24 и 72 часа, потому что Google Analytics обновляет состав аудиторий примерно раз в сутки.

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

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

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

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

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

1. Перейдите в Audience → Segments → Создать сегмент.
2. Нажмите Добавить фильтр по: → Сегмент.
3. Выберите ваш внешний сегмент по имени.

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

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

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

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

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

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