Las etiquetas son una de las herramientas más útiles que ofrece Pushwoosh, permitiendo una 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 etiqueta pueden ayudarle a hacer que sus campañas push sean más inteligentes. Cada etiqueta es capaz de almacenar un número casi ilimitado de valores. Básicamente, esto significa que una etiqueta sería suficiente para registrar un tipo específico de información sobre cada usuario final en su base de datos.
Cada tipo de etiqueta tiene un conjunto específico de operadores aplicables. Los operadores de etiqueta 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 (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, anyAl crear una etiqueta, usted elige cómo se almacenan sus valores:
user_specific: false, el valor predeterminado para /addTag): 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 predeterminado en el formulario del Panel de Control y para las etiquetas creadas automáticamente por setTags): 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. SMS Marketing Consent y Viber Marketing Consent son una excepción. Sus desarrolladores las establecen con setTags cuando una persona acepta o rechaza los mensajes de marketing.
| Nombre | Tipo | Dónde se establece | Descripción |
|---|---|---|---|
| Application Version | Version | SDK | Versión actual de la aplicación instalada en un dispositivo |
| Browser Type | String | SDK | Cuando un dispositivo se registra para su proyecto web, su tipo (móvil o de escritorio) se rastrea automáticamente |
| City | String | Servidor | Última ubicación geográfica registrada de un dispositivo |
| Country | String | Servidor | Última ubicación geográfica registrada de un dispositivo |
| Device Model | String | SDK | Indica el modelo del dispositivo en el que está instalada la aplicación |
| First Install | Date | Servidor | Indica la hora en que un dispositivo se registró para recibir notificaciones por primera vez |
| In-app Product | List | SDK | Los productos dentro de la aplicación comprados por un usuario de la aplicación |
| Last In-app Purchase date | Date | SDK | La fecha de la última compra dentro de la aplicación realizada en un dispositivo |
| Language | String | 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 | Date | Servidor | La hora del lanzamiento más reciente de la aplicación en un dispositivo |
| Last Email Open | Date | 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 | String | Servidor | Código de mensaje del correo electrónico abierto más recientemente (formato XXXX-XXXXXXXX-XXXXXXXX). Se actualiza 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 | Date | 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 | String | 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). Se actualiza 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 | Date | Servidor | La fecha de la confirmación de suscripción de doble aceptación más reciente para la dirección de correo electrónico del dispositivo |
| Bounced Email | Date | 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 | Boolean | SDK | Indica si un usuario se ha dado de baja de recibir correos electrónicos de su aplicación |
| SMS Marketing Consent | Boolean | Servidor, setTags | Indica si el suscriptor de SMS aceptó recibir SMS de marketing: true aceptó, false se dio de baja, sin valor desconocido. Más información |
| Viber Marketing Consent | Boolean | Servidor, setTags | Indica si el suscriptor de Viber aceptó recibir mensajes de marketing por Viber: true aceptó, false se dio de baja, sin valor desconocido. Más información |
| OS Version | Version | SDK | La versión de un sistema operativo que se ejecuta en un dispositivo |
| Platform | String | SDK | La plataforma en la que el usuario está utilizando su proyecto. |
| Push Alerts Enabled | Boolean | SDK | Indica si las alertas push están permitidas en la configuración del dispositivo |
| SDK Version | Version | SDK | La versión del SDK de Pushwoosh implementada en un dispositivo |
| Live Activity ID | List | SDK | Se utiliza para gestionar las Live Activities asociando un Live Activity ID con el dispositivo. Se elimina automáticamente después de 12 horas. Reservada: no puede crear una etiqueta personalizada con este nombre. |
| WhatsApp Session Expires At | Date | Servidor | Contiene la ventana de atención al cliente actual de 24 horas abierta por el último mensaje entrante de WhatsApp del cliente. Se establece automáticamente con cada mensaje entrante. Reservada: no puede crear una etiqueta personalizada con este nombre. Almacena solo la ventana actual, sin historial. |
| WhatsApp Ad Click ID | String | Servidor | El ID de clic del anuncio Click-to-WhatsApp (ctwa_clid) del referral de un mensaje entrante de WhatsApp. Meta lo envía una sola vez, en el mensaje que abre la conversación. Un clic más reciente lo sobrescribe junto con WhatsApp Ad Click Date. Un webhook repetido o recibido fuera de orden no lo revierte. |
| WhatsApp Ad Click Date | Date | Servidor | La hora del clic registrado en WhatsApp Ad Click ID. Se actualiza junto con él: un clic más reciente sobrescribe la fecha anterior. |
Aquí es donde entra en juego su creatividad para alcanzar sus objetivos comerciales específicos. Las etiquetas personalizadas se pueden crear en función de la lógica de segmentación o el patrón de orientación que sea apropiado para sus necesidades comerciales únicas. Colabore con su equipo de marketing para definir las etiquetas personalizadas adicionales necesarias para sus campañas.
Crear una etiqueta con antelación es opcional. Enviar un nuevo nombre de etiqueta a través de setTags la crea automáticamente, con el tipo inferido del valor:
4.99, se convierte en Price. Un número como 5.0 se convierte en Integer.2024-10-02 22:11.true o false, o una matriz JSON se tipifica según su contenido, por lo que "42" se convierte en Integer, no en String.Los atributos de eventos no interpretan una cadena según su contenido, por lo que "42" enviado en un evento se convierte en String. Consulte Eventos creados automáticamente.
Una etiqueta creada automáticamente siempre es User-specific (user_specific: true). Agregue la etiqueta explícitamente primero, a través del Panel de Control o /addTag, para una etiqueta de tipo Version, que la creación automática no puede inferir, o para una etiqueta General.
La creación automática de etiquetas está habilitada de forma predeterminada para la gran mayoría de las cuentas. Si setTags no crea una nueva etiqueta como se espera, contacte con el Soporte de Pushwoosh para comprobar si se ha desactivado para su cuenta.
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* | string | Token de acceso a la API desde el Panel de Control de Pushwoosh. |
| tag* | object | Parámetros de la etiqueta. |
| tag.name* | string | Nombre de la etiqueta. |
| tag.type* | integer | Tipo de etiqueta. Vea los valores posibles a continuación. |
| tag.user_specific | boolean | 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 valor 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 muestran ejemplos de implementación para diferentes frameworks utilizando la función setTags.
iOS Nativo
NSDictionary *tags = @{ @"Alias" : aliasField.text, @"FavNumber" : @([favNumField.text intValue]), @"price" : [PWTags incrementalTagWithInteger:5], @"List" : @[ @"Item1", @"Item2", @"Item3" ]};
[[PushNotificationManager pushManager] setTags:tags];Android Nativo
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 Integer para el dispositivo.
public virtual void SetIntTag(string tagName, int tagValue)Establece una etiqueta de tipo String para el dispositivo.
public virtual void SetStringTag(string tagName, string tagValue)Establece una etiqueta de tipo List 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 Text.TagValue puede ser Text, Integer, Boolean, Date, 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 predeterminada City 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 montón de valores de etiqueta City, incluido “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.