Как использовать сегментацию в push-уведомлениях приложений с помощью PushEngage

PushEngage позволяет группировать подписчиков вашего приложения в сегменты, чтобы вы могли нацеливать конкретные аудитории с релевантными уведомлениями, а не транслировать всем сразу. Это руководство охватывает как статические сегменты, где подписчик остается в группе, пока вы его не удалите, так и динамические сегменты, где подписчик автоматически удаляется через определенное количество дней. Оно включает настройку панели управления, методы SDK для iOS и Android, а также ссылки на REST API для управления на стороне сервера.

Прежде чем начать

• Ваше приложение должно быть интегрировано с SDK PushEngage для iOS или Android. Если вы еще не сделали этого, сначала завершите настройку:
  • Настройка push-уведомлений для приложений iOS
  • Настройка push-уведомлений для приложений Android
  • Настройка push-уведомлений для приложений React Native
  • Настройка push-уведомлений для приложений Flutter
• Сегменты должны быть созданы на панели управления PushEngage, прежде чем ваш код SDK сможет ссылаться на них. Имя сегмента, которое вы передаете в SDK, должно точно совпадать с именем на панели управления (с учетом регистра).
• Полные ссылки на методы SDK доступны в Справочнике SDK для iOS и Справочнике SDK для Android.

Как работает сегментация push-уведомлений приложений

Когда пользователь открывает ваше приложение и ваш код SDK вызывает метод добавления сегмента, PushEngage регистрирует это устройство в соответствующем сегменте в вашей учетной записи. С этого момента любая кампания, нацеленная на этот сегмент, будет включать этого подписчика.

Существует два типа сегментов:

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

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

Оба типа создаются одинаково на панели управления. Разница заключается в методе SDK, который вы вызываете для добавления подписчиков в них.

Шаг 1: Создайте сегмент на панели управления

Прежде чем ваш SDK сможет назначить подписчика сегменту, сегмент должен существовать в PushEngage.

1. Войдите в свою учетную запись PushEngage по адресу app.pushengage.com.
2. Перейдите в Audience » Segments.
3. Нажмите Create a New Segment.
4. Введите имя сегмента. Используйте имя, которое является описательным и легко ссылается в коде, например «Недавние покупатели» или «Премиум-пользователи».
5. Нажмите Сохранить сегмент.

Вам не нужно добавлять шаблоны URL или правила при создании сегментов для push-уведомлений приложений. SDK обрабатывает назначение программно.

Повторите этот шаг для каждого сегмента, который вы хотите использовать.

Шаг 2: Добавьте подписчика приложения в сегмент (iOS)

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

Статический сегмент (iOS)

Используйте addSegments, чтобы навсегда добавить текущего подписчика в один или несколько сегментов.

PushEngage.addSegments(["Premium Users", "US Customers"]) { response, error in
    if response {
        print("Segments added successfully.")
    } else {
        if let error = error {
            print("Failed to add segments: \(error.localizedDescription)")
        }
    }
}

Чтобы удалить подписчика из статического сегмента:

PushEngage.removeSegments(["US Customers"]) { response, error in
    if response {
        print("Segments removed successfully.")
    }
}

Динамический сегмент (iOS)

Используйте addDynamicSegments, чтобы добавить подписчика в сегмент на фиксированное количество дней. PushEngage автоматически удалит подписчика по истечении срока.

Каждая запись в массиве представляет собой словарь с двумя ключами: "name" (название сегмента, как оно отображается в панели управления) и "duration" (количество дней, в течение которых подписчик будет находиться в этом сегменте).

let dynamicSegments: [[String: Any]] = [
    ["name": "Recent Buyers", "duration": 30],
    ["name": "Trial Active", "duration": 14],
]

PushEngage.addDynamicSegments(dynamicSegments) { response, error in
    if response {
        print("Dynamic segments updated successfully.")
    } else {
        if let error = error {
            print("Failed to update dynamic segments: \(error.localizedDescription)")
        }
    }
}

Полные сигнатуры методов доступны в Справочнике по iOS SDK.

Шаг 3: Добавление подписчика приложения в сегмент (Android)

Статический сегмент (Android)

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

Java:

List<String> segmentList = new ArrayList<>();
segmentList.add("Premium Users");

PushEngage.addSegment(segmentList, new PushEngageResponseCallback() {
    @Override
    public void onSuccess(Object responseObject) {
        // Segment added successfully
    }

    @Override
    public void onFailure(Integer errorCode, String errorMessage) {
        // Handle failure
    }
});

Чтобы удалить подписчика из статического сегмента:

List<String> segmentList = new ArrayList<>();
segmentList.add("Premium Users");

PushEngage.removeSegment(segmentList, new PushEngageResponseCallback() {
    @Override
    public void onSuccess(Object responseObject) {
        // Segment removed successfully
    }

    @Override
    public void onFailure(Integer errorCode, String errorMessage) {
        // Handle failure
    }
});

Динамический сегмент (Android)

Используйте addDynamicSegment, чтобы добавить подписчика в сегмент на определенное количество дней. Создайте объект Segment с названием и продолжительностью, затем передайте его в списке.

Java:

AddDynamicSegmentRequest addDynamicSegmentRequest = new AddDynamicSegmentRequest();
List<AddDynamicSegmentRequest.Segment> segments = new ArrayList<>();
AddDynamicSegmentRequest.Segment segment = addDynamicSegmentRequest.new Segment("Recent Buyers", 30);
segments.add(segment);

PushEngage.addDynamicSegment(segments, new PushEngageResponseCallback() {
    @Override
    public void onSuccess(Object responseObject) {
        // Dynamic segment added successfully
    }

    @Override
    public void onFailure(Integer errorCode, String errorMessage) {
        // Handle failure
    }
});

Полные сигнатуры методов и эквиваленты Kotlin доступны в Справочнике по Android SDK.

Шаг 4: Таргетинг на сегмент в кампании

После назначения подписчиков в сегменты вы можете нацеливаться на эти сегменты при создании любой кампании push-уведомлений.

1. Перейдите в раздел Campaign » Push Broadcasts (для разовых рассылок) или откройте триггерную кампанию, которую вы хотите настроить.
2. Нажмите Create New Push Broadcast или откройте существующую кампанию.
3. Введите заголовок уведомления, сообщение и URL.
4. В разделе Audience выберите Send to a Segment.
5. Выберите название сегмента из выпадающего списка.
6. Завершите настройку остальных параметров кампании и запланируйте или отправьте ее.

[Скриншот: Страница создания кампании с развернутым разделом Audience, где выбрано "Send to a Segment" и выбран сегмент из выпадающего списка]

Вы также можете нацеливаться на несколько сегментов одновременно или комбинировать таргетинг на сегменты с другими фильтрами аудитории, используя группы аудиторий. Подробнее см. в документации по группам аудиторий.

Шаг 5: Управление сегментами через REST API (необязательно)

Если сервер вашего приложения управляет подписчиками, вы можете использовать PushEngage REST API для создания сегментов и назначения подписчиков без использования мобильного SDK.

Конечные точки REST API для сегментов:

Все вызовы REST API требуют ваш ключ API в заголовке Api-Key. Идентификаторы профиля — это гибкий идентификатор, который вы назначаете подписчикам (например, адрес электронной почты или идентификатор пользователя), позволяющий управлять одним и тем же подписчиком на разных устройствах.

Пример: Добавление подписчика в сегмент с использованием идентификатора профиля:

curl -X POST \
  -H "Api-Key: <your_pushengage_api_key>" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d 'segment_name=Recent+Buyers&profile_id=user123&operation=add' \
  "https://api.pushengage.com/apiv1/profile"

Чтобы удалить того же подписчика из сегмента, измените operation=add на operation=delete.

См. полный Справочник по REST API для сегментов для получения полной документации.

Часто задаваемые вопросы

В чем разница между статическим и динамическим сегментом? Статический сегмент удерживает подписчика в группе до тех пор, пока вы не вызовете метод удаления. Динамический сегмент автоматически истекает через указанное вами количество дней при добавлении подписчика. Используйте статические сегменты для постоянных состояний, таких как тип учетной записи. Используйте динамические сегменты для временных окон, таких как период после покупки или бесплатный пробный период.

Нужно ли мне создавать отдельный сегмент на панели управления для динамического использования? Нет. Сегменты создаются одинаково на панели управления независимо от того, как вы добавляете подписчиков. Разница только в том, какой метод SDK вы вызываете: addSegments добавляет навсегда, а addDynamicSegments добавляет с истечением срока действия.

Имя сегмента, которое я передаю в SDK, не совпадает. Что мне следует проверить? Имена сегментов чувствительны к регистру и должны точно совпадать с именем на панели управления PushEngage, включая пробелы и регистр. Перейдите в раздел Аудитория » Сегменты, чтобы проверить точное имя.

Может ли подписчик принадлежать к нескольким сегментам одновременно? Да. Вы можете добавить подписчика в столько сегментов, сколько вам нужно. Когда вы отправляете кампанию в сегмент, все подписчики, в настоящее время назначенные этому сегменту, получают ее.

Могу ли я использовать сегменты с триггерными кампаниями, а не только с массовыми рассылками? Да. Таргетинг по сегментам доступен для массовых рассылок, автоматических ответов Drip и триггерных кампаний. Раздел «Аудитория» в каждом типе кампании включает опцию таргетинга по сегменту.

Где я могу увидеть, какие подписчики находятся в сегменте? Перейдите в раздел Аудитория » Сегменты на панели управления и нажмите на имя сегмента, чтобы увидеть детали и количество подписчиков.

Если у вас возникнут какие-либо проблемы, пожалуйста, свяжитесь с нами, нажав здесь. Наша служба поддержки сможет вам помочь.