As tags são uma das ferramentas mais úteis que o Pushwoosh oferece, permitindo uma gama de funcionalidades sofisticadas. Ao usar tags, você pode segmentar seu público e enviar notificações push direcionadas para usuários específicos com base em seus atributos.
As tags podem conter quaisquer dados arbitrários associados a um usuário ou dispositivo específico. Esses dados podem incluir nomes de usuário, IDs, cidades, times de futebol favoritos, categorias de notícias preferidas ou qualquer outra informação relevante sobre seus usuários.
Comece identificando as necessidades do seu negócio e determinando como você deseja segmentar seu público. Considere fatores como idade, localização, histórico de compras no aplicativo ou qualquer outro critério relevante para direcionar os usuários.
Os valores das tags podem ajudar a tornar suas campanhas de push mais inteligentes. Cada tag é capaz de armazenar um número quase ilimitado de valores. Basicamente, isso significa que uma tag seria suficiente para registrar um tipo específico de informação sobre cada usuário final em seu banco de dados.
Cada tipo de Tag tem um conjunto específico de operadores aplicáveis. Os operadores de tag definem a relação entre a Tag e seus valores para fins de segmentação.
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, anyAo criar uma tag, você escolhe como seus valores são armazenados:
user_specific: false): o valor da tag é armazenado por dispositivo (HWID). Cada dispositivo do mesmo usuário pode ter um valor diferente de forma independente.user_specific: true): o valor da tag é armazenado por usuário (UserID). Quando definido via UserID, o valor é aplicado a todos os dispositivos do usuário de uma só vez. Útil para atributos que pertencem à pessoa, não a um dispositivo específico: nível de assinatura, pontos de fidelidade, idioma preferido.Um usuário tem as versões iOS e Android do seu aplicativo instaladas. Definir uma tag subscription_tier como "premium" através do seu UserID a aplica a ambos os dispositivos imediatamente. Com uma tag Geral, você precisaria defini-la por dispositivo separadamente.
{ "request":{ "application": "XXXXX-XXXXX", "userId": "the id of a specific user", "tags": { "subscription_tier": "premium", "loyalty_points": 350 } }}Essas tags estão disponíveis no Pushwoosh prontas para uso, então você não precisa (e, na verdade, não deve) configurá-las manualmente. A maioria delas é definida a partir do aplicativo e enviada para nosso servidor via registerDevice e outras chamadas de API, e algumas são definidas pelo próprio servidor.
| Nome | Tipo | Onde é definido | Descrição |
|---|---|---|---|
| Versão do Aplicativo | Version | SDK | Versão atual do aplicativo instalada em um dispositivo |
| Tipo de Navegador | String | SDK | Quando um dispositivo é registrado para o seu projeto web, seu tipo – móvel ou desktop – é rastreado automaticamente |
| Cidade | String | Server | Última localização geográfica registrada de um dispositivo |
| País | String | Server | Última localização geográfica registrada de um dispositivo |
| Modelo do Dispositivo | String | SDK | Indica o modelo do dispositivo onde o aplicativo está instalado |
| Primeira Instalação | Date | Server | Indica a hora em que um dispositivo foi registrado para notificações pela primeira vez |
| Produto In-App | List | SDK | Os produtos in-app comprados por um usuário do aplicativo |
| Data da Última Compra In-App | Date | SDK | A data da última compra in-app feita em um dispositivo |
| Idioma | String | SDK | Abreviação de duas letras minúsculas da localidade de um dispositivo de acordo com a ISO-639-1; obtida das configurações do dispositivo |
| Última Abertura do Aplicativo | Date | Server | A hora do lançamento mais recente do aplicativo em um dispositivo |
| Última Abertura de E-mail | Date | Server | A data em que o endereço de e-mail do dispositivo registrou mais recentemente um evento de abertura de e-mail |
| Código da Mensagem do Último E-mail Aberto | String | Server | Código da mensagem do e-mail aberto mais recentemente (formato XXXX-XXXXXXXX-XXXXXXXX). Atualizado a cada evento PW_EmailOpen. Use-o para segmentar os destinatários de uma campanha de e-mail específica por quem a abriu |
| Último Clique no E-mail | Date | Server | A data em que o endereço de e-mail do dispositivo registrou mais recentemente um clique em um link de e-mail |
| Código da Mensagem do Último Clique no E-mail | String | Server | Código da mensagem do e-mail mais recente em que um link foi clicado (formato XXXX-XXXXXXXX-XXXXXXXX). Atualizado a cada evento PW_EmailLinkClicked. Use-o para segmentar os destinatários de uma campanha de e-mail específica por quem clicou |
| Última Confirmação de E-mail | Date | Server | A data da confirmação de assinatura Double Opt-In mais recente para o endereço de e-mail do dispositivo |
| E-mail Rejeitado | Date | Server | A data em que ocorreu um hard bounce para este endereço de e-mail. Armazenado como Data para permitir a segmentação baseada em tempo, por exemplo, para excluir usuários com rejeições recentes |
| E-mails Cancelados | Boolean | SDK | Indica se um usuário cancelou a inscrição para receber e-mails do seu aplicativo |
| Versão do SO | Version | SDK | A versão de um sistema operacional em execução em um dispositivo |
| Plataforma | String | SDK | A plataforma na qual o usuário está usando seu projeto. |
| Alertas Push Ativados | Boolean | SDK | Indica se os alertas push são permitidos nas configurações do dispositivo |
| Versão do SDK | Version | SDK | A versão do SDK do Pushwoosh implementada em um dispositivo |
É aqui que sua criatividade entra para alcançar seus objetivos de negócios específicos. Tags personalizadas podem ser criadas com base na lógica de segmentação ou no padrão de direcionamento apropriado para suas necessidades de negócios exclusivas. Colabore com sua equipe de marketing para definir as tags personalizadas adicionais necessárias para suas campanhas.
Você pode adicionar uma nova tag no Painel de Controle da Pushwoosh ou usar o método /addTag.
POST https://api.pushwoosh.com/json/1.3/addTag
Cria uma tag em sua conta.
| Nome | Tipo | Descrição |
|---|---|---|
| auth* | string | Token de acesso à API do Painel de Controle da Pushwoosh. |
| tag* | object | Parâmetros da tag. |
| tag.name* | string | Nome da tag. |
| tag.type* | integer | Tipo de tag. Veja os valores possíveis abaixo. |
| tag.user_specific | boolean | Quando true, o valor da tag é armazenado no nível do usuário e compartilhado entre todos os dispositivos de um usuário quando definido por UserID. Quando false (padrão), a tag é no nível do dispositivo e definida por HWID. |
{ "status_code": 200, "status_message": "OK", "response": { "result": true }}{ "request": { "auth": "yxoPUlwqm…………pIyEX4H", // obrigatório, token de acesso à API do Painel de Controle da Pushwoosh "tag": { "name": "TAG_NAME", // obrigatório "type": 1, // obrigatório, veja os valores possíveis abaixo "user_specific": false // opcional. true = nível do usuário; false = nível do dispositivo (padrão) } }}Tipos de valores de tag possíveis:
Depois de adicionar e configurar uma tag, ela está pronta para começar a coletar informações de seus usuários. Siga estes passos para implementá-la:
setTags para atribuir tags e coletar dados do usuário.Abaixo estão exemplos de implementação para diferentes frameworks usando a função 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
Define uma Tag Integer para o dispositivo.
public virtual void SetIntTag(string tagName, int tagValue)Define uma Tag String para o dispositivo.
public virtual void SetStringTag(string tagName, string tagValue)Define uma Tag List para o 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 – Uma lista de registros de tags contendo TagName e TagValue.
TagName deve ser sempre do tipo Text.TagValue pode ser Text, Integer, Boolean, Date, etc.Embora na maioria dos casos (99%), as tags sejam definidas a partir do aplicativo, você também pode definir tags via API da Pushwoosh. Abaixo está um exemplo de uma solicitação típica para o endpoint /setTags:
POST https://api.pushwoosh.com/json/1.3/setTags
{ "request": { "application": "XXXXX-XXXXX", // obrigatório, código do aplicativo Pushwoosh "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // obrigatório, ID de hardware do dispositivo usado na API /registerDevice "tags": { // obrigatório "StringTag": "string value", // Exemplo de uma tag de string "IntegerTag": 42, // Exemplo de uma tag de inteiro "ListTag": ["string1", "string2"], // Exemplo de uma tag de lista "DateTag": "2024-10-02 22:11", // Nota: o tempo deve estar em UTC "BooleanTag": true // Valores válidos: true, false } }}Para mais detalhes, consulte a documentação da API setTags
A localização do dispositivo é determinada com base em seu endereço IP no momento em que seu aplicativo foi iniciado nesse dispositivo pela última vez. O GeoIP envia os dados de localização para a Pushwoosh, e a Pushwoosh salva a localização recebida do GeoIP como um valor de tag City para um dispositivo específico.
Em alguns casos, a localização enviada pelo GeoIP difere do nome da cidade — por exemplo, quando se refere a uma área de uma cidade ou outra unidade administrativa. Tenha cuidado ao usar a tag City padrão para fins de segmentação: certifique-se de selecionar os valores adequados.
Por exemplo, se você for direcionar usuários de Munique, terá que cobri-lo com um conjunto de valores de tag City, incluindo “Munique” em si (com todos os valores correspondentes, como diferentes variantes de ortografia que poderiam ser retornadas pelo GeoIP e salvas como valores de tag) e várias áreas próximas.