Теги — один из самых полезных инструментов, которые предлагает Pushwoosh, позволяющий реализовать широкий спектр сложных функций. Используя теги, вы можете сегментировать свою аудиторию и отправлять целевые push-уведомления конкретным пользователям на основе их атрибутов.
Теги могут содержать любые произвольные данные, связанные с конкретным пользователем или устройством. Эти данные могут включать имена пользователей, идентификаторы, города, любимые футбольные команды, предпочитаемые категории новостей или любую другую релевантную информацию о ваших пользователях.
Начните с определения потребностей вашего бизнеса и решите, как вы хотите сегментировать свою аудиторию. Учитывайте такие факторы, как возраст, местоположение, история покупок в приложении или любые другие релевантные критерии для таргетинга пользователей.
Значения тегов помогут сделать ваши push-кампании умнее. Каждый тег способен хранить практически неограниченное количество значений. По сути, это означает, что одного тега будет достаточно для записи определенного типа информации о каждом конечном пользователе в вашей базе данных.
Каждый тип тега имеет определенный набор применимых операторов. Операторы тегов определяют отношение между тегом и его значениями для целей сегментации.
is, is not, are, not in, not set, anyis, is not, are, not in, not set, anyin, not in, not set, anyis (true/false), not set, anyexactly on, on or after, on or before, between, not set, anyis, is not, greater or equals, less or equals, between, in, not in, not set, anyis, is not, greater or equals, less or equals, between, in, not in, not set, anyПри создании тега вы выбираете, как будут храниться его значения:
user_specific: false, по умолчанию для /addTag): значение тега хранится для каждого устройства (HWID). Каждое устройство одного и того же пользователя может иметь разные значения независимо друг от друга.user_specific: true, по умолчанию в форме Control Panel и для тегов, автоматически созданных через setTags): значение тега хранится для каждого пользователя (UserID). При установке через UserID значение применяется ко всем устройствам пользователя одновременно. Полезно для атрибутов, которые относятся к человеку, а не к конкретному устройству: уровень подписки, баллы лояльности, предпочитаемый язык.У пользователя установлены и iOS, и Android версии вашего приложения. Установка тега subscription_tier в значение "premium" через его UserID немедленно применит его к обоим устройствам. С тегом General вам пришлось бы устанавливать его для каждого устройства отдельно.
{ "request":{ "application": "XXXXX-XXXXX", "userId": "the id of a specific user", "tags": { "subscription_tier": "premium", "loyalty_points": 350 } }}Эти теги доступны в Pushwoosh по умолчанию, поэтому вам не нужно (и, на самом деле, не следует) устанавливать их вручную. Большинство из них устанавливаются из приложения и отправляются на наш сервер через вызовы API registerDevice и другие, а некоторые устанавливаются самим сервером. Исключение — SMS Marketing Consent и Viber Marketing Consent. Ваши разработчики устанавливают их через setTags, когда человек соглашается на маркетинговые сообщения или отказывается от них.
| Название | Тип | Где устанавливается | Описание |
|---|---|---|---|
| Application Version | Версия | SDK | Текущая версия приложения, установленная на устройстве |
| Browser Type | Строка | SDK | Когда устройство регистрируется для вашего веб-проекта, его тип — мобильный или десктопный — отслеживается автоматически |
| City | Строка | Сервер | Последнее зарегистрированное географическое местоположение устройства |
| Country | Строка | Сервер | Последнее зарегистрированное географическое местоположение устройства |
| Device Model | Строка | SDK | Указывает модель устройства, на котором установлено приложение |
| First Install | Дата | Сервер | Указывает время, когда устройство было впервые зарегистрировано для получения уведомлений |
| In-app Product | Список | SDK | Внутриигровые продукты, приобретенные пользователем приложения |
| Last In-app Purchase date | Дата | SDK | Дата последней покупки в приложении, совершенной на устройстве |
| Language | Строка | SDK | Двухбуквенное сокращение в нижнем регистре локали устройства согласно ISO-639-1; берется из настроек устройства |
| Last Application Open | Дата | Сервер | Время последнего запуска приложения на устройстве |
| Last Email Open | Дата | Сервер | Дата, когда для адреса электронной почты устройства в последний раз было зарегистрировано событие открытия письма |
| Last Email Open Message Code | Строка | Сервер | Код сообщения последнего открытого письма (формат XXXX-XXXXXXXX-XXXXXXXX). Обновляется при каждом событии PW_EmailOpen. Используйте его для сегментации получателей определенной email-кампании по тем, кто ее открыл |
| Last Email Click | Дата | Сервер | Дата, когда для адреса электронной почты устройства в последний раз был зарегистрирован клик по ссылке в письме |
| Last Email Click Message Code | Строка | Сервер | Код сообщения последнего письма, в котором была нажата ссылка (формат XXXX-XXXXXXXX-XXXXXXXX). Обновляется при каждом событии PW_EmailLinkClicked. Используйте его для сегментации получателей определенной email-кампании по тем, кто нажал на ссылку |
| Last Email Confirm | Дата | Сервер | Дата последнего подтверждения подписки Double Opt-In для адреса электронной почты устройства |
| Bounced Email | Дата | Сервер | Дата, когда для этого адреса электронной почты произошел hard bounce. Хранится как дата для возможности сегментации по времени, например, для исключения пользователей с недавними возвратами |
| Unsubscribed Emails | Boolean | SDK | Указывает, отписался ли пользователь от получения писем от вашего приложения |
| SMS Marketing Consent | Boolean | Сервер, setTags | Согласился ли SMS-подписчик на маркетинговые SMS: true — согласился, false — отказался, нет значения — неизвестно. Подробнее |
| Viber Marketing Consent | Boolean | Сервер, setTags | Согласился ли Viber-подписчик на маркетинговые сообщения в Viber: true — согласился, false — отказался, нет значения — неизвестно. Подробнее |
| OS Version | Версия | SDK | Версия операционной системы, работающей на устройстве |
| Platform | Строка | SDK | Платформа, на которой пользователь использует ваш проект. |
| Push Alerts Enabled | Boolean | SDK | Указывает, разрешены ли push-уведомления в настройках устройства |
| Push Permission Status | Строка | SDK | Состояние разрешения на push-уведомления на устройстве, например not_determined, provisional, granted_explicit или denied. Зарезервирован: создать пользовательский тег с таким именем нельзя. Подробнее |
| SDK Version | Версия | SDK | Версия Pushwoosh SDK, реализованная на устройстве |
| Live Activity ID | Список | SDK | Используется для управления Live Activities путем привязки Live Activity ID к устройству. Автоматически очищается через 12 часов. Зарезервирован: создать пользовательский тег с таким именем нельзя. |
| WhatsApp Session Expires At | Дата | Сервер | Хранит текущее 24-часовое окно обслуживания клиентов, открытое последним входящим сообщением клиента в WhatsApp. Устанавливается автоматически при каждом входящем сообщении. Зарезервирован: создать пользовательский тег с таким именем нельзя. Хранит только текущее окно, без истории. |
| WhatsApp Ad Click ID | Строка | Сервер | ID клика по рекламе Click-to-WhatsApp (ctwa_clid) из referral входящего сообщения WhatsApp. Meta отправляет его один раз, в сообщении, которое открывает переписку. Более новый клик перезаписывает его вместе с WhatsApp Ad Click Date. Повторно отправленный или пришедший не по порядку вебхук не откатывает его. |
| WhatsApp Ad Click Date | Дата | Сервер | Время клика, записанного в WhatsApp Ad Click ID. Обновляется вместе с ним: более новый клик перезаписывает предыдущую дату. |
Здесь вступает в игру ваша креативность для достижения конкретных бизнес-целей. Пользовательские теги могут быть созданы на основе логики сегментации или шаблона таргетинга, который подходит для ваших уникальных бизнес-потребностей. Сотрудничайте с вашей маркетинговой командой, чтобы определить дополнительные пользовательские теги, необходимые для ваших кампаний.
Создавать тег заранее необязательно. Отправка нового имени тега через setTags создает его автоматически, при этом тип определяется по значению:
4.99, становится Price. Число вида 5.0 становится Integer.2024-10-02 22:11.true или false либо JSON-массив, получает тип по своему содержимому, поэтому "42" становится Integer, а не String.Атрибуты событий не определяют тип строки по ее содержимому, поэтому "42", отправленное в событии, становится String. См. Автоматически создаваемые события.
Автоматически созданный тег всегда User-specific (user_specific: true). Добавьте тег явно заранее через Control Panel или /addTag для тега типа Version, который автоматическое создание не может определить, или для тега General.
Автоматическое создание тегов включено по умолчанию для подавляющего большинства аккаунтов. Если setTags не создает новый тег, как ожидалось, обратитесь в службу поддержки Pushwoosh, чтобы проверить, не отключена ли эта функция для вашего аккаунта.
Вы можете добавить новый тег в Pushwoosh Control Panel или использовать метод /addTag.
POST https://api.pushwoosh.com/json/1.3/addTag
Создает тег в вашем аккаунте.
| Название | Тип | Описание |
|---|---|---|
| auth* | string | Токен доступа к API из Pushwoosh Control Panel. |
| tag* | object | Параметры тега. |
| tag.name* | string | Название тега. |
| tag.type* | integer | Тип тега. Возможные значения см. ниже. |
| tag.user_specific | boolean | Если true, значение тега хранится на уровне пользователя и является общим для всех его устройств при установке по UserID. Если false (по умолчанию), тег является тегом уровня устройства и устанавливается для каждого HWID. |
{ "status_code": 200, "status_message": "OK", "response": { "result": true }}{ "request": { "auth": "yxoPUlwqm…………pIyEX4H", // обязательно, токен доступа к API из Pushwoosh Control Panel "tag": { "name": "TAG_NAME", // обязательно "type": 1, // обязательно, возможные значения см. ниже "user_specific": false // необязательно. true = уровень пользователя; false = уровень устройства (по умолчанию) } }}Возможные типы значений тегов:
После того как вы добавили и настроили тег, он готов к сбору информации от ваших пользователей. Выполните следующие шаги для его реализации:
setTags для присвоения тегов и сбора данных пользователей.Ниже приведены примеры реализации для различных фреймворков с использованием функции setTags.
iOS Native
NSDictionary *tags = @{ @"Alias" : aliasField.text, @"FavNumber" : @([favNumField.text intValue]), @"price" : [PWTags incrementalTagWithInteger:5], @"List" : @[ @"Item1", @"Item2", @"Item3" ]};
[[PushNotificationManager pushManager] setTags:tags];Android Native
pushwoosh.setTags(Tags.intTag("intTag", 42));Cordova
PushNotification.prototype.setTags = function( config, success, fail )Flutter
Future<void> setTags(Map tags) async { await _channel.invokeMethod("setTags", {"tags" : tags});}React Native
pushNotification.setTags({ "string_tag" : "Hello world", "int_tag" : 42, "list_tag":["hello", "world"]});Unity
Устанавливает тег типа Integer для устройства.
public virtual void SetIntTag(string tagName, int tagValue)Устанавливает тег типа String для устройства.
public virtual void SetStringTag(string tagName, string tagValue)Устанавливает тег типа List для устройства.
public virtual void SetListTag(string tagName, List<object> tagValues)Unreal Engine
FPushwooshModule& pushwoosh = FPushwooshModule::Get();pushwoosh.SetTags("{ \"intTag\" : 1, \"stringTag\" : \"example\", \"listTag\" : [ \"a\", \"b\", \"c\" ] }");Expo
Pushwoosh.setTags({ "key": keyValue, "value": inputValue });.NET MAUI
NSDictionary *tags = @{ @"Alias" : aliasField.text, @"FavNumber" : @([favNumField.text intValue]), @"price" : [PWTags incrementalTagWithInteger:5], @"List" : @[ @"Item1", @"Item2", @"Item3" ]};[[PushNotificationManager pushManager] setTags:tags];Outsystems
Входные параметры
Tags – список записей тегов, содержащих TagName и TagValue.
TagName всегда должен быть типа Text.TagValue может быть Text, Integer, Boolean, Date и т.д.Хотя в большинстве случаев (99%) теги устанавливаются из приложения, вы также можете устанавливать теги через API Pushwoosh. Ниже приведен пример типичного запроса к конечной точке /setTags:
POST https://api.pushwoosh.com/json/1.3/setTags
{ "request": { "application": "XXXXX-XXXXX", // обязательно, код приложения Pushwoosh "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // обязательно, идентификатор аппаратного устройства (HWID), используемый в API /registerDevice "tags": { // обязательно "StringTag": "string value", // Пример строкового тега "IntegerTag": 42, // Пример целочисленного тега "ListTag": ["string1", "string2"], // Пример тега-списка "DateTag": "2024-10-02 22:11", // Примечание: время должно быть в UTC "BooleanTag": true // Допустимые значения: true, false } }}Для получения дополнительной информации обратитесь к документации по API setTags
Местоположение устройства определяется на основе его IP-адреса в момент последнего запуска вашего приложения на этом устройстве. GeoIP передает данные о местоположении в Pushwoosh, и Pushwoosh сохраняет полученное от GeoIP местоположение как значение тега City для конкретного устройства.
В некоторых случаях местоположение, предоставленное GeoIP, отличается от названия города — например, когда оно относится к району города или другой административной единице. Пожалуйста, будьте осторожны при использовании тега City по умолчанию для целей сегментации: убедитесь, что вы выбрали правильные значения.
Например, если вы собираетесь таргетировать пользователей из Мюнхена, вам нужно охватить его несколькими значениями тега City, включая сам “Munich” (со всеми соответствующими значениями, такими как различные варианты написания, которые могут быть возвращены GeoIP и сохранены как значения тега) и несколько близлежащих районов.