Plug-in Adobe: getAndPersistValue

Il getAndPersistValue plug-in consente di memorizzare un valore in un cookie che sarà possibile recuperare in seguito durante una visita. Assegna un ruolo simile alla Storage duration funzione in lancio Adobe Experience Platform. Adobe consiglia di utilizzare questo plug-in se desiderate mantenere automaticamente una variabile Analytics allo stesso valore negli hit successivi dopo l’impostazione della variabile. Questo plug-in non è necessario se la funzione di Launch Storage duration è sufficiente o se non è necessario impostare e mantenere le variabili sullo stesso valore negli hit successivi. La persistenza incorporata delle eVar non richiede l'utilizzo di questo plug-in, in quanto queste variabili persistono sul lato server da parte di Adobe.

Installare il plug-in utilizzando l'estensione Lancio del Adobe Experience Platform

Adobe offre un’estensione che consente di utilizzare la maggior parte dei plug-in usati comunemente.

1. Accedete a launch.adobe.com utilizzando le credenziali AdobeID.
2. Fate clic sulla proprietà desiderata.
3. Vai alla Extensions scheda, quindi fai clic sul Catalog pulsante
4. Installare e pubblicare l’ Common Analytics Plugins estensione
5. Se non lo avete già fatto, create una regola con l'etichetta "Inizializza plug-in" con la seguente configurazione:
   • Condizione: nessuna
   • Evento: Core - Libreria caricata (Page Top)
6. Aggiungete un'azione alla regola precedente con la seguente configurazione:
   • Estensione: Plug-in Analytics comuni
   • Tipo azione: Initialize getAndPersistValue
7. Salvate e pubblicate le modifiche alla regola.

Installare il plug-in utilizzando l'editor di codice personalizzato Launch

Se non desiderate utilizzare l'estensione del plug-in, potete utilizzare l'editor di codice personalizzato.

1. Accedete a launch.adobe.com utilizzando le credenziali AdobeID.
2. Fate clic sulla proprietà desiderata.
3. Vai alla Extensions scheda, quindi fai clic sul Configure pulsante sotto l'estensione Adobe Analytics.
4. Espandere la struttura Configure tracking using custom code a soffietto, che mostra il Open Editor pulsante.
5. Aprite l’editor di codice personalizzato e incollate il codice plug-in fornito di seguito nella finestra di modifica.
6. Salvate e pubblicate le modifiche nell’estensione Analytics .

Installare il plug-in utilizzando AppMeasurement

Copiate e incollate il seguente codice in qualsiasi punto del file AppMeasurement dopo che è stata creata un'istanza dell'oggetto di tracciamento Analytics (utilizzando s_gi). La conservazione di commenti e numeri di versione del codice nell’implementazione consente ad Adobe di risolvere eventuali problemi.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getAndPersistValue v2.0 */
s.getAndPersistValue=function(vtp,cn,ex){var b=new Date;cn=cn?cn:"s_gapv";(ex=ex?ex:0)?b.setTime(b.getTime()+864E5*ex): b.setTime(b.getTime()+18E5);vtp||(vtp=this.c_r(cn));this.c_w(cn,vtp,b);return vtp};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilizzare il plug-in

Il getAndPersist metodo utilizza i seguenti argomenti:

• vtp (obbligatorio): Il valore da mantenere da una pagina all’altra
• cn (facoltativo): Nome del cookie in cui memorizzare il valore. Se questo argomento non è impostato, il cookie viene denominato "s_gapv"
• ex (facoltativo): Il numero di giorni prima della scadenza del cookie. Se questo argomento è 0 o non è impostato, il cookie scade alla fine della visita (30 minuti di inattività).

Se la variabile nell' vtp argomento è impostata, il plug-in imposta il cookie e quindi restituisce il valore del cookie. Se la variabile nell' vtp argomento non è impostata, il plug-in restituisce solo il valore del cookie.

Esempi

Esempio n. 1

Il codice seguente imposta eVar21 uguale al valore "hello". Il codice imposta quindi il cookie ev21gapv, che scade tra 28 giorni, pari al valore di eVar21 (ovvero "hello"). Il codice imposta quindi (ri)eVar21 come valore del cookie ev21gapv.

s.eVar21 = "hello";
s.eVar21 = s.getAndPersistValue(s.eVar21,"ev21gapv",28);

Esempio n. 2

Si supponga che eVar21 non sia ancora stato impostato sulla pagina corrente ma sia stato impostato come "hello" in una pagina precedente negli ultimi 28 giorni. Il codice seguente imposta eVar21 solo uguale al valore del cookie ev21gapv (ovvero "hello"). Non reimposta il cookie ev21gapv perché eVar21 non è stato impostato sulla pagina corrente prima della chiamata della funzione.

s.eVar21 = s.getAndPersistValue(s.eVar21,"ev21gapv",28);

Esempio n. 3

Si supponga che eVar21 non sia ancora stato impostato sulla pagina corrente ma sia stato impostato come "hello" in una pagina precedente negli ultimi 28 giorni. Il codice seguente imposta solo prop35 uguale al valore del cookie ev21gapv (es. "hello"). Non imposta eVar21.

s.prop35 = s.getAndPersistValue(s.eVar21,"ev21gapv",28);

Esempio n. 4

Il codice seguente imposta eVar21 come valore "howdy". Il codice imposta (o reimposta) il cookie ev21gapv, che scade tra 28 giorni, pari al valore di eVar21 (cioè "howdy"). Il codice imposta quindi prop35 uguale al valore del cookie ev21gapv (es. "howdy").

s.eVar21 = "howdy";
s.prop35 = s.getAndPersistValue(s.eVar21,"ev21gapv",28);

Esempio n. 5

Si supponga che s.eVar21 non sia stato impostato su alcuna pagina negli ultimi 28 giorni. Il codice seguente imposta s.eVar21 uguale a zero, poiché il cookie ev21gapv sarebbe scaduto 28 giorni dopo l’ultima impostazione.

s.eVar21 = s.getAndPersistValue(s.eVar21,"ev21gapv",28);

Esempio n. 6

Il codice seguente imposta eVar30 su "shopping". Quindi imposta il cookie s_gapv, che scade alla fine della sessione del browser, pari al valore di s.eVar30 (ovvero "shopping"). Quindi, imposta s.eVar30 uguale al valore del cookie s_gapv (ovvero, la chiamata getAndPersistValue restituisce il valore del cookie s_gapv, che in questo caso è "shopping").

s.eVar30 = "shopping";
s.eVar30 = s.getAndPersistValue(s.eVar30);

Se s.eVar30 non è impostato su un valore esplicito su alcuna pagina aggiuntiva visualizzata durante la sessione, ma è impostato (in doPlugins) tramite il seguente codice…

s.eVar30 = s.getAndPersistValue(s.eVar30);

…s.eVar30 verrà impostato su "shopping" (ovvero il valore persistente del cookie s_gapv)

Cronologia versioni

2.0 (16 aprile 2018)

• Rilascio punto (dimensioni del codice più piccole)
• Se si passa 0 all' ex argomento ora la scadenza viene forzata dopo 30 minuti di inattività anziché alla scadenza alla fine della sessione del browser.

1.0 (18 gennaio 2016)

• Versione iniziale.