Tags

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.

Decidindo quais tags usar

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.

Dica

A equipe de marketing pode precisar se envolver nesse processo para ajudar a decidir quais tags se alinham melhor com seus objetivos de marketing e estratégias de segmentação de público.

Valores das tags

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 única tag seria suficiente para registrar um tipo específico de informação sobre cada usuário final em seu banco de dados.

Tipos de tags

• Integer — usado para dados inteiros (quantidade de dinheiro no jogo adquirida, nível alcançado, idade).
• String — usado para valores de string (nome de usuário, e-mail, identificadores).
• List — o mesmo que o tipo String, mas cada usuário pode ter vários valores definidos simultaneamente (preferências musicais, categorias de notícias, preferências culinárias).
• Boolean — tipo verdadeiro / falso de Tag.
• Date — usado para datas de calendário. Basicamente, este é um tipo de tag inteiro que armazena timestamps Unix Epoch (convertidos automaticamente de/para a data Gregoriana).
• Price — permite definir valores de acordo com a moeda especificada no formato “*.XX” Saiba mais.
• Version — usado para versionamento. O exemplo de formato permitido é w.x.y.z (Major.Minor.Patch.Build). O valor máximo para cada parte da versão é 9999, então o número máximo da versão não pode ser maior que 9999.9999.9999.9999.

Operadores de tag

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.

• Operadores de Tag Integer: is, is not, are, not in, not set, any
• Operadores de Tag String: is, is not, are, not in, not set, any
• Operadores de Tag List: in, not in, not set, any
• Operadores de Tag Boolean: is (true/false), not set, any
• Operadores de Tag Date: exactly on, on or after, on or before, between, not set, any
• Operadores de Tag Price: is, is not, greater or equals, less or equals, between, in, not in, not set, any
• Operadores de Tag Version: is, is not, greater or equals, less or equals, between, in, not in, not set, any

Nota

Os operadores “Not set” e “any” estão disponíveis para todos os tipos de Tags.

Escopo da tag: Geral vs. Específico do usuário

Ao criar uma tag, você escolhe como seus valores são armazenados:

• Geral (padrão, 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.
• Específico do usuário (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.

Exemplo

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.

Exemplo: definir uma tag específica do usuário via UserID

{
   "request":{
      "application": "XXXXX-XXXXX",
      "userId": "the id of a specific user",
      "tags": {
           "subscription_tier": "premium",
           "loyalty_points": 350
      }
   }
}

Tags padrão

Essas tags estão disponíveis prontas para uso no Pushwoosh, 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 através de registerDevice e outras chamadas de API, e algumas são definidas pelo próprio servidor.

Nome	Tipo	Onde é definido	Descrição
Application Version	Version	SDK	Versão atual do aplicativo instalada em um dispositivo
Browser Type	String	SDK	Quando um dispositivo é registrado para o seu projeto web, seu tipo – móvel ou desktop – é rastreado automaticamente
City	String	Server	Última localização geográfica registrada de um dispositivo
Country	String	Server	Última localização geográfica registrada de um dispositivo
Device Model	String	SDK	Indica o modelo do dispositivo onde o aplicativo está instalado
First Install	Date	Server	Indica a data em que um dispositivo foi registrado para notificações pela primeira vez
In-App Product	List	SDK	Os produtos in-app comprados por um usuário do aplicativo
Last In-App Purchase Date	Date	SDK	A data da última compra in-app feita em um dispositivo
Language	String	SDK	Abreviação de duas letras em minúsculas da localidade de um dispositivo de acordo com a ISO-639-1; retirada das configurações do dispositivo
Last Application Open	Date	Server	A hora do lançamento mais recente do aplicativo em um dispositivo
Last Email Open	Date	Server	A data em que o endereço de e-mail do dispositivo registrou mais recentemente um evento de abertura de e-mail
Last Email Open Message Code	String	Server	Código da mensagem do e-mail aberto mais recentemente (formato XXXX-XXXXXXXX-XXXXXXXX). Atualizado em cada evento PW_EmailOpen. Use-o para segmentar destinatários de uma campanha de e-mail específica por quem a abriu
Last Email Click	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
Last Email Click Message Code	String	Server	Código da mensagem do e-mail mais recente em que um link foi clicado (formato XXXX-XXXXXXXX-XXXXXXXX). Atualizado em cada evento PW_EmailLinkClicked. Use-o para segmentar destinatários de uma campanha de e-mail específica por quem clicou
Last Email Confirm	Date	Server	A data da mais recente confirmação de assinatura Double Opt-In para o endereço de e-mail do dispositivo
Bounced Email	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 bounces recentes
Unsubscribed Emails	Boolean	SDK	Indica se um usuário cancelou a inscrição para receber e-mails do seu aplicativo
OS Version	Version	SDK	A versão do sistema operacional em execução em um dispositivo
Platform	String	SDK	A plataforma na qual o usuário está usando seu projeto.
Push Alerts Enabled	Boolean	SDK	Indica se os alertas push são permitidos nas configurações do dispositivo
SDK Version	Version	SDK	A versão do SDK do Pushwoosh implementada em um dispositivo

Tags personalizadas

É aqui que sua criatividade entra para alcançar seus objetivos de negócio 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ócio únicas. Colabore com sua equipe de marketing para definir as tags personalizadas adicionais necessárias para suas campanhas.

Como configurar uma tag personalizada

Você pode adicionar uma nova tag no Painel de Controle do Pushwoosh ou usar o método /addTag.

addTag

POST https://api.pushwoosh.com/json/1.3/addTag

Cria uma tag em sua conta.

Corpo da Requisição

Nome	Tipo	Descrição
auth*	string	Token de acesso à API do Painel de Controle do Pushwoosh.
tag*	object	Parâmetros da tag.
tag.name*	string	Nome da tag.
tag.type*	integer	Tipo da 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 é de nível de dispositivo e definida por HWID.

200

{
    "status_code": 200,
    "status_message": "OK",
    "response": {
        "result": true
    }
}

Exemplo

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // obrigatório, token de acesso à API do Painel de Controle do Pushwoosh
    "tag": {
      "name": "TAG_NAME",    // obrigatório
      "type": 1,             // obrigatório, veja os valores possíveis abaixo
      "user_specific": false // opcional. true = nível de usuário; false = nível de dispositivo (padrão)
    }
  }
}

Tipos de valores de tag possíveis:

• 1 - Integer
• 2 - String
• 3 - Lista
• 4 - Data
• 5 - Booleano
• 6 - Decimal. Ex: 19.95
• 7 - Versão. Ex: “1.0.0.0”

Como coletar informações dos usuários

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:

1. Integre o SDK do Pushwoosh em seu projeto seguindo o guia de integração relevante.
2. Use a função 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

iOS Nativo

NSDictionary *tags = @{
    @"Alias" : aliasField.text,
    @"FavNumber" : @([favNumField.text intValue]),
    @"price" : [PWTags incrementalTagWithInteger:5],
    @"List" : @[ @"Item1", @"Item2", @"Item3" ]
};

[[PushNotificationManager pushManager] setTags:tags];

Documentação

Android Nativo

Android Nativo

pushwoosh.setTags(Tags.intTag("intTag", 42));

Documentação

Cordova

Cordova

PushNotification.prototype.setTags = function(  config, success, fail  )

Documentação

Flutter

Flutter

Future<void> setTags(Map tags) async {
  await _channel.invokeMethod("setTags", {"tags" : tags});
}

Documentação

React Native

React Native

pushNotification.setTags({
    "string_tag" : "Hello world",
    "int_tag" : 42,
    "list_tag":["hello", "world"]
});

Documentação

Unity

Unity

SetIntTag

Define uma Tag Integer para o dispositivo.

public virtual void SetIntTag(string tagName, int tagValue)

SetStringTag

Define uma Tag String para o dispositivo.

public virtual void SetStringTag(string tagName, string tagValue)

SetListTag

Define uma Tag de Lista para o dispositivo.

public virtual void SetListTag(string tagName, List<object> tagValues)

Documentação

Unreal Engine

Unreal Engine

FPushwooshModule& pushwoosh = FPushwooshModule::Get();
pushwoosh.SetTags("{ \"intTag\" : 1, \"stringTag\" : \"example\", \"listTag\" : [ \"a\", \"b\", \"c\" ] }");

Documentação

Expo

Expo

Pushwoosh.setTags({ "key": keyValue, "value": inputValue });

Documentação

.NET MAUI

.NET MAUI

NSDictionary *tags = @{
    @"Alias" : aliasField.text,
    @"FavNumber" : @([favNumField.text intValue]),
    @"price" : [PWTags incrementalTagWithInteger:5],
    @"List" : @[ @"Item1", @"Item2", @"Item3" ]
};
[[PushNotificationManager pushManager] setTags:tags];

Documentação

Outsystems

Outsystems

Parâmetros de entrada Tags – Uma lista de registros de tag contendo TagName e TagValue.

• TagName deve ser sempre do tipo Texto.
• TagValue pode ser Texto, Inteiro, Booleano, Data, etc.

Saiba mais

Definindo tags via API

Embora na maioria dos casos (99%), as tags sejam definidas a partir do aplicativo, você também pode definir tags através da API do Pushwoosh. Abaixo está um exemplo de uma requisiçã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 do dispositivo de hardware 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

Usando a tag padrão City

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 time. O GeoIP envia os dados de localização para o Pushwoosh, e o 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 cobrir isso com um conjunto de valores da tag City, incluindo “Munique” em si (com todos os valores correspondentes, como diferentes variantes de grafia que poderiam ser retornadas pelo GeoIP e salvas como valores de tag) e várias áreas próximas.

Dica

Antes de criar um Segmento através da API, verifique os valores que seus usuários têm em seus dispositivos através da requisição /getTagStats.