Contesto utente

L’API JavaScript per il contesto utente espone i dati a livello di utente e visitatore in più sessioni per abilitare la funzionalità di personalizzazione avanzata utilizzando dati e comportamenti storici degli utenti. L’API non si limita alla lettura dei dati, ma espone variabili personalizzate che consentono di inviare dati ed eventi significativi al backend RTP per scopi avanzati di segmentazione e personalizzazione. Funzionalità aggiuntive: Triggers, Corrispondenza pattern.

  • Prima di utilizzare l'API Contesto utente, è necessario diventare un cliente di Web Personalization e disporre del tag RTP distribuito sul sito.
  • L’API Contesto utente è una funzione che deve essere abilitata dal supporto Marketo su richiesta. Quando l’API è abilitata, viene esposto un oggetto userContext sotto l’oggetto globale RTP.

Attributi contesto utente

Nome
Tipo
Descrizione
customVar[1-5]
Stringa
Dati personalizzati salvati nel contesto utente.
viewedCampaigns
ID campagna come stringa separata da virgole
Campagne visualizzate nelle visite correnti o precedenti.
clickedCampaigns
ID campagna come stringa separata da virgole
Campagne selezionate nelle visite correnti o precedenti.

Imposta variabili personalizzate

Aggiunta di dati personalizzati a Contesto utente.

Utilizzo

rtp('set', 'customVar'[1-5], my_custom_value);

Parametro
Facoltativo/Obbligatorio
Tipo
Descrizione
'set'
Obbligatorio
Stringa
Azione del metodo.
customVar
Obbligatorio
Stringa
Nome della variabile personalizzata.
my_custom_value
Obbligatorio
Stringa
Valore personalizzato da salvare sulla variabile personalizzata nell’indice 1-5.

Nota: le variabili personalizzate vengono inviate all’RTP solo nella chiamata di visualizzazione, pertanto si consiglia di impostarle prima di chiamare la visualizzazione. In caso contrario, verrà inviato solo nella successiva chiamata di visualizzazione.

Restrizioni variabili personalizzate

  • La lunghezza della variabile personalizzata non può superare i 100 caratteri.
  • I dati della campagna sono limitati alle ultime dieci visite con dieci campagne per visita.

Utilizzo

rtp('set', 'customVar', 'A');

// Set and get customVars
rtp('set', 'customVar1', 'foo');

// Read location
if (rtp.userContext.location.state == 'CA')  {
    // Do something
}

// Check if user viewed campaign id 45:
// The campaign id is exposed in the RTP UI when hovering over a campaign name.
if (rtp.userContext.viewedCampaign('45')) {
    // Do something
}
recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59