contextData
Le variabili di dati di contesto ti consentono di definire variabili personalizzate in ogni pagina leggibile dalle regole di elaborazione. Invece di assegnare esplicitamente i valori alle variabili di Analytics nel codice, puoi inviare dati in variabili di dati di contesto. Le regole di elaborazione accettano quindi i valori delle variabili di dati di contesto e li trasmettono alle rispettive variabili di Analytics. Consulta Regole di elaborazione nella Guida utente di amministrazione.
Le variabili di dati contestuali sono utili ai team di sviluppo per raccogliere dati in elementi denominati anziché in variabili numerate. Ad esempio, invece di richiedere ai team di sviluppo di assegnare l'autore della pagina a eVar10, puoi richiedere loro di assegnarlo a s.contextData["author"]. Un amministratore di Analytics della tua organizzazione può quindi creare regole di elaborazione per mappare le variabili di dati di contesto in variabili di Analytics a scopo di reporting. In definitiva, i team di sviluppo si preoccuperebbero solo delle variabili di dati di contesto anziché delle numerose variabili di pagina offerte da Adobe.
Variabili di dati di contesto tramite Web SDK
Se si utilizza l'oggetto XDM, tutti i campi non mappati a una variabile Adobe Analytics vengono inclusi automaticamente come variabile di dati di contesto. Puoi anche impostare esplicitamente i dati contestuali utilizzando l’oggetto XDM. Puoi quindi utilizzare Regole di elaborazione per assegnare la variabile di dati di contesto alla variabile di Analytics desiderata. Per ulteriori informazioni, vedi Mappatura di altri campi XDM su variabili Analytics.
Se si utilizza l'oggetto dati, tutte le variabili di dati di contesto si trovano all'interno di data.__adobe.analytics.contextData come coppie chiave-valore:
alloy("sendEvent", {
"data": {
"__adobe": {
"analytics": {
"contextData": {
"example_variable": "Example value",
"second_example": "Another value"
}
}
}
}
});
L'interfaccia delle regole di elaborazione mostrerebbe c.example_variable e c.second_example nei menu a discesa applicabili.
Variabili di dati di contesto tramite l’estensione Adobe Analytics
La raccolta dati di Adobe Experience Platform non dispone di una posizione dedicata per impostare le variabili di dati di contesto. Utilizza l’editor di codice personalizzato seguendo la sintassi di AppMeasurement.
s.contextData in AppMeasurement e nell’editor di codice personalizzato dell’estensione Analytics
La variabile s.contextData non accetta direttamente un valore. Imposta invece le proprietà di questa variabile su una stringa.
// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";
- Le variabili di dati di contesto valide contengono solo caratteri alfanumerici, trattini bassi e punti. L’Adobe non garantisce la raccolta dei dati nelle regole di elaborazione se includi altri caratteri, ad esempio i trattini.
- Non avviare le variabili di dati di contesto con
"a.". Questo prefisso è riservato e utilizzato da Adobe. Ad esempio, non utilizzares.contextData["a.InstallEvent"]. - Le variabili di dati di contesto non fanno distinzione tra maiuscole e minuscole. Le variabili
s.contextData["example"]es.contextData["EXAMPLE"]sono identiche. - Una singola chiave non può contenere più di un valore. Se si desidera utilizzare variabili di dati di contesto per variabili multivalore, concatenare tutti i valori utilizzando un delimitatore (in genere una virgola) e trasmetterli a una prop elenco o a una variabile elenco utilizzando le regole di elaborazione.
Utilizzare le regole di elaborazione per popolare le variabili di analisi
- Aggiorna l’implementazione per impostare i nomi e i valori delle variabili di dati di contesto.
- Accedi ad Adobe Analytics e vai a Admin > Report suite.
- Seleziona la suite di rapporti desiderata, quindi vai a Edit Settings > General > Processing Rules.
- Crea una regola di elaborazione che imposta una variabile di Analytics sul valore della variabile di dati di contesto.
- Salva le modifiche.
Le regole di elaborazione diventano effettive immediatamente dopo il salvataggio. Non si applicano ai dati storici.
Inviare dati contestuali in una chiamata di tracciamento dei collegamenti
Includere la variabile di dati di contesto come proprietà di contextData in s.linkTrackVars:
s.contextData["example_variable"] = "Example value";
s.linkTrackVars = "contextData.example_variable";
s.tl(true,"o","Example context data link");
Incrementare gli eventi utilizzando le variabili di dati di contesto
Durante la creazione di regole di elaborazione, puoi assegnare variabili di dati di contesto agli eventi.
- Se una variabile di dati di contesto contiene qualsiasi tipo di testo, l’evento viene incrementato di uno.
- Se una variabile di dati di contesto contiene un numero intero, l’evento viene incrementato di tale numero intero.
// 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";