Plug-in Adobe: suite di numeri
La suite Numbers offre una serie di funzioni JavaScript. Include i seguenti plug-in:
zeroPad: aggiungere un numero specifico di zeri all'inizio di un numero. Questo plug-in è utile se una variabile richiede un determinato numero di cifre, ad esempio se si utilizzano oggetti data di JavaScript e si desidera formattare il mese e il giorno di una data con due cifre anziché con una sola cifra. Ad esempio,01/09/2020invece di1/9/2020.randomNumber: genera un numero casuale con un numero specifico di cifre. Questo plug-in è utile se distribuisci tag di terze parti e desideri un numero casuale di cache non funzionante.twoDecimals: Arrotondare un numero al centesimo dell'armadio. Questo plug-in è utile a scopo di valuta, consentendoti di arrotondare un numero a un valore di valuta valido.
Installare il plug-in utilizzando l’estensione Web SDK o Web SDK
Questo plug-in non è ancora supportato per l'utilizzo in Web SDK.
Installare il plug-in utilizzando l’estensione Adobe Analytics
Adobe offre un’estensione che consente di utilizzare i plug-in più comunemente utilizzati con Adobe Analytics.
-
Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
-
Fai clic sulla proprietà del tag desiderata.
-
Vai alla scheda Extensions, quindi fai clic sul pulsante Catalog
-
Installa e pubblica l'estensione Common Analytics Plugins
-
Se non lo hai già fatto, crea una regola denominata "Initialize Plug-ins" (Inizializza plug-in) con la seguente configurazione:
- Condizione: nessuna
- Evento: Core - Library Loaded (Page Top)
-
Aggiungi un’azione alla regola precedente con la seguente configurazione:
- Estensione: Common Analytics Plugins
- Tipo azione: inizializza suite numeri
-
Salva e pubblica le modifiche apportate alla regola.
Installare il plug-in utilizzando l’editor di codice personalizzato
Se non desideri utilizzare l’estensione del plug-in Common Analytics Plugins, puoi utilizzare l’editor di codice personalizzato.
- Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
- Fai clic sulla proprietà desiderata.
- Vai alla scheda Extensions, quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
- Espandere il pannello a soffietto Configure tracking using custom code, che mostra il pulsante Open Editor.
- Apri l’editor di codice personalizzato e incolla il codice del plug-in fornito di seguito nella finestra di modifica.
- Salva e pubblica le modifiche nell’estensione Analytics.
Installare il plug-in utilizzando AppMeasurement
Copiare e incollare il codice seguente in qualsiasi punto del file AppMeasurement dopo la creazione dell'istanza dell'oggetto di tracciamento Analytics (utilizzando s_gi). Mantenere i commenti e i numeri di versione del codice nella tua implementazione aiuta Adobe a risolvere eventuali problemi.
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: zeroPad v1.0 */
function zeroPad(num,nod){num=parseInt(num);nod=parseInt(nod);if(isNaN(num)||isNaN(nod))return"";var c=nod-num.toString().length+ 1;return Array(+(0<c&&c)).join("0")+num};
/* Adobe Consulting Plugin: randomNumber v2.0 (zeroPad plug-in optional)*/
function randomNumber(nod){nod="number"===typeof nod?17>Math.abs(nod)?Math.round(Math.abs(nod)):17:10;for(var a="1",c=0;c<nod;c++) a+="0";a=Number(a);a=Math.floor(Math.random().toFixed(nod)*a)+"";a.length!==nod&&"undefined"!==typeof zeroPad&&(a=zeroPad(a,nod)); return a};
/* Adobe Consulting Plugin: twoDecimals v1.0 */
function twoDecimals(v){return"undefined"===typeof v||void 0===v||isNaN(v)?0:Number(Number(v).toFixed(2))};
/******************************************** END CODE TO DEPLOY ********************************************/
Utilizzare i plug-in
La funzione zeroPad utilizza i seguenti argomenti:
- num (obbligatorio, numero intero): numero da aggiungere. La funzione arrotonda il valore di questo argomento per difetto se contiene decimali.
- nod (obbligatorio, numero intero): numero di cifre nel valore restituito finale. Se il numero da aggiungere ha meno cifre del numero di cifre da aggiungere, il plug-in aggiunge zeri all'inizio dell'argomento
num.
La funzione randomNumber utilizza i seguenti argomenti:
- nod (facoltativo, numero intero): numero di cifre nel numero casuale che si desidera generare. Il valore massimo è di 17 cifre. Il valore predefinito è 10 cifre.
La funzione twoDecimals utilizza i seguenti argomenti:
- val (obbligatorio, numero): numero (rappresentato da una stringa o da un oggetto numero) che si desidera arrotondare al centesimo più vicino.
Restituisce
- La funzione zeroPad restituisce una stringa uguale all'argomento
num, ma con un numero specifico di zeri aggiunti all'inizio del relativo valore, in modo che il valore restituito abbia il numero corretto di cifre. - La funzione randomNumber restituisce una stringa uguale a un numero casuale con il numero di cifre desiderato.
- La funzione twoDecimals restituisce un oggetto numero arrotondato al centesimo più vicino.
Esempio di chiamate
esempi di zeroPad
s.eVar25 = zeroPad(25.5562, 5) //sets eVar25 equal to "00025"
s.prop1 = zeroPad(25, 1) //sets prop1 equal to "25"
s.prop1 = zeroPad(232425235,23) //sets prop1 equal to "00000000000000232425235"
randomNumber, esempi
s.eVar65 = randomNumber(15) //sets eVar65 equal to "721759731750342" or some other random 15-digit number
randomNumber() //returns a random 10-digit number but is useless since this isn't used in an expression
var j = randomNumber(35) //sets a variable named j equal to "15476068651810060" or another random 17-digit number
esempi twoDecimals
s.events = "event10=" + twoDecimals("85.4827128694") //sets s.events="event10=85.48"
var fivehundredthirtytwo = twoDecimals(532.000000001) //sets the variable fivehundredthirtytwo equal to 532
s.eVar65 = twoDecimals("672132.9699736457") //sets s.eVar65 equal to 672132.97
Cronologia versioni
1.0 (25 maggio 2019)
- Versione iniziale.