Vorlagen an die Community-Galerie für Vorlagen senden

In der Google Tag Manager-Galerie für Community-Vorlagen 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-Vorlagengalerie einreichen, um sie Nutzern weltweit zur Verfügung zu stellen. Die 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 weniger Minuten statt in mehreren Monaten implementieren.
  • Sie können Änderungen an Ihren Vorlagen veröffentlichen und diese Änderungen automatisch für Ihre Kunden verfügbar machen.

Das Einreichen einer neuen Vorlage in der Community-Galerie für Vorlagen umfasst die folgenden Hauptschritte:

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

Vorlage erstellen

Erstellen Sie zuerst die Vorlage in Google Tag Manager als benutzerdefinierte Vorlage. Achten Sie darauf, dass Ihre Vorlage gründlich getestet wurde, dass der Inhalt der Vorlage dem Styleguide entspricht und dass Sie einen Plan oder Prozess für die Pflege und Aktualisierung der Vorlage haben, falls dies in Zukunft erforderlich sein sollte.

Nutzungsbedingungen

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

  1. Lesen Sie die Nutzungsbedingungen der Community-Galerie für Vorlagen in Google Tag Manager.
  2. Öffnen Sie die Vorlage im Vorlageneditor und klicken Sie auf dem Tab Info auf das Kästchen 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 sie 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 geschrieben sein und der Inhalt der Lizenzdatei darf nur die Apache 2.0-Lizenz enthalten.
  4. Fügen Sie eine README.md-Datei hinzu (optional, aber empfohlen).

template.tpl Kategorien hinzufügen

Fügen Sie der Datei template.tpl im Abschnitt INFO einen Eintrag vom Typ categories hinzu und geben Sie mindestens einen relevanten Kategoriewert aus der folgenden Tabelle an. Wenn mehrere Kategorien infrage kommen, können Sie bis zu drei Kategoriewerte angeben, sortiert nach Relevanz.

Beispiel:

___INFO___

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

Tabelle mit unterstützten Kategoriewerten:

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
PERSONALISIERUNG Personalisierung
REMARKETING Remarketing
ANGEBOTE 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 Startseite Ihrer Organisation, zur Vorlagendokumentation und zu Versionsinformationen. Jede Version wird durch eine Änderungsnummer, auch SHA-Nummer genannt, gekennzeichnet. Das ist die Änderungsnummer, die mit dem Git-Commit verknüpft ist. Das Feld changeNotes ist optional, wird aber empfohlen, um 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. Dies sollte eine URL sein, die auf die Dokumentation für Ihre Vorlage verweist.
  3. Suchen Sie auf GitHub nach dem 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, ist die Commit-Ansicht aufzurufen und auf das Symbol für die Zwischenablage (Symbol für die Zwischenablage) zu klicken. Dadurch wird die gesamte SHA-Nummer in die Zwischenablage kopiert. Fügen Sie diese Zahl als Wert für den sha-Eintrag als untergeordnetes Element des versions-Knotens 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.

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 Struktur, die oben beschrieben wurde.

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

Jeder Eintrag in der Vorlagengalerie der Community enthält einen Link zum Abschnitt Issues (Probleme) im GitHub-Repository der Vorlage. So können Nutzer Sie informieren, wenn sie einen Fehler finden. Achten Sie darauf, dass Probleme für das GitHub-Repository Ihrer Vorlage nicht deaktiviert wurden, damit Sie auftretende Probleme prüfen und beheben können.

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 mit einem Konto bei GitHub 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 sie möglicherweise von Zeit zu Zeit aktualisieren. Ihre Vorlagennutzer werden benachrichtigt, wenn es ein Update für die Vorlage gibt, und können die Vorlage auf die neueste Version aktualisieren.

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

  1. Suchen Sie den Commit mit den Änderungen, die Sie pushen möchten, und kopieren Sie die SHA-Nummer. Eine einfache Möglichkeit dazu ist, in GitHub die Commit-Ansicht aufzurufen und auf das Symbol für die Zwischenablage (Symbol für die Zwischenablage) zu klicken. Dadurch wird die gesamte SHA-Nummer in die Zwischenablage kopiert.
  2. Fügen Sie in metadata.yaml oben in der Liste versions einen neuen sha-Eintrag hinzu. (Siehe Beispiel unten.)
  3. Fügen Sie changeNotes hinzu, um die Änderungen in dieser neuen Version kurz zu beschreiben. Sie können auch mehrzeilige Kommentare erstellen. (Siehe Beispiel unten.)
  4. Wenn Sie die Änderung für metadata.yaml übernehmen, wird sie in der Regel innerhalb von zwei bis drei Tagen in der Galerie angezeigt.

In diesem Beispiel wird gezeigt, wie Sie neue Versionsinformationen wie die SHA-Nummer und Änderungsnotizen 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.

Repository verschieben

Wenn Sie Inhaber oder Repository-Namen ändern möchten, können Sie die GitHub-Übertragungsfunktion für Repositories 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 entsprechenden Repository. Das Galerie-Monitoringsystem erkennt diese Änderung und entfernt die Vorlage automatisch.