Plug-in di Adobe: addProductEvent

Il plug-in addProductEvent aggiunge un evento numerico o valutario alla variabile products . Adobe consiglia di utilizzare questo plug-in se si desidera aggiungere un evento numerico o valutario alla variabile products senza preoccuparsi del formato della stringa di prodotto. Questo plug-in non è necessario se non utilizzi eventi numerici o valutari nella variabile products .

Installare il plug-in utilizzando i tag in Adobe Experience Platform

Adobe offre un’estensione che consente di utilizzare i plug-in più comunemente utilizzati.

1. Accedi all' Interfaccia di raccolta dati utilizzando le tue credenziali AdobeID.
2. Fai clic sulla proprietà desiderata.
3. Vai alla scheda Extensions, quindi fai clic sul pulsante Catalog
4. Installa e pubblica l'estensione Common Analytics Plugins
5. Se non lo hai già fatto, crea una regola denominata "Inizializza plug-in" con la seguente configurazione:
   • Condizione: nessuna
   • Evento: Core - Libreria caricata (pagina in alto)
6. Aggiungi un'azione alla regola precedente con la seguente configurazione:
   • Estensione: Plug-in comuni di Analytics
   • Tipo azione: Inizializza addProductEvent
7. Salva e pubblica le modifiche alla regola.

Installare il plug-in utilizzando l’editor di codice personalizzato

Se non desideri utilizzare l'estensione plug-in, puoi utilizzare l'editor di codice personalizzato.

1. Accedi all' Interfaccia di raccolta dati utilizzando le tue credenziali AdobeID.
2. Fai clic sulla proprietà desiderata.
3. Vai alla scheda Extensions , quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
4. Espandi il Configure tracking using custom code pannello a soffietto, che mostra il pulsante Open Editor .
5. Apri l’editor di codice personalizzato e incolla il codice plug-in fornito di seguito nella finestra di modifica.
6. Salva e pubblica le modifiche all’estensione Analytics.

Installare il plug-in utilizzando AppMeasurement

Copia e incolla il seguente codice in qualsiasi punto del file AppMeasurement dopo la creazione dell'istanza dell'oggetto di tracciamento Analytics (utilizzando s_gi). La conservazione dei commenti e dei numeri di versione del codice nell’implementazione consente ad Adobe di risolvere eventuali problemi.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: addProductEvent v2.0 */
function addProductEvent(en,ev,ap){var f=en,g=ev,c=ap;if("-v"===f)return{plugin:"addProductEvent",version:"2.0"};var d=function(){if("undefined"!==typeof window.s_c_il)for(var b=0,e;b<window.s_c_il.length;b++)if(e=window.s_c_il[b],e._c&&"s_c"===e._c)return e}();if("undefined"!==typeof d&&(d.contextData.addProductEvent="2.0",window.apl=window.apl||function(b,e,c,d,f){function g(b,d,c,e){if("string"!==typeof d)return!1;if("string"===typeof b)b=b.split(c||",");else if("object"!==typeof b)return!1;c=0;for(a=b.length;c<a;c++)if(1==e&&d===b[c]||d.toLowerCase()===b[c].toLowerCase())return!0;return!1}if(!b||"string"===typeof b){if("string"!==typeof e||""===e)return b;c=c||",";d=d||c;1==d&&(d=c,f||(f=1));2==d&&1!=f&&(d=c);e=e.split(",");k=e.length;for(var h=0;h<k;h++)g(b,e[h],c,f)||(b=b?b+d+e[h]:e[h])}return b},"string"===typeof f))if(g=isNaN(g)?"1":String(g),c=c||!1,d.events=window.apl(d.events,f),d.products){var l=d.products.split(","),m=l.length;c=c?0:m-1;for(var b;c<m;c++)b=l[c].split(";"),b[4]&&-1<b[4].indexOf("event")?b[4]=b[4]+"|"+f+"="+g:b[5]?b[4]=f+"="+g:b[4]||(b[3]||(b[3]=""),b[2]||(b[2]=""),b[1]||(b[1]=""),b[4]=f+"="+g),l[c]=b.join(";");d.products=l.join(",")}else d.products=";;;;"+f+"="+g};
/******************************************** END CODE TO DEPLOY ********************************************/

Usa il plug-in

La funzione addProductEvent utilizza i seguenti argomenti:

• en (obbligatorio, stringa): L’evento da aggiungere all’ultima voce della products variabile. Se la variabile products è vuota, viene creata una voce di prodotto "vuota" con l’evento (e il relativo valore) associato.
• ev (obbligatorio, stringa): Valore assegnato all'evento numerico o di valuta nell' en argomento. Se non è impostato, viene impostato il valore predefinito 1. Sono validi anche i numeri non racchiusi tra virgolette stringa.
• ap (facoltativo, booleano): Se la variabile "products" contiene attualmente più di una voce di prodotto, il valore true (o 1) aggiunge l’evento a tutte le voci di prodotto. Se non è impostato, viene impostato il valore predefinito false.

addProductEvent non restituisce nulla. Al contrario, aggiunge l'evento e il relativo valore alla variabile products . Il plug-in aggiunge automaticamente anche l'evento alla variabile events , poiché è necessario anche in questo caso.

Cookie

La funzione addProductEvent non crea né utilizza cookie.

Esempi

// Sets the products variable to ";product1;3;300,;product2;2;122,;product3;1;25;event35=25".
// Also sets the events variable to "purchase,event35".
s.products = ";product1;3;300,;product2;2;122,;product3;1;25";
s.events = "purchase";
addProductEvent("event35", "25");

// Sets the products variable to ";product1;3;300;event35=25,;product2;2;122;event35=25,;product3;1;25;event35=25".
s.products = ";product1;3;300,;product2;2;122,;product3;1;25";
addProductEvent("event35", 25, true);

// Sets the products variable to ";product1;3;300;event2=10;eVar33=large|eVar34=men|eVar35=blue,;product2;2;122,;product3;1;25;event33= 12|event34=10|event35=15"
// Also sets the s.events variable to "purchase,event2,event33,event34,event35".
s.products=";product1;3;300;event2=10;eVar33=large|eVar34=men|eVar35=blue,;product2;2;122,;product3;1;25";
s.events="purchase,event2";
addProductEvent("event33", "12");
addProductEvent("event34", "10");
addProductEvent("event35", "15");

// Sets the products variable to ";product1;3;300;event2=10|event33=12|event34=10|event35=15;eVar33=large|eVar34=men|eVar35=blue,;product2;2;122;event33=12|event34=10|event35=15,;product3;1;25;event33=12|event34=10|event35=15".
// Also sets the events variable to "purchase,event2,event33,event34,event35".
s.products=";product1;3;300;event2=10;eVar33=large|eVar34=men|eVar35=blue,;product2;2;122,;product3;1;25"
s.events="purchase,event2"
addProductEvent("event33", "12", 1);
addProductEvent("event34", 10, 1);
addProductEvent("event35", "15", 1);

// If the products variable isn't already set, sets it to ";;;;event35=25".
// Also appends event35 to the events variable.
addProductEvent("event35", "25");

Cronologia versioni

2.0 (19 marzo 2021)

• È stato aggiunto il numero di versione come dati contestuali.

1.0 (7 ottobre 2019)

• Versione iniziale.