Las etiquetas son una de las herramientas más útiles que ofrece Pushwoosh, permitiendo una amplia gama de funcionalidades sofisticadas. Al usar etiquetas, puede segmentar su audiencia y enviar notificaciones push dirigidas a usuarios específicos según sus atributos.
Las etiquetas pueden contener cualquier dato arbitrario asociado con un usuario o dispositivo en particular. Estos datos pueden incluir nombres de usuario, ID, ciudades, equipos de fútbol favoritos, categorías de noticias preferidas o cualquier otra información relevante sobre sus usuarios.
Comience por identificar las necesidades de su negocio y determinar cómo desea segmentar a su audiencia. Considere factores como la edad, la ubicación, el historial de compras dentro de la aplicación o cualquier otro criterio relevante para dirigirse a los usuarios.
Los valores de las etiquetas pueden ayudarle a hacer que sus campañas de push sean más inteligentes. Cada etiqueta es capaz de almacenar un número casi ilimitado de valores. Básicamente, esto significa que una sola etiqueta sería suficiente para registrar un tipo específico de información sobre cada usuario final en su base de datos.
Solo hay unas pocas etiquetas disponibles para cada cuenta, pero considerando el espacio casi infinito para cada etiqueta, solo un par de etiquetas son suficientes para recopilar una enorme cantidad de información sobre sus usuarios y configurar patrones de segmentación muy complejos.
Cada tipo de Etiqueta tiene un conjunto específico de operadores aplicables. Los operadores de etiquetas definen la relación entre la Etiqueta y sus valores para fines de segmentación.
is, is not, are, not in, not set, anyis, is not, are, not in, not set, anyin, not in, not set, anyis (verdadero/falso), 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, anyAl crear una etiqueta, usted elige cómo se almacenan sus valores:
user_specific: false): el valor de la etiqueta se almacena por dispositivo (HWID). Cada dispositivo del mismo usuario puede tener un valor diferente de forma independiente.user_specific: true): el valor de la etiqueta se almacena por usuario (UserID). Cuando se establece a través de UserID, el valor se aplica a todos los dispositivos del usuario a la vez. Útil para atributos que pertenecen a la persona, no a un dispositivo en particular: nivel de suscripción, puntos de fidelidad, idioma preferido.Un usuario tiene instaladas las versiones de su aplicación para iOS y Android. Establecer una etiqueta subscription_tier en "premium" a través de su UserID la aplica a ambos dispositivos de inmediato. Con una etiqueta General, necesitaría establecerla por dispositivo por separado.
{ "request":{ "application": "XXXXX-XXXXX", "userId": "the id of a specific user", "tags": { "subscription_tier": "premium", "loyalty_points": 350 } }}Estas etiquetas están disponibles de forma predeterminada en Pushwoosh, por lo que no tiene que (y, de hecho, no debería) establecerlas manualmente. La mayoría de ellas se establecen desde la aplicación y se envían a nuestro servidor a través de registerDevice y otras llamadas a la API, y algunas son establecidas por el propio servidor.
| Nombre | Tipo | Dónde se establece | Descripción |
|---|---|---|---|
| Application Version | Versión | SDK | Versión actual de la aplicación instalada en un dispositivo |
| Browser Type | Cadena | SDK | Cuando un dispositivo se registra para su proyecto web, su tipo (móvil o de escritorio) se rastrea automáticamente |
| City | Cadena | Servidor | Última ubicación geográfica registrada de un dispositivo |
| Country | Cadena | Servidor | Última ubicación geográfica registrada de un dispositivo |
| Device Model | Cadena | SDK | Indica el modelo del dispositivo donde está instalada la aplicación |
| First Install | Fecha | Servidor | Indica la hora en que un dispositivo se registró para recibir notificaciones por primera vez |
| In-App Product | Lista | SDK | Los productos dentro de la aplicación comprados por un usuario de la aplicación |
| Last In-App Purchase Date | Fecha | SDK | La fecha de la última compra dentro de la aplicación realizada en un dispositivo |
| Language | Cadena | SDK | Abreviatura de dos letras en minúsculas de la configuración regional de un dispositivo según ISO-639-1; tomada de la configuración del dispositivo |
| Last Application Open | Fecha | Servidor | La hora del lanzamiento más reciente de la aplicación en un dispositivo |
| Last Email Open | Fecha | Servidor | La fecha en que la dirección de correo electrónico del dispositivo registró más recientemente un evento de apertura de correo electrónico |
| Last Email Open Message Code | Cadena | Servidor | Código de mensaje del correo electrónico abierto más recientemente (formato XXXX-XXXXXXXX-XXXXXXXX). Actualizado en cada evento PW_EmailOpen. Úselo para segmentar a los destinatarios de una campaña de correo electrónico específica por quién la abrió |
| Last Email Click | Fecha | Servidor | La fecha en que la dirección de correo electrónico del dispositivo registró más recientemente un clic en un enlace de correo electrónico |
| Last Email Click Message Code | Cadena | Servidor | Código de mensaje del correo electrónico más reciente en el que se hizo clic en un enlace (formato XXXX-XXXXXXXX-XXXXXXXX). Actualizado en cada evento PW_EmailLinkClicked. Úselo para segmentar a los destinatarios de una campaña de correo electrónico específica por quién hizo clic |
| Last Email Confirm | Fecha | Servidor | La fecha de la confirmación de suscripción de Doble Opt-In más reciente para la dirección de correo electrónico del dispositivo |
| Bounced Email | Fecha | Servidor | La fecha en que ocurrió un rebote duro para esta dirección de correo electrónico. Se almacena como Fecha para permitir la segmentación basada en el tiempo, por ejemplo, para excluir a los usuarios con rebotes recientes |
| Unsubscribed Emails | Booleano | SDK | Indica si un usuario se ha dado de baja de recibir correos electrónicos de su aplicación |
| OS Version | Versión | SDK | La versión de un sistema operativo que se ejecuta en un dispositivo |
| Platform | Cadena | SDK | La plataforma en la que el usuario está utilizando su proyecto. |
| Push Alerts Enabled | Booleano | SDK | Indica si las alertas push están permitidas en la configuración del dispositivo |
| SDK Version | Versión | SDK | La versión del SDK de Pushwoosh implementada en un dispositivo |
Aquí es donde entra en juego su creatividad para alcanzar sus objetivos de negocio específicos. Se pueden crear etiquetas personalizadas basadas en la lógica de segmentación o el patrón de segmentación que sea apropiado para sus necesidades de negocio únicas. Colabore con su equipo de marketing para definir las etiquetas personalizadas adicionales necesarias para sus campañas.
Puede agregar una nueva etiqueta en el Panel de Control de Pushwoosh o usar el método /addTag.
POST https://api.pushwoosh.com/json/1.3/addTag
Crea una etiqueta en su cuenta.
| Nombre | Tipo | Descripción |
|---|---|---|
| auth* | cadena | Token de acceso a la API desde el Panel de Control de Pushwoosh. |
| tag* | objeto | Parámetros de la etiqueta. |
| tag.name* | cadena | Nombre de la etiqueta. |
| tag.type* | entero | Tipo de etiqueta. Vea los valores posibles a continuación. |
| tag.user_specific | booleano | Cuando es true, el valor de la etiqueta se almacena a nivel de usuario y se comparte entre todos los dispositivos de un usuario cuando se establece por UserID. Cuando es false (predeterminado), la etiqueta es a nivel de dispositivo y se establece por HWID. |
{ "status_code": 200, "status_message": "OK", "response": { "result": true }}{ "request": { "auth": "yxoPUlwqm…………pIyEX4H", // requerido, token de acceso a la API desde el Panel de Control de Pushwoosh "tag": { "name": "TAG_NAME", // requerido "type": 1, // requerido, vea los valores posibles a continuación "user_specific": false // opcional. true = a nivel de usuario; false = a nivel de dispositivo (predeterminado) } }}Posibles tipos de valores de etiqueta:
Una vez que haya agregado y configurado una etiqueta, está lista para comenzar a recopilar información de sus usuarios. Siga estos pasos para implementarla:
setTags para asignar etiquetas y recopilar datos de los usuarios.A continuación se presentan ejemplos de implementación para diferentes frameworks utilizando la función 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
Establece una etiqueta de tipo Entero para el dispositivo.
public virtual void SetIntTag(string tagName, int tagValue)Establece una etiqueta de tipo Cadena para el dispositivo.
public virtual void SetStringTag(string tagName, string tagValue)Establece una etiqueta de tipo Lista para el dispositivo.
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
Parámetros de entrada
Tags – Una lista de registros de etiquetas que contienen TagName y TagValue.
TagName siempre debe ser de tipo Texto.TagValue puede ser Texto, Entero, Booleano, Fecha, etc.Aunque en la mayoría de los casos (99%), las etiquetas se establecen desde la aplicación, también puede establecer etiquetas a través de la API de Pushwoosh. A continuación se muestra un ejemplo de una solicitud típica al endpoint /setTags:
POST https://api.pushwoosh.com/json/1.3/setTags
{ "request": { "application": "XXXXX-XXXXX", // requerido, código de aplicación de Pushwoosh "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // requerido, ID de dispositivo de hardware utilizado en la API /registerDevice "tags": { // requerido "StringTag": "string value", // Ejemplo de una etiqueta de cadena "IntegerTag": 42, // Ejemplo de una etiqueta de entero "ListTag": ["string1", "string2"], // Ejemplo de una etiqueta de lista "DateTag": "2024-10-02 22:11", // Nota: la hora debe estar en UTC "BooleanTag": true // Valores válidos: true, false } }}Para más detalles, consulte la documentación de la API setTags
La ubicación del dispositivo se determina en función de su dirección IP en el momento en que su aplicación se inició en ese dispositivo por última vez. GeoIP envía los datos de ubicación a Pushwoosh, y Pushwoosh guarda la ubicación recibida de GeoIP como un valor de etiqueta City para un dispositivo en particular.
En algunos casos, la ubicación enviada por GeoIP difiere del nombre de la ciudad; por ejemplo, cuando se refiere a un área de una ciudad u otra unidad administrativa. Tenga cuidado al usar la etiqueta City predeterminada para fines de segmentación: asegúrese de seleccionar los valores adecuados.
Por ejemplo, si va a dirigirse a usuarios de Múnich, tiene que cubrirlo con un conjunto de valores de la etiqueta City, incluyendo “Munich” en sí (con todos los valores correspondientes, como diferentes variantes de ortografía que podrían ser devueltas por GeoIP y guardadas como valores de etiqueta) y varias áreas cercanas.