Vorlagen an die Community-Galerie für Vorlagen senden

In der Community-Galerie von Google Tag Manager können Sie Vorlagen für Tags und Variablen erstellen und verwalten, die nativ in Google Tag Manager integriert sind. Ihre Organisation kann eine Vorlage erstellen, das Vorlagen-Repository auf GitHub veröffentlichen und Ihre Vorlage dann an die Community-Galerie für Vorlagen senden, um sie Nutzern weltweit zur Verfügung zu stellen. Zu den Vorteilen für Ihre Organisation gehören:

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

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

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

Vorlage erstellen

Erstellen Sie die Vorlage in Google Tag Manager als benutzerdefinierte Vorlage. Überprüfen Sie, ob Ihre Vorlage gründlich getestet wurde, ob der Inhalt der Vorlage dem Styleguide entspricht und ob Sie einen Plan oder Prozess zur Wartung und Aktualisierung der Vorlage haben, falls dies in Zukunft erforderlich sein sollte.

Nutzungsbedingungen

Jede neue Vorlage muss den Nutzungsbedingungen der Community-Galerie für Vorlagen von Google Tag Manager entsprechen. So bestätigen Sie die Nutzungsbedingungen für Ihre Vorlage:

1. Lesen Sie die Nutzungsbedingungen für die Google Tag Manager-Community-Galerie für Vorlagen.
2. Öffnen Sie Ihre Vorlage im Vorlagen-Editor und klicken Sie auf dem Tab Info das Kästchen "Accept the Community Template Gallery Nutzungsbedingungen" an.

Vorlage exportieren

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

Projektdateien vorbereiten

Als Nächstes müssen Sie Ihr Repository für die Veröffentlichung auf GitHub vorbereiten. 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 ausschließlich in Großbuchstaben geschrieben sein und der Inhalt der Lizenzdatei darf nur Apache 2.0 enthalten.
4. Fügen Sie eine README.md-Datei hinzu (optional, aber empfohlen).

Hinweis: Verwenden Sie als Beispiel das Beispielvorlagen-Repository auf GitHub. Kopieren Sie die Datei LICENSE aus der Beispielvorlage in Ihr Projekt, um sicherzustellen, dass der Inhalt keine Fehler enthält. Achten Sie darauf, in der Beispielversion unter „Urheberrecht“ die Zeile „Copyright [yyyy] [name of copyright owner]“ zu aktualisieren. Ersetzen Sie yyyy durch das Jahr des Urheberrechts und [name of copyright owner] durch den Namen des Urheberrechtsinhabers.

Kategorien zu template.tpl hinzufügen

Aktualisieren Sie Ihre template.tpl-Datei mit einem categories-Eintrag in den Abschnitt INFO und geben Sie mindestens einen relevanten Kategoriewert aus der folgenden Tabelle an. Wenn mehrere Kategorien geeignet sind, können Sie bis zu drei Kategoriewerte angeben, sortiert nach Relevanz.

Hinweis: Die Werte für den Eintrag categories müssen als Array formatiert sein.

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
YOUTUBE ANALYTICS	Analytics
LIZENZINFORMATION	Zuordnung
CHAT	Chat
CONVERSIONS	Conversion-Messung
DATEN_WAREHOUSING	Data-Warehouse-Prozesse
E-MAIL_MARKETING	E-Mail-Marketing
TEST	A/B-Tests und Inhaltsoptimierung
HEAT_MAP	Heat maps
LEAD_GENERATION	Lead-Generierung
MARKETING	Marketing
PERSONALISIERUNG	Personalisierung
REMARKETING	Remarketing
ANGEBOTE	Vertrieb und CRM
SITZUNG_AUFZEICHNUNG	Aufzeichnungen von Sitzungen
SOCIAL	Sozial
UMFRAGE	Umfragen
TAG_MANAGEMENT	Tag-Management-Systeme
Funktionalität	Dienstprogramme für Google Tag Manager

Metadaten.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 bezeichnet, die auch als SHA-Nummer bezeichnet wird. Dabei handelt es sich um die mit dem Git-Commit verknüpfte Änderungsnummer. Das Feld changeNotes ist optional, wird aber empfohlen, um Ihre Nutzer über die in der Version enthaltenen Änderungen 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 Ihrer Vorlage verweist.
3. Suchen Sie in GitHub nach dem Commit, das die Änderungen enthält, die Sie für Ihre ursprüngliche Version Ihrer Vorlage übertragen möchten, und kopieren Sie die SHA-Nummer. Sie können die SHA-Nummer ganz einfach in GitHub abrufen, indem Sie eine Commit-Ansicht aufrufen und auf das Symbol für die Zwischenablage () klicken. Dadurch wird die gesamte SHA-Nummer in die Zwischenablage kopiert. Fügen Sie diese Nummer wie unten gezeigt als Wert für den Eintrag sha als untergeordnetes Element des Knotens versions ein.
4. Fügen Sie dem Knoten versions einen changeNotes-Eintrag hinzu, um die in dieser neuen Version enthaltenen Änderungen 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 Beispiel oben gezeigt ausgerichtet werden.

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

Auf GitHub hochladen

Als Nächstes laden Sie Ihre Dateien in GitHub hoch. Erstellen Sie ein GitHub-Repository mit den entsprechenden Dateien und der Struktur wie oben beschrieben.

Vorlagen-Repositories müssen die Dateien * template.tpl, metadata.yaml und LICENSE auf der Stammebene des Git-Repositorys haben. 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 enthält einen Link zum Abschnitt Probleme im GitHub-Repository der Vorlage. So können Nutzer sehen, ob sie einen Fehler finden. Achten Sie darauf, dass keine Probleme für das GitHub-Repository Ihrer Vorlage 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 an die Community-Galerie für Vorlagen senden. So senden Sie Ihre Vorlage:

1. Achten Sie darauf, dass Sie in GitHub mit einem Konto angemeldet sind, das Zugriff auf das Vorlagen-Repository hat, das Sie der Galerie hinzufügen möchten.
2. Rufe 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 dafür vorgesehene Feld ein und klicken Sie auf Senden.

Vorlage aktualisieren

Nachdem Sie eine Vorlage veröffentlicht haben, können Sie Ihre Vorlage gelegentlich aktualisieren. Ihre Vorlagennutzer werden benachrichtigt, wenn ein Update der Vorlage erfolgt, und haben die Möglichkeit, die Vorlage auf die neueste Version zu aktualisieren.

Anhand der Datei metadata.yaml wird festgelegt, welche Version der 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 der Datei metadata.yaml einfügen.

1. Suchen Sie das Commit mit den Änderungen, die Sie übertragen möchten, und kopieren Sie die SHA-Nummer. Rufen Sie dazu in GitHub die Commit-Ansicht auf und klicken Sie auf das Symbol für die Zwischenablage (). Dadurch wird die gesamte SHA-Nummer in die Zwischenablage kopiert.
2. Füge oben in der Liste "versions" in metadata.yaml einen neuen Eintrag für "sha" hinzu. (Beispiel siehe unten).
3. Fügen Sie changeNotes hinzu, um die in dieser neuen Version enthaltenen Änderungen kurz zu beschreiben. Bei Bedarf können Sie mehrzeilige Kommentare erstellen. (Beispiel siehe unten).
4. Übernehmen Sie die Änderung in metadata.yaml. Das Update wird normalerweise innerhalb von zwei bis drei Tagen in der Galerie angezeigt.

In diesem Beispiel wird gezeigt, wie Sie neue Versionsinformationen wie die SHA-Nummer und Änderungshinweise 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:Alle veröffentlichten Versionen der Vorlage müssen im versions-Abschnitt enthalten sein. Sie sind in der umgekehrten chronologischen Reihenfolge aufgeführt (vom neuesten zum ältesten).

Hinweis:Nicht jeder inkrementelle Commit muss als Versionsänderung in die Galerie für Community-Vorlagen aufgenommen werden. Wenn Sie beispielsweise inkrementelle Änderungen an den Commits 1, 2 und 3 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.