Теги — один из самых полезных инструментов, предлагаемых 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Этот параметр описывает поведение тегов по отношению к разным приложениям в одной учетной записи. Специфичные для приложения теги могут иметь разные наборы значений для каждого приложения в одной учетной записи. Неспецифичные для приложения теги, наоборот, хранят одно и то же значение для всех приложений, использующих этот тег.
Допустим, у вас есть два приложения, новостное приложение и игра, и вы хотите нацелиться только на тех пользователей, которые явно согласились получать от вас push-уведомления. Итак, вы создаете логический тег с именем «Subscribed» и устанавливаете значение "true" для пользователей, которые хотят получать от вас push-уведомления, и "false" для тех, кто не хочет получать уведомления.
Одна из ваших пользовательниц, Анна, установила оба ваших приложения. Она не против получать уведомления о некоторых экстренных новостях, но отказалась от любых push-уведомлений из игрового приложения.
Если тег «Subscribed» является специфичным для приложения, все пойдет по плану. Однако, если этот тег был неспецифичным для приложения, то каждое из ваших приложений будет перезаписывать значение, установленное другим приложением, что может нарушить ваш таргетинг и вызвать разочарование.
С другой стороны, неспецифичные для приложения теги могут быть полезны, если вы хотите выполнять кросс-приложенческий таргетинг и отслеживать пользователей, у которых одинаковое имя пользователя в разных приложениях.
Все теги в Pushwoosh по своей сути являются специфичными для пользователя и назначаются для всех устройств пользователя при установке по UserID вместо HWID.
{ "request":{ "application": "XXXXX-XXXXX", // Код приложения Pushwoosh "userId": "идентификатор конкретного пользователя", "tags": { "UserSpecificStringTag": "строковое значение", "UserSpecificIntegerTag": 42 } }}Эти теги доступны в Pushwoosh «из коробки», поэтому вам не нужно (и, на самом деле, не следует) устанавливать их вручную. Большинство из них устанавливаются из приложения и отправляются на наш сервер через registerDevice и другие вызовы API, а некоторые устанавливаются самим сервером.
| Имя | Тип | Где устанавливается | Описание |
|---|---|---|---|
| Application Version | Version | SDK | Текущая версия приложения, установленная на устройстве |
| Browser Type | String | SDK | Когда устройство регистрируется для вашего веб-проекта, его тип — мобильный или настольный — отслеживается автоматически |
| City | String | Сервер | Последнее зарегистрированное географическое местоположение устройства |
| Country | String | Сервер | Последнее зарегистрированное географическое местоположение устройства |
| Device Model | String | SDK | Указывает модель устройства, на котором установлено приложение |
| First Install | Date | Сервер | Указывает время, когда устройство было впервые зарегистрировано для получения уведомлений |
| In-App Product | List | SDK | Внутриигровые продукты, приобретенные пользователем приложения |
| Last In-App Purchase Date | Date | SDK | Дата последней покупки в приложении, совершенной на устройстве |
| Language | String | SDK | Двухбуквенное сокращение в нижнем регистре для локали устройства в соответствии с ISO-639-1; берется из настроек устройства |
| Last Application Open | Date | Сервер | Время последнего запуска приложения на устройстве |
| OS Version | Version | SDK | Версия операционной системы, работающей на устройстве |
| Platform | String | SDK | Платформа, на которой пользователь использует ваш проект. |
| Push Alerts Enabled | Boolean | SDK | Указывает, разрешены ли push-уведомления в настройках устройства |
| SDK Version | Version | SDK | Версия Pushwoosh SDK, реализованная на устройстве |
| Unsubscribed Emails | Boolean | SDK | Указывает, отписался ли пользователь от получения электронных писем от вашего приложения |
Здесь вступает в игру ваша креативность для достижения ваших конкретных бизнес-целей. Пользовательские теги могут быть созданы на основе логики сегментации или шаблона таргетинга, который подходит для ваших уникальных бизнес-потребностей. Сотрудничайте с вашей маркетинговой командой, чтобы определить дополнительные пользовательские теги, необходимые для ваших кампаний.
Вы можете добавить новый тег в Панели управления Pushwoosh или использовать метод /addTag.
POST https://api.pushwoosh.com/json/1.3/addTag
Создает тег в вашей учетной записи.
| Имя | Тип | Описание |
|---|---|---|
| auth* | string | Токен доступа к API из Панели управления Pushwoosh. |
| tag* | object | Параметры тега. |
| tag.name* | string | Имя тега. |
| tag.type* | integer | Тип тега. См. возможные значения ниже. |
| tag.application_specific | boolean | Определяет, должно ли значение тега быть разным для нескольких приложений или одинаковым для всех приложений. |
{ "status_code": 200, "status_message": "OK", "response": { "result": true }}{ "request": { "auth": "yxoPUlwqm…………pIyEX4H", // обязательно, токен доступа к API из Панели управления Pushwoosh "tag": { "name": "TAG_NAME", // обязательно "type": 1, // обязательно, см. возможные значения ниже "application_specific": true, // или 'false', необязательно. Определяет, должно ли значение тега быть разным для нескольких приложений или одинаковым для всех приложений "user_specific": true // или 'false', необязательно, используется для тегов application_specific } }}Возможные типы значений тегов:
После того как вы добавили и настроили тег, он готов к сбору информации от ваших пользователей. Выполните следующие шаги для его реализации:
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", // обязательно, идентификатор аппаратного устройства, используемый в /registerDevice API "tags": { // обязательно "StringTag": "строковое значение", // Пример строкового тега "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, включая сам «Мюнхен» (со всеми соответствующими значениями, такими как различные варианты написания, которые могут быть возвращены GeoIP и сохранены как значения тега) и несколько близлежащих районов.