Creare una variabile personalizzata

Questa guida illustra come creare un modello di variabile personalizzata. Se utilizzata, questa variabile accetta un array di valori e li restituisce come stringa delimitata da virgole.

1. Per iniziare a creare il primo modello di variabili, fai clic su Modelli nel riquadro di navigazione a sinistra e fai clic sul pulsante Nuovo nella sezione Modelli di variabile.

2. Nella scheda Informazioni, definisci il Nome e la Descrizione della variabile.

   Il nome viene mostrato agli utenti quando intendono implementare questa variabile nell'interfaccia utente di Tag Manager.

   La descrizione è la descrizione riportata di seguito, ovvero una breve (massimo 200 caratteri) della funzione di questa variabile.

3. Fai clic su Aggiorna per visualizzare l'anteprima del modello.

   A destra dei campi del campo, è presente una finestra Anteprima modello. Ogni volta che viene apportata una modifica nell'editor, viene visualizzato il pulsante Aggiorna. Fai clic su Aggiorna per vedere come vengono apportate le modifiche all'aspetto della variabile.

4. Fai clic su Campi per aggiungere campi al modello di variabile.

   La scheda Campi dell'editor dei modelli consente di creare e modificare i campi nel modello di variabile. I campi vengono utilizzati per inserire dati personalizzati, ad esempio un ID account. Puoi aggiungere elementi standard del modulo, come campi di testo, menu a discesa, pulsanti di opzione e caselle di controllo.

5. Fai clic su Aggiungi campo e seleziona Tabella semplice. Sostituisci il nome predefinito (ad es. "simpleTable1") con "list". In Anteprima modello, fai clic su Aggiorna.

   Ripeti questo passaggio per un input di testo e chiamalo "matrice", due caselle di controllo chiamate "usa_matrice" e "ordina" e un input di testo chiamato "delimitatore". Per "delimitatore", assegna un valore predefinito di "," facendo clic sull'icona a forma di ingranaggio, attivando l'opzione "Valore predefinito", quindi compilando il nuovo campo di immissione Valore predefinito.

6. Fai clic sulla scheda Codice e inserisci JavaScript con sandbox nell'editor:

   var input = data.array;
   
   if (!data.use_array) {
     input = [];
     for (var i = 0; i < data.list.length; i++) {
       input.push(data.list[i].values);
     }
   }
   
   if (data.sort) {
     input.sort();
   }
   
   return input.join(data.delimiter || ',');
   

   Il codice per questa variabile è abbastanza semplice, ma ci sono alcuni aspetti che vale la pena sottolineare.

   • data campi.

     Ci sono alcuni campi a cui si accede al di fuori della data globale. data conterrà i valori che hai impostato nel passaggio precedente. Ecco perché possiamo accedere a data.use_array, data.sort, data.list e data.delimiter.

   • delimiter è impostato su un valore predefinito di "," se data.delimiter non viene fornito. È buona norma impostare i valori predefiniti di un campo, se necessario. In questo modo, per gli utenti è più semplice utilizzare il modello di variabile poiché non è necessario compilare ogni campo per poter utilizzare la variabile.

7. Fai clic su Salva per salvare i tuoi progressi. In questo modo, tutte le autorizzazioni rilevate verranno caricate nell'Editor modelli.

   Ad alcune API modello sono associate autorizzazioni che stabiliscono cosa può o non può fare. Quando utilizzi un'API modello come sendPixel nel codice, Tag Manager mostrerà le autorizzazioni pertinenti nella scheda Autorizzazioni.

8. Nella scheda Anteprima modello, aggiungi alcuni valori per l'input "valori", fai clic su Esegui codice e osserva la console per vedere l'output della variabile.

   Eventuali errori verranno visualizzati nella finestra Console.

9. Fai clic su Salva e chiudi l'Editor modelli.

   Il modello di variabile dovrebbe essere pronto per essere utilizzato.