O que é um atributo de lista?

Um atributo de lista armazena vários valores de texto para um único usuário ou empresa, como funções, recursos habilitados ou equipes. Você pode usá-lo para segmentar usuários que possuem um valor específico, qualquer um de vários valores ou todos os valores de um conjunto.

Atributos da lista de envio

Envie um array através de window.userGuiding.identify() ou da API de Usuário:

 window.userGuiding.identify(userId, {
  roles: ["admin", "editor"],
  company: {
    id: '1',
    features: ["reports", "exports"]
  }
 });

O UserGuiding normaliza os valores da lista da seguinte forma:

• Os itens de texto são mantidos como estão.
• Os valores booleanos se tornam "verdadeiro" ou "falso", e os números se transformam em texto.
• Valores aninhados e itens com mais de 1024 caracteres são descartados.
• Apenas os primeiros 100 itens serão mantidos.
• Um array vazio é considerado como nenhum valor.

Filtragem com atributos de lista

Na página de Usuários e nos segmentos, os atributos de lista oferecem estas condições:

• Inclui : a lista contém o valor fornecido.
• Não inclui : a lista não contém o valor fornecido.
• Inclui um ou mais dos seguintes : a lista contém pelo menos um dos valores fornecidos.
• Inclui todos os itens : a lista contém todos os valores fornecidos.
• Possui qualquer valor : o atributo tem pelo menos um item.
• Não é conhecido : o atributo está ausente ou vazio.
  

Para "inclui um ou mais dos" e "inclui todos os", insira vários valores separados por vírgulas. A correspondência compara itens inteiros e ignora maiúsculas e minúsculas, portanto "Admin" corresponde a "admin", mas "adm" não. Se um atributo foi enviado anteriormente como um único valor de texto, ele será tratado como uma lista de um único item.

Convertendo um atributo em lista

Acesse Configurações > Dados , abra as configurações de um atributo de Texto, selecione Lista como formato de dados e clique em Salvar . Somente atributos de Texto podem ser convertidos; um atributo de Lista não pode ser convertido para outro formato posteriormente.

Como os valores da lista aparecem

A página de Usuários e as páginas de detalhes do usuário e da empresa exibem os valores da lista entre colchetes, por exemplo, [admin, editor] . As exportações em CSV e as macros de personalização, como {{roles}} unem os itens com uma vírgula, por exemplo, "admin, editor".