As variáveis de dados de contexto permitem definir variáveis personalizadas em cada página que podem ser lidas pelas regras de processamento. Em vez de atribuir valores explicitamente às variáveis do Analytics em seu código, você pode enviar dados em variáveis de dados de contexto. As regras de processamento então capturam os valores das variáveis de dados de contexto e os transmitem às respectivas variáveis do Analytics. Consulte Regras de processamento no Guia do usuário de administração.
As variáveis de dados de contexto são úteis para as equipes de desenvolvimento coletarem dados em elementos nomeados em vez de coletar nas variáveis numeradas. Por exemplo, em vez de solicitar que as equipes de desenvolvimento atribuam o autor da página a eVar10
, você pode solicitar que elas o atribuam a s.contextData["author"]
. Um administrador do Analytics em sua organização pode criar regras de processamento para mapear variáveis de dados de contexto como variáveis do Analytics para relatórios. No fim, as equipes de desenvolvimento só se preocupariam com as variáveis de dados de contexto em vez das muitas variáveis de página oferecidas pela Adobe.
Se um campo XDM não estiver mapeado para o Adobe Analytics, ele é incluído automaticamente como uma variável de dados de contexto. Em seguida, você pode usar Regras de processamento para atribuir a variável de dados de contexto à variável do Analytics desejada.
Embora seja uma prática recomendada mapear dados para os campos XDM corretos no Fluxo de dados, esse método obtém resultados semelhantes.
A Coleção de dados da Adobe Experience Platform não tem um local dedicado para definir variáveis de dados de contexto. Use o editor de código personalizado após a sintaxe do AppMeasurement.
A variável s.contextData
não assume um valor diretamente. Em vez disso, defina as propriedades dessa variável como uma string.
// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";
"a."
. Este prefixo está reservado e é usado pela Adobe. Por exemplo, não use s.contextData["a.InstallEvent"]
.s.contextData["example"]
e s.contextData["EXAMPLE"]
são idênticas.As variáveis de dados de contexto são descartadas após a execução das regras de processamento. Se você não tiver ativadas regras de processamento que colocam valores em variáveis, esses dados serão perdidos permanentemente!
As regras de processamento entram em vigor imediatamente após serem salvas. Elas não se aplicam aos dados históricos.
Inclua a variável de dados de contexto como uma propriedade de contextData
em s.linkTrackVars
:
s.contextData["example_variable"] = "Example value";
s.linkTrackVars = "contextData.example_variable";
s.tl(true,"o","Example context data link");
Ao criar regras de processamento, você pode atribuir variáveis de dados de contexto a eventos.
// Assigning this context data variable to an event increments it by one
s.contextData["example_text"] = "Text value";
// Assigning this context data variable to an event increments it by four
s.contextData["example_number"] = "4";