Esta página de ajuda descreve como implementar props. Para obter informações sobre como as props funcionam como uma dimensão, consulte prop no guia Usuário de componentes.
As props são variáveis personalizadas que podem ser usadas da maneira que você desejar. Elas não persistem além da ocorrência definida.
A Adobe recomenda usar eVars na maioria dos casos. Em versões anteriores do Adobe Analytics, props e eVars tinham vantagens e desvantagens entre si. No entanto, o Adobe melhorou as eVars a ponto de agora atender a quase todos os casos de uso de props.
Se você tiver um documento de design de solução, será possível alocar essas dimensões personalizadas para valores específicos da sua organização. O número de props disponíveis depende de seu contrato com a Adobe. Até 75 props estarão disponíveis se seu contrato com a Adobe permitir.
As props são mapeadas para o Adobe Analytics nos campos XDM _experience.analytics.customDimensions.props.prop1
a _experience.analytics.customDimensions.props.prop75
. Propriedades de lista são especificadas em um conjunto separado de campos.
Você pode definir props ao configurar a extensão do Analytics (variáveis globais) ou em Regras.
Você pode definir uma prop a um valor ou um elemento de dados. Também é possível copiar o valor de outra variável do Analytics.
Cada variável de prop é uma string que contém valores personalizados específicos para sua organização. O comprimento máximo delas é de 100 bytes; valores com mais de 100 bytes são truncados automaticamente quando enviados para a Adobe.
s.prop1 = "Example custom value";
Props de lista são uma configuração aplicada a props que permitem que a variável armazene muitos valores na mesma ocorrência. Se essa configuração não estiver ativada ou se o delimitador errado for usado, a variável será tratada como um valor único.
Ativar propriedade de lista em Variáveis de tráfego em configurações do conjunto de relatórios. Verifique se o delimitador desejado está configurado corretamente. A Adobe não fornece um delimitador padrão.
Os delimitadores comuns usados em implementações são vírgula (,
), dois pontos (:
), ponto e vírgula (;
) ou barra vertical (|
). Você pode usar qualquer delimitador ASCII não estendido que melhor se ajuste à sua implementação.
Depois de configurar as propriedades de lista nas configurações do conjunto de relatórios com o delimitador desejado, as propriedades de lista são mapeadas para o Adobe Analytics em _experience.analytics.customDimensions.listProps.prop1.values[]
para _experience.analytics.customDimensions.listProps.prop75.values[]
. O SDK da Web usa automaticamente o delimitador correto listado nas configurações do conjunto de relatórios. Se você definir o delimitador no campo XDM (por exemplo, _experience.analytics.customDimensions.props.prop1.delimiter
), que substitui o delimitador recuperado automaticamente das configurações do conjunto de relatórios e pode levar à análise incorreta da string de propriedade da lista.
Depois de configurar as props de lista nas configurações do conjunto de relatórios com o delimitador desejado, não há diferenças de implementação além do uso do delimitador.
// List prop delimited with a comma
s.prop1 = "value1,value2,value3";
Propriedades de lista ainda estão sujeitas ao tamanho máximo de 100 bytes. Propriedades de lista atingem mais facilmente esse limite e ficam truncados, pois podem conter vários valores. Considere o uso de abreviações ou a redução de valores for possível atingir o limite de 100 bytes.
Se você definir o mesmo valor mais de uma vez em uma prop de lista, eles serão deduplicados no relatórios. O Analysis Workspace conta o número de ocorrências em que um valor é visto, e não o número de vezes em que um valor existe nos dados.