Benutzerdefinierte Variable erstellen

In diesem Leitfaden erfahren Sie, wie Sie eine Vorlage für benutzerdefinierte Variablen erstellen. Wenn diese Variable verwendet wird, nimmt sie ein Array von Werten und gibt sie als kommagetrennte Zeichenfolge zurück.

1. Um mit der Erstellung Ihrer ersten Variablenvorlage zu beginnen, klicken Sie im linken Navigationsbereich auf „Vorlagen“ und dann unter dem Bereich Variablenvorlagen auf Neu.

2. Definieren Sie auf dem Tab Info den Namen und die Beschreibung der Variablen.

   Der Name wird Nutzern angezeigt, wenn sie diese Variable auf der Benutzeroberfläche von Tag Manager implementieren.

   Beschreibung entspricht einfach einer Beschreibung (200 Zeichen oder weniger).

3. Klicken Sie auf Aktualisieren, um die Vorlage in der Vorschau anzusehen.

   Rechts neben den Feldeingaben befindet sich das Fenster Vorlagenvorschau. Jedes Mal, wenn Sie im Editor eine Änderung vornehmen, wird die Schaltfläche Aktualisieren eingeblendet. Klicken Sie auf „Aktualisieren“, um zu sehen, wie sich die Änderungen auf die Darstellung der Variablen auswirken.

4. Klicken Sie auf Felder, um der Variablenvorlage Felder hinzuzufügen.

   Auf dem Tab Felder des Vorlageneditors können Sie Felder in der Variablenvorlage erstellen und bearbeiten. Felder werden verwendet, um benutzerdefinierte Daten einzugeben, z. B. eine Konto-ID. Sie können Standardformularelemente wie Textfelder, Drop-down-Menüs, Optionsfelder und Kästchen hinzufügen.

5. Klicken Sie auf Feld hinzufügen und wählen Sie Einfache Tabelle aus. Ersetzen Sie den Standardnamen (z.B. "simpleTable1") durch "list". Klicken Sie in der Vorlagenvorschau auf Aktualisieren.

   Wiederholen Sie diesen Schritt für eine Texteingabe und nennen Sie sie "Array", zwei Kästchen mit den Namen use_array und "sort" sowie eine Texteingabe mit dem Namen "Trennzeichen". Legen Sie für „Trennzeichen“ den Standardwert „,“ fest. Klicken Sie dazu auf das Zahnradsymbol, setzen Sie Standardwert auf „Ein“ und füllen Sie das neue Eingabefeld „Standardwert“ aus.

6. Klicken Sie auf den Tab Code und geben Sie in den Editor JavaScript in die Sandbox ein:

   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 || ',');
   

   Der Code für diese Variable ist recht einfach, aber es gibt einige Dinge, die es zu beachten gilt.

   • data-Felder.

     Es gibt einige Felder, die außerhalb von data weltweit aufgerufen werden. data enthält die Werte, die Sie im vorherigen Schritt eingerichtet haben. Deshalb können wir auf data.use_array, data.sort, data.list und data.delimiter zugreifen.

   • delimiter ist auf den Standardwert "," gesetzt, wenn data.delimiter nicht angegeben ist. Es empfiehlt sich, Standardwerte für ein Feld festzulegen, wenn es sinnvoll ist. So können Nutzer die Variablenvorlage einfacher verwenden, da sie nicht jedes Feld ausfüllen müssen, um die Variable zu verwenden.

7. Klicken Sie auf Speichern, um Ihren Fortschritt zu speichern. Dadurch werden alle erkannten Berechtigungen in den Vorlageneditor geladen.

   Einigen Vorlagen-APIs sind Berechtigungen zugeordnet, die festlegen, welche Aktionen sie ausführen dürfen. Wenn Sie eine Vorlagen-API wie sendPixel in Ihrem Code verwenden, werden in Tag Manager auf dem Tab Berechtigungen entsprechende Berechtigungen angezeigt.

8. Fügen Sie auf dem Tab Vorlagenvorschau einige Werte für die Eingabe "values" hinzu, klicken Sie auf Code ausführen und sehen Sie sich die Console an, um die Ausgabe für Ihre Variable zu sehen.

   Falls Fehler auftreten, werden sie im Fenster Console angezeigt.

9. Klicken Sie auf Speichern und schließen Sie den Vorlageneditor.

   Die Variablenvorlage sollte jetzt einsatzbereit sein.