Управление данными пользователей с помощью тегов

Видео на YouTube: Теги — один из самых полезных инструментов, которые мы предлагаем. На этой функции основана большая часть сложного функционала Pushwoosh. С помощью тегов вы можете сегментировать свою аудиторию и отправлять push-уведомления одним пользователям, но не другим.

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

Как решить, какие теги использовать

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

Теги содержат любые произвольные данные, которые вы связываете с конкретным пользователем или устройством. Это может быть имя пользователя, ID, город, любимая футбольная команда, предпочитаемые категории новостей или любая другая информация о ваших пользователях. Давайте рассмотрим подробнее.

Значения тегов

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

Типы тегов

• Integer — используется для целочисленных данных (количество приобретенной внутриигровой валюты, достигнутый уровень, возраст).
• String — используется для строковых значений (имя пользователя, e-mail, идентификаторы).
• List — то же, что и тип String, но у каждого пользователя может быть установлено несколько значений одновременно (музыкальные предпочтения, категории новостей, кулинарные предпочтения).
• Boolean — тег типа true / false.
• Date — используется для календарных дат. По сути, это тег целочисленного типа, который хранит временные метки Unix Epoch (автоматически преобразуемые из/в григорианскую дату).
• Price — позволяет устанавливать значения в соответствии с указанной валютой в формате «*.XX» (https://ru.wikipedia.org/wiki/ISO_4217).
• Version — используется для версионирования. Пример допустимого формата: w.x.y.z (Major.Minor.Patch.Build). Максимальное значение для каждой части версии — 9999, поэтому максимальный номер версии не может превышать 9999.9999.9999.9999.

Операторы тегов

Каждый тип тега имеет определенный набор применимых операторов. Операторы тегов определяют взаимосвязь между тегом и его значениями для целей сегментации.

• Операторы тега Integer: is, is not, are, not in, not set, any
• Операторы тега String: is, is not, are, not in, not set, any
• Операторы тега List: in, not in, not set, any
• Операторы тега Boolean: is (true/false), not set, any
• Операторы тега Date: during the last N days, exactly N days ago, N or more days ago, between N and M days ago, between N and M days ahead, is today, is in N days, is N days past, on a specific date, on or after a specific date, on or before a specific date, between dates, not set, any
• Операторы тега Price: is, is not, greater or equals, less or equals, between, in, not in, not set, any
• Операторы тега Version: is, is not, greater or equals, less or equals, between, in, not in, not set, any

Примечание

Операторы “Not set” и “any” доступны для всех типов тегов.

Область действия тегов: общие и пользовательские

При создании тега вы выбираете, как будут храниться его значения:

• Общие (по умолчанию): значение тега хранится для каждого устройства (HWID). Каждое устройство одного и того же пользователя может иметь независимое значение.
• Пользовательские: значение тега хранится для каждого пользователя (UserID). При установке через UserID значение применяется ко всем устройствам пользователя одновременно. Полезно для атрибутов, которые относятся к человеку, а не к конкретному устройству: уровень подписки, баллы лояльности, предпочитаемый язык.

Теги по умолчанию

Эти теги доступны в Pushwoosh «из коробки», поэтому вам не нужно (и, на самом деле, не следует) устанавливать их вручную. Большинство из них устанавливаются из приложения и отправляются на наш сервер через вызовы API, такие как registerDevice, а некоторые устанавливаются самим сервером.

Название	Тип	Где устанавливается	Описание
Application Version	Version	SDK	Текущая версия приложения, установленная на устройстве
Browser Type	String	SDK	Когда устройство регистрируется в вашем веб-проекте, его тип — мобильный или десктопный — отслеживается автоматически
City	String	Server	Последнее зарегистрированное географическое местоположение устройства
Country	String	Server	Последнее зарегистрированное географическое местоположение устройства
Device Model	String	SDK	Указывает модель устройства, на котором установлено приложение
First Install	Date	Server	Указывает время, когда устройство было впервые зарегистрировано для получения уведомлений
In-App Product	List	SDK	Продукты, приобретенные пользователем в приложении
Last In-App Purchase Date	Date	SDK	Дата последней покупки в приложении, совершенной на устройстве
Language	String	SDK	Двухбуквенная аббревиатура локали устройства в нижнем регистре согласно ISO-639-1; берется из настроек устройства
Last Application Open	Date	Server	Время последнего запуска приложения на устройстве
Last Email Open	Date	Server	Дата, когда с email-адреса устройства было в последний раз зарегистрировано событие открытия письма
Last Email Open Message Code	String	Server	Код сообщения последнего открытого письма (формат XXXX-XXXXXXXX-XXXXXXXX). Обновляется при каждом событии PW_EmailOpen. Используйте его для сегментации получателей определенной email-кампании по тем, кто ее открыл
Last Email Click	Date	Server	Дата, когда с email-адреса устройства был в последний раз зарегистрирован клик по ссылке в письме
Last Email Click Message Code	String	Server	Код сообщения последнего письма, в котором была нажата ссылка (формат XXXX-XXXXXXXX-XXXXXXXX). Обновляется при каждом событии PW_EmailLinkClicked. Используйте его для сегментации получателей определенной email-кампании по тем, кто нажал на ссылку
Last Email Confirm	Date	Server	Дата последнего подтверждения подписки Double Opt-In для email-адреса устройства
Bounced Email	Date	Server	Дата, когда для этого email-адреса произошел hard bounce. Хранится как дата, чтобы обеспечить сегментацию по времени, например, для исключения пользователей с недавними возвратами.
Unsubscribed Emails	Boolean	SDK	Указывает, отписался ли пользователь от получения писем от вашего приложения
OS Version	Version	SDK	Версия операционной системы, работающей на устройстве
Platform	String	SDK	Платформа, на которой пользователь использует ваш проект.
Push Alerts Enabled	Boolean	SDK	Указывает, разрешены ли push-уведомления в настройках устройства
SDK Version	Version	SDK	Версия Pushwoosh SDK, реализованная на устройстве
Live Activity ID	String	SDK	Используется для управления live activities путем связывания Live Activity ID с устройством. Автоматически очищается через 12 часов.
WhatsApp Session Expires At	Date	Server	Содержит текущее 24-часовое окно обслуживания клиентов, открытое последним входящим сообщением клиента в WhatsApp. Устанавливается автоматически при каждом входящем сообщении и является зарезервированным — вы не можете создать пользовательский тег с таким именем. Хранит только текущее окно, без истории.
WhatsApp Ad Click ID	String	Server	ID клика по рекламе Click-to-WhatsApp (ctwa_clid) из реферала входящего сообщения WhatsApp. Meta отправляет его один раз, в сообщении, которое открывает диалог. Более новый клик перезаписывает его вместе с WhatsApp Ad Click Date; повторный или неупорядоченный вебхук не откатывает его назад. Зарезервировано — вы не можете создать пользовательский тег с таким именем.
WhatsApp Ad Click Date	Date	Server	Время клика, записанное в WhatsApp Ad Click ID. Обновляется вместе с ним — более новый клик перезаписывает предыдущую дату. Зарезервировано — вы не можете создать пользовательский тег с таким именем.

Пользовательские теги

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

Как настроить пользовательский тег

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

Вам понадобится помощь вашей команды разработчиков для настройки пользовательских тегов. Предварительное создание тега здесь необязательно, поскольку Pushwoosh также автоматически создает тег при первой отправке его имени вашими разработчиками из приложения или API, определяя базовый тип (число, цена, текст, дата, список или логический) по значению. Сначала настройте его здесь для тега типа Version или пользовательского тега, так как автоматическое создание не может определить ни тот, ни другой. Если тег, который ваши разработчики начинают отправлять, не появляется автоматически, обратитесь в службу поддержки Pushwoosh, чтобы проверить, не отключено ли автоматическое создание для вашей учетной записи.

Для начала создайте и настройте теги в Pushwoosh Control Panel:

1. Перейдите на страницу Tags в вашей Control Panel и нажмите Add tag.
2. Дайте имя вашему тегу, выберите тип и укажите, должен ли он быть общим (на уровне устройства) или пользовательским (на уровне пользователя).
3. Нажмите Save Tag.

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

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

Использование тега City по умолчанию

Местоположение устройства определяется на основе его IP-адреса в момент последнего запуска вашего приложения на этом устройстве. GeoIP передает данные о местоположении в Pushwoosh, и Pushwoosh сохраняет полученное от GeoIP местоположение как значение тега City для конкретного устройства.

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

Например, если вы собираетесь таргетировать пользователей из Мюнхена, вам нужно охватить его несколькими значениями тега City, включая сам «Мюнхен» (со всеми соответствующими значениями, такими как различные варианты написания, которые могут быть возвращены GeoIP и сохранены как значения тега) и несколько близлежащих районов.

Статистика по тегам

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