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 en función de 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 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 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.
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, anyEste parámetro describe el comportamiento de las etiquetas en relación con diferentes aplicaciones en la misma cuenta. Las etiquetas específicas de la aplicación pueden tener diferentes conjuntos de valores para cada aplicación en la misma cuenta. Las etiquetas no específicas de la aplicación, por el contrario, almacenan el mismo valor para todas las aplicaciones que usan esta etiqueta.
Digamos que tiene dos aplicaciones, una de Noticias y un Juego, y desea dirigirse solo a aquellos usuarios que han aceptado explícitamente recibir notificaciones push de usted. Entonces, crea una etiqueta booleana llamada “Suscrito” y establece el valor "true" para los usuarios que desean recibir notificaciones push de usted, y "false" para aquellos que no quieren ser notificados.
Una de sus usuarias, Ana, ha instalado ambas aplicaciones. A ella no le importa que le notifiquen sobre noticias de última hora, pero ha optado por no recibir ninguna notificación push de la aplicación del Juego.
Si la etiqueta “Suscrito” es específica de la aplicación, todo saldrá según lo planeado. Sin embargo, en caso de que esta etiqueta no fuera específica de la aplicación, cada una de sus aplicaciones sobrescribirá el valor establecido por la otra aplicación, lo que puede arruinar su segmentación y causar frustración.
Por otro lado, las etiquetas no específicas de la aplicación pueden ser útiles si desea realizar una segmentación entre aplicaciones y rastrear a los usuarios que tienen el mismo nombre de usuario en diferentes aplicaciones.
Todas las etiquetas en Pushwoosh son específicas del usuario por diseño y se asignan a todos los dispositivos del usuario cuando se establecen por UserID en lugar de HWID.
{ "request":{ "application": "XXXXX-XXXXX", // Pushwoosh application code "userId": "the id of a specific user", "tags": { "UserSpecificStringTag": "string value", "UserSpecificIntegerTag": 42 } }}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 | 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 | Server | Última ubicación geográfica registrada de un dispositivo |
| Country | String | Server | Ú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 | Server | Indica la fecha 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 | Server | La hora del lanzamiento más reciente de la aplicación en un dispositivo |
| OS Version | Version | SDK | La versión del 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 |
| Unsubscribed Emails | Boolean | SDK | Indica si un usuario se ha dado de baja para no recibir correos electrónicos de su aplicación |
Aquí es donde entra en juego su creatividad para alcanzar sus objetivos comerciales 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 comerciales ú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* | 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.application_specific | boolean | Define si el valor de la etiqueta debe ser diferente para múltiples aplicaciones o ser el mismo en todas ellas. |
{ "status_code": 200, "status_message": "OK", "response": { "result": true }}{ "request": { "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel "tag": { "name": "TAG_NAME", // required "type": 1, // required, see possible values below "application_specific": true, // or 'false', optional. Defines whether the tag value should be different for multiple apps or be the same across multiple apps "user_specific": true // or 'false', optional, used for application_specific tags } }}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 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 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", // required, Pushwoosh application code "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // required, hardware device ID used in /registerDevice API "tags": { // required "StringTag": "string value", // Example of a string tag "IntegerTag": 42, // Example of an integer tag "ListTag": ["string1", "string2"], // Example of a list tag "DateTag": "2024-10-02 22:11", // Note: time must be in UTC "BooleanTag": true // Valid values: 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ó por última vez en ese dispositivo. 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, debe cubrirlo con un conjunto de valores de etiqueta City, incluyendo “Múnich” mismo (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.