Definindo atributos dos seus usuários para uso em segmentação avançada

Nível: Avançado — este artigo pressupõe que você (ou seu time de desenvolvimento) tem acesso ao código-fonte do seu site e conhecimento básico de JavaScript.

O que são "User Attributes"?

São informações sobre um usuário específico do seu site — por exemplo, nome, e-mail, cidade, gênero, ou até dados de negócio como "valor gasto na loja" ou "plano de assinatura". Ao identificar esses atributos, você pode criar segmentos como:

Mostrar uma OnSite apenas para aniversariantes do dia
Enviar uma push apenas para visitantes do gênero feminino

E até fazer combinações desses segmentos, incluindo os atributos customizados, onde você pode definir a sua própria segmentação.

Como enviar os atributos

Para enviar os atributos de um usuário, execute o seguinte código JavaScript na página do seu site (geralmente após o login ou identificação do usuário):

var IlabsPush = IlabsPush || [];
IlabsPush.push([
  "userAttributes", {
    context: {
      "gender": "M",
      "birthday": "1980-04-01",
      "name": "Bruce",
      "surname": "Wayne",
      "username": "bwayne",
      "email": "[email protected]",
      "email_optin": true,
      "phone_number": "+120394879878",
      "language": "en_US",
      "city": "Gotham",
      "country": "United States",
      "custom": {
        "lifetime_value": 5300,
        "alias": "Batman",
      }
    }
  }
]);

⚠️ Atenção: Substitua os valores do exemplo pelas informações reais do usuário logado no momento em que o script é executado. Nunca envie dados fixos ("hardcoded") em produção.

Atributos padrão (pré-definidos)

Estes são os campos que a plataforma já reconhece nativamente:

Atributo	Tipo	Descrição	Exemplo
`gender`	string	Gênero do usuário	`"M"` ou `"F"`
`birthday`	string	Data de nascimento (formato `YYYY-MM-DD`)	`"1980-04-01"`
`name`	string	Primeiro nome	`"Bruce"`
`surname`	string	Sobrenome	`"Wayne"`
`username`	string	Nome de usuário / login	`"bwayne"`
`email`	string	E-mail do usuário	`"[email protected]"`
`email_optin`	boolean	Se o usuário aceitou receber e-mails	`true` / `false`
`phone_number`	string	Telefone com código do país no formato E.164	`"+120394879878"`
`language`	string	Idioma/local preferido	`"en_US"`, `"pt_BR"`
`city`	string	Cidade do usuário	`"Gotham"`
`country`	string	País do usuário, no formato ISO 3166-1 alpha-2	`"US"`
`custom`	object	Atributos customizados do usuário	`{"alias":"Batman"}`

Todos os campos são opcionais — envie apenas os que fizerem sentido para o seu negócio.

💡 Nota: Atualmente, nem todos os atributos listados acima já são utilizáveis para segmentação de campanhas. Estamos trabalhando para expandir essa funcionalidade em breve — mas recomendamos já enviar todos os dados disponíveis, para que fiquem prontos para uso assim que os novos recursos forem lançados.

Atributos customizados

Se você quiser enviar informações específicas do seu negócio que não estão na lista acima, use o objeto custom. Você pode adicionar quantos campos quiser dentro dele:

"custom": {
  "lifetime_value": 5300,
  "alias": "Batman"
}

No exemplo acima:

lifetime_value : um número (receita total que o usuário gerou até então)
alias : um texto livre (apelido do usuário)

Esses atributos customizados também ficam disponíveis para segmentação, assim como os atributos padrão.

Caso você queira utilizar os atributos customizados na segmentação, contate o nosso suporte.

Boas práticas

Execute o código após a identificação do usuário, como no login ou ao carregar a página logada.
Não envie dados sensíveis desnecessários. Envie apenas o que realmente será usado para segmentação.
Mantenha os tipos de dados consistentes. Se lifetime_value for número em um envio, não envie como texto ("5300") em outro.
Atualize os atributos sempre que a informação mudar (ex: se o usuário mudar de cidade ou atualizar o e-mail).

Próximos passos

Depois de implementar o código no seu site, os atributos enviados estarão disponíveis nas telas de criação para você usar na segmentação de campanhas de Push e OnSite.

Ficou com dúvidas sobre a implementação? Fale com nosso time de suporte técnico.