Plug-in Adobe: addProductEvent

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

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 addProductEvent
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: addProductEvent v1.0 (Requires apl v3.1 and inList v2.0+ plug-ins) */
s.addProductEvent=function(en,ev,ap){var s=this;if("string"===typeof en)if(ev=isNaN(ev)?"1":String(ev),ap=ap||!1,s.events= s.apl(s.events,en),s.products){var e=s.products.split(",");ap=ap?0:e.length-1;for(var a;ap<e.length;ap++)a=e[ap].split(";") ,a[4]&&a[4].includes("event")?a[4]=a[4]+"|"+en+"="+ev:a[5]?a[4]=en+"="+ev:a[4]||(a[3]||(a[3]=""),a[2]||(a[2]=""),a[1]||(a[1]=""),a[4]=en+"="+ev),e[ap]=a.join(";");s.products=e.join(",")}else s.products=";;;;"+en+"="+ev};

/* Adobe Consulting Plugin: apl (appendToList) v3.2 (Requires inList v2.0 or higher) */
s.apl=function(lv,vta,d1,d2,cc){if(!lv||"string"===typeof lv){if("undefined"===typeof this.inList||"string"!==typeof vta||""===vta)return lv;d1=d1||",";d2=d2||d1;1==d2&&(d2=d1,cc||(cc=1));2==d2&&1!=cc&&(d2=d1);vta=vta.split(",");for(var g=vta.length,e=0;e<g;e++)this.inList(lv,vta[e],d1,cc)||(lv=lv?lv+d2+vta[e]:vta[e])}return lv};

/* Adobe Consulting Plugin: inList v2.1 */
s.inList=function(lv,vtc,d,cc){if("string"!==typeof vtc)return!1;if("string"===typeof lv)lv=lv.split(d||",");else if("object"!== typeof lv)return!1;d=0;for(var e=lv.length;d<e;d++)if(1==cc&&vtc===lv[d]||vtc.toLowerCase()===lv[d].toLowerCase())return!0;return!1};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilizzare il plug-in

Il addProductEvent metodo utilizza i seguenti argomenti:

• en (obbligatorio, stringa): L’evento da aggiungere all’ultima voce della products variabile. Se la products variabile è vuota, viene creata una voce di prodotto "vuota" a cui è associato l'evento (e il relativo valore).
• ev (obbligatorio, stringa): Il valore assegnato all'evento numerico o valutario nell' en argomento. Il valore predefinito è 1 se non è impostato.
• 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. Il valore predefinito è false se non è impostato.

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

Cookie

Il plug-in addProductEvent non crea né utilizza cookie

Chiamate di esempio

Esempio n. 1

Il codice seguente imposta la s.products variabile su ";product1;3;300,;product2;2;122,;product3;1;25;event35=25".

s.products=";product1;3;300,;product2;2;122,;product3;1;25"
s.events="purchase";
s.addProductEvent("event35", "25");

Il codice riportato sopra imposta anche la s.events variabile su "purchase,event35"

Esempio n. 2

Il codice seguente imposta la s.products variabile su ";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";
s.addProductEvent("event35", 25, 1);

Quando il terzo argomento della addProductEvent chiamata è true (o 1), ogni voce di prodotto ha l’evento specificato nella chiamata, aggiunto al suo valore.

Esempio n. 3

Il codice seguente imposta la s.products variabile su ";product1;3;300;event2=10;eVar33=large|eVar34=men|eVar35=blue,;product2;2;122,;product3;1;25;event33= 12|event34=10|event35=15"

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

Il codice riportato sopra imposta anche la s.events variabile su "purchase,event2,event33,event34,event35"

Esempio n. 4

Il codice seguente imposta la s.products variabile su ";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"

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

Il codice riportato sopra imposta anche la s.events variabile su "purchase,event2,event33,event34,event35".

Esempio n. 5

Se s.products non è già impostato, il codice seguente lo imposta su ";;;;event35=25"

s.addProductEvent("event35", "25");

Il codice riportato sopra viene aggiunto anche "event35" alla fine di s.events o, se non è già stato impostato, ai set di codici indicatis.events s.events di seguito viene aggiunto "event35"

Cronologia versioni

1.0 (7 ottobre 2019)

• Versione iniziale.