listar

Última atualização em 2024-01-26
  • Tópicos
  • Variables
    Exibir mais informações sobre este tópico
  • Criado para:
  • Admin
    Developer

As variáveis de lista são variáveis personalizadas que podem ser usadas da maneira que você desejar. Elas funcionam de forma semelhante às eVars, mas podem conter vários valores na mesma ocorrência. As variáveis de lista não têm limite de caracteres.

Registre a maneira como você usa cada variável de lista e a sua lógica no documento de design da solução.

OBSERVAÇÃO

As variáveis de lista armazenam os 250 valores mais recentes por visitante. Se houver mais de 250 valores únicos para um determinado visitante, os valores mais antigos não serão atribuídos a métricas.

Configurar variáveis de lista nas configurações do conjunto de relatórios

Certifique-se de configurar cada variável de lista nas configurações do conjunto de relatórios antes de usá-las na implementação. Consulte Variáveis de conversão no Guia de administração. Esta etapa se aplica a todos os métodos de implementação.

Variáveis de lista usando o SDK da Web

As variáveis de lista são mapeadas para o Adobe Analytics nos campos XDM _experience.analytics.customDimensions.lists.list1.list[] a _experience.analytics.customDimensions.lists.list3.list[]. Cada elemento de matriz contém um objeto "value" que contém cada string. Não há necessidade de fornecer um delimitador; um é incluído automaticamente usando o valor especificado nas configurações do conjunto de relatórios. Por exemplo, se uma vírgula (“,”) estiver configurada como delimitador para a variável de lista 1, o seguinte objeto XDM preencherá a variável list1 com "Example value 1,Example value 2,Example value 3".

"xdm": {
  "_experience": {
    "analytics": {
      "customDimensions": {
        "lists": {
          "list1": {
            "list": [
              {
                "value": "Example value 1"
              },
              {
                "value": "Example value 2"
              },
              {
                "value": "Example value 3"
              }
            ]
          }
        }
      }
    }
  }
}
OBSERVAÇÃO

O esquema XDM da Adobe contém objetos key e value em cada matriz list[]. A Adobe não usa os objetos key ao enviar dados para o Adobe Analytics.

Variáveis de lista que usando a extensão do Adobe Analytics

Não há um campo dedicado na extensão do Adobe Analytics para o uso dessa variável. Use o editor de código personalizado após a sintaxe do AppMeasurement.

s.list1 - s.list3 no AppMeasurement e no editor de código personalizado da extensão do Analytics

Cada variável de lista é uma string que contém valores personalizados específicos para sua organização. Elas não têm uma contagem máxima de bytes; no entanto, cada valor individual tem no máximo 255 bytes. O delimitador usado é determinado ao configurar a variável nas configurações do conjunto de relatórios. Não use espaços ao delimitar vários itens.

// A list variable configured with a comma as a delimiter
s.list1 = "Example value 1,Example value 2,Example value 3";
DICA

Se você definir valores duplicados na mesma ocorrência, a Adobe desduplica todas as instâncias desses valores. Por exemplo, se você definir s.list1 = "Brick,Brick";, uma instância será contada nos relatórios.

Comparar props de lista a vars de lista

Propriedades de lista e vars de lista podem conter vários valores na mesma ocorrência. No entanto, existem várias diferenças entre esses dois tipos de variáveis.

  • Qualquer prop pode se tornar uma prop de lista. Você pode ter até 75 propriedades de lista se cada prop for uma prop de lista. Há apenas três variáveis de lista disponíveis.
  • Propriedades de lista têm um limite de 100 bytes para a variável inteira. As variáveis de lista têm um limite de 255 bytes por valor e nenhum limite total de bytes.
  • Propriedades de lista não persistem além da ocorrência definida. As variáveis de lista assumem a configuração de expiração que você desejar. Entretanto, usando o processamento de tempo do relatório, é possível aplicar uma atribuição personalizada a propriedades de lista e variáveis de lista.

Nesta página