Vorlagen an die Community-Galerie für Vorlagen senden

In der Community-Galerie für Vorlagen in Google Tag Manager können Sie Tag- und Variablenvorlagen erstellen und verwalten, die nativ in Google Tag Manager eingebunden sind. Ihre Organisation kann eine Vorlage erstellen, das Vorlagen-Repository auf GitHub veröffentlichen und die Vorlage dann in der Community-Galerie für Vorlagen einreichen, damit sie Nutzern weltweit zur Verfügung steht. Das hat unter anderem folgende Vorteile für Ihre Organisation:

• Ihre Kunden können Ihre Vorlagen ganz einfach hinzufügen und verwenden.
• Tag Manager-Nutzer sehen die Marke Ihrer Organisation.
• Ihre Kunden können Ihre Tags innerhalb von Minuten und nicht erst nach Monaten bereitstellen.
• Sie können Aktualisierungen für Ihre Vorlagen veröffentlichen und diese Aktualisierungen automatisch für Ihre Kunden verfügbar machen.

So reichen Sie eine neue Vorlage für die Community-Galerie für Vorlagen ein:

1. Vorlage erstellen
2. Projektdateien vorbereiten
3. Dateien auf GitHub hochladen
4. Vorlage einreichen

Vorlage erstellen

Erstellen Sie zuerst eine benutzerdefinierte Vorlage in Google Tag Manager. Achten Sie darauf, dass Ihre Vorlage gründlich getestet wurde, dass die Inhalte Ihrer Vorlage dem Styleguide entsprechen und dass Sie einen Plan oder Prozess dafür haben, wie Sie Ihre Vorlage pflegen und aktualisieren, falls dies in Zukunft erforderlich sein sollte.

Nutzungsbedingungen

Für jede neue Vorlageneinsendung müssen die Nutzungsbedingungen der Community-Galerie für Vorlagen in Google Tag Manager akzeptiert werden. So bestätigen Sie, dass Sie den Nutzungsbedingungen für Ihre Vorlage zustimmen:

1. Lesen Sie die Nutzungsbedingungen der Community-Galerie für Vorlagen in Google Tag Manager.
2. Öffnen Sie im Vorlagen-Editor Ihre Vorlage zum Bearbeiten und setzen Sie auf dem Tab Info ein Häkchen bei Nutzungsbedingungen der Community-Galerie für Vorlagen akzeptieren.

Vorlage exportieren

Wenn die Vorlage fertig ist, exportieren Sie die Vorlagendatei auf Ihren lokalen Computer und benennen Sie die Datei in template.tpl um.

Projektdateien vorbereiten

Im nächsten Schritt bereiten Sie Ihr Repository für die Veröffentlichung auf GitHub vor. Jedes Repository sollte die folgenden Dateien enthalten:

1. Eine exportierte Vorlagendatei mit dem Namen template.tpl. Diese Datei muss aktualisiert werden, um einen categories-Eintrag hinzuzufügen.
2. Eine metadata.yaml-Datei.
3. Eine LICENSE-Datei. Der Dateiname muss in GROSSBUCHSTABEN angegeben werden und der Inhalt der Lizenzdatei muss nur Apache 2.0 sein.
4. Fügen Sie eine README.md-Datei hinzu (optional, aber empfohlen).

Hinweis: Verwenden Sie das Beispiel-Vorlagen-Repository auf GitHub als Vorlage. Kopieren Sie die Datei LICENSE aus der Beispielvorlage in Ihr Projekt, um sicherzugehen, dass keine Fehler im Inhalt vorhanden sind. Aktualisieren Sie außerdem die Copyright-Zeile, in der in der Beispielversion „Copyright [yyyy] [name of copyright owner]“ steht. Ersetzen Sie yyyy durch das Jahr des Urheberrechts und [name of copyright owner] durch den Namen des Urheberrechtsinhabers.

template.tpl Kategorien hinzufügen

Aktualisieren Sie die Datei template.tpl mit einem categories-Eintrag im Abschnitt INFO und geben Sie mindestens einen relevanten Kategoriewert aus der folgenden Tabelle an. Wenn mehr als eine Kategorie infrage kommt, können Sie bis zu drei Kategoriewerte angeben, die von der relevantesten zur am wenigsten relevanten Kategorie sortiert sind.

Hinweis: Werte für den Eintrag categories sollten als Array formatiert werden.

Beispiel:

___INFO___

{
  "displayName": "Example Template",
  "categories": ["AFFILIATE_MARKETING", "ADVERTISING"],
  // additional template properties, etc...
}

Tabelle der unterstützten Kategoriewerte:

Kategorie	Beschreibung
WERBUNG	Werbung
AFFILIATE_MARKETING	Affiliate-Marketing
ANALYTICS	Analytics
LIZENZINFORMATION	Attribution
CHAT	Chat
CONVERSIONS	Conversion-Analyse
DATA_WAREHOUSING	Data-Warehouse-Prozesse
EMAIL_MARKETING	E-Mail-Marketing
TESTS	A/B-Tests und Inhaltsoptimierung
HEAT_MAP	Heat maps
LEAD_GENERATION	Lead-Generierung
MARKETING	Marketing
PERSONALIZATION	Personalisierung
REMARKETING	Remarketing
UMSATZ	Vertrieb und CRM
SESSION_RECORDING	Sitzungsaufzeichnungen
SOCIAL	Sozial
UMFRAGE	Umfragen
TAG_MANAGEMENT	Tag-Management-Systeme
Funktionalität	Google Tag Manager-Dienstprogramme

metadata.yaml

Die Datei metadata.yaml enthält Informationen zu Ihrer Vorlage, einschließlich Links zur Homepage Ihrer Organisation, zur Vorlagendokumentation und zu Versionsinformationen. Jede Version wird durch eine Änderungsnummer gekennzeichnet, auch als SHA-Nummer bezeichnet. Das ist die Änderungsnummer, die dem Git-Commit zugeordnet ist. Das Feld changeNotes ist optional, wird aber empfohlen, um Ihre Nutzer über die Änderungen in der Version zu informieren.

So richten Sie die Datei metadata.yaml ein:

1. Fügen Sie einen Eintrag homepage hinzu. Dies sollte eine URL sein, die auf die Startseite Ihrer Organisation verweist.
2. Fügen Sie einen Eintrag für documentation hinzu. Das sollte eine URL sein, die auf die Dokumentation für Ihre Vorlage verweist.
3. Suchen Sie in GitHub den Commit mit den Änderungen, die Sie für die erste Version Ihrer Vorlage pushen möchten, und kopieren Sie die SHA-Nummer. Eine einfache Möglichkeit, die SHA-Nummer in GitHub abzurufen, besteht darin, eine Commit-Ansicht aufzurufen und auf das Zwischenablage-Symbol () zu klicken. Dadurch wird die gesamte SHA-Nummer in die Zwischenablage kopiert. Fügen Sie diese Zahl als Wert für den Eintrag sha als untergeordnetes Element des Knotens versions ein, wie unten dargestellt.
4. Fügen Sie dem Knoten versions einen changeNotes-Eintrag hinzu, um die Änderungen in dieser neuen Version kurz zu beschreiben.

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

Wichtig:sha und changeNotes müssen wie im obigen Codebeispiel ausgerichtet sein.

Hinweis:Der Wert sha muss auf die spezifische Datei „template.tpl“ verweisen, die Sie veröffentlichen möchten. Vergessen Sie nicht, diesen Wert bei jeder neuen Version richtig zu aktualisieren.

Auf GitHub hochladen

Im nächsten Schritt laden Sie Ihre Dateien auf GitHub hoch. Erstellen Sie ein GitHub-Repository mit den entsprechenden Dateien und der entsprechenden Struktur, wie oben beschrieben.

Vorlagen-Repositories müssen die Dateien template.tpl, metadata.yaml und LICENSE auf der Root-Ebene des Git-Repositorys enthalten. Jedes Git-Repository sollte nur eine template.tpl-Datei haben. Alle Ressourcen müssen sich im Hauptzweig Ihres GitHub-Repositorys befinden. Alle Vorlagen-Repositories, die nicht dieser Struktur entsprechen, werden aus der Galerie entfernt.

Jeder Eintrag in der Community-Galerie für Vorlagen wird mit dem Bereich Issues (Probleme) des GitHub-Repositorys der Vorlage verknüpft. So können Nutzer Sie informieren, wenn sie einen Fehler finden.

Wichtig :Achten Sie darauf, dass Probleme für das GitHub-Repository Ihrer Vorlage nicht deaktiviert sind und dass E‑Mail-Benachrichtigungen aktiviert sind, damit Sie über alle Probleme informiert werden, die während der Überprüfung der Vorlage auftreten.

Vorlage senden

Sobald Ihr Vorlagen-Repository auf GitHub gehostet wird, können Sie Ihre Vorlage in der Community-Galerie für Vorlagen einreichen. So reichen Sie Ihre Vorlage ein:

1. Achten Sie darauf, dass Sie bei GitHub mit einem Konto angemeldet sind, das Zugriff auf das Vorlagen-Repository hat, das Sie der Galerie hinzufügen möchten.
2. Rufen Sie die Community-Galerie für Vorlagen unter tagmanager.google.com/gallery auf.
3. Klicken Sie auf  und wählen Sie Vorlage senden aus.
4. Geben Sie die Repository-URL in das entsprechende Feld ein und klicken Sie auf Senden.

Vorlage aktualisieren

Nachdem Sie eine Vorlage veröffentlicht haben, möchten Sie gelegentlich Updates für Ihre Vorlage bereitstellen. Nutzer Ihrer Vorlage werden benachrichtigt, wenn es ein Update für die Vorlage gibt, und haben die Möglichkeit, die Vorlage auf die neueste Version zu aktualisieren.

Anhand der Datei metadata.yaml wird ermittelt, welche Version Ihrer Vorlage in der Galerie verwendet werden soll. Wenn Sie neue Versionen veröffentlichen möchten, müssen Sie die Änderungsnummer (SHA-Nummer) in den Abschnitt versions Ihrer metadata.yaml-Datei einfügen.

1. Suchen Sie den Commit mit den Änderungen, die Sie pushen möchten, und kopieren Sie die SHA-Nummer. In GitHub können Sie dazu einfach eine Commit-Ansicht aufrufen und auf das Zwischenablagesymbol () klicken. Dadurch wird die gesamte SHA-Nummer in die Zwischenablage kopiert.
2. Fügen Sie oben in der Liste versions in metadata.yaml einen neuen sha-Eintrag hinzu. (Siehe Beispiel unten.)
3. Fügen Sie changeNotes hinzu, um die Änderungen in dieser neuen Version kurz zu beschreiben. Bei Bedarf können Sie mehrzeilige Kommentare erstellen. (Siehe Beispiel unten.)
4. Übernehmen Sie die Änderung für metadata.yaml. Ihre Aktualisierung wird in der Regel innerhalb von zwei bis drei Tagen in der Galerie angezeigt.

In diesem Beispiel wird gezeigt, wie Sie neue Versionsinformationen einschließlich der SHA-Nummer und der Versionshinweise hinzufügen:

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  # Latest version
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874c
    changeNotes: |2
      Fix bug with the whatsamajig.
      Improve menu options.
      Update API calls.
  # Older versions
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874b
    changeNotes: Adds eject button.
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

Wichtig:Jede veröffentlichte Version der Vorlage muss im Abschnitt versions in umgekehrt chronologischer Reihenfolge (neueste bis älteste) enthalten sein.

Hinweis:Nicht jeder inkrementelle Commit muss als Versionsänderung in die Galerie für Community-Vorlagen aufgenommen werden. Wenn Sie beispielsweise in den Commits 1, 2 und 3 inkrementelle Änderungen vornehmen und die endgültige Version Commit 4 ist, sollten Sie nur einen Eintrag für Commit 4 haben, der alle Änderungen aus den Commits 1, 2 und 3 enthält.

Repository verschieben

Wenn Sie Inhaber oder Repository-Namen ändern möchten, können Sie das GitHub-Verfahren zur Übertragung von Repositorys verwenden. Der neue Speicherort wird erkannt und Nutzer werden beim nächsten Aktualisieren der Vorlage automatisch zum neuen Repository weitergeleitet.

Vorlage entfernen

Wenn Sie eine Vorlage aus der Galerie entfernen möchten, löschen Sie entweder die Datei LICENSE oder die Datei metadata.yaml aus dem zugehörigen Repository. Das System zur Überwachung der Galerie erkennt diese Änderung und entfernt die Vorlage automatisch.