Vorlagen an die Community-Galerie für Vorlagen senden

In der Community-Galerie für Vorlagen von Google Tag Manager kann Ihre Organisation Tag- und Variablenvorlagen erstellen und verwalten, die nativ in Google Tag Manager integriert werden können. 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. Für Ihre Organisation profitieren Sie von folgenden Vorteilen:

• Ihre Kunden können Ihre Vorlagen problemlos hinzufügen und verwenden.
• Tag Manager-Nutzer sehen die Marke Ihrer Organisation.
• Ihre Kunden können Ihre Tags innerhalb von Minuten bereitstellen, nicht innerhalb von Monaten.
• Sie können Aktualisierungen für Ihre Vorlagen veröffentlichen und diese Aktualisierungen automatisch für Ihre Kunden zur Verfügung stellen.

Zum Einreichen einer neuen Vorlage bei der Community-Galerie für Vorlagen sind folgende Schritte erforderlich:

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

Vorlage erstellen

Erstellen Sie Ihre Vorlage in Google Tag Manager zuerst als benutzerdefinierte Vorlage. Stellen Sie sicher, dass Ihre Vorlage gründlich getestet wurde, dass ihr Inhalt dem Styleguide entspricht und Sie über einen Plan oder Prozess verfügen, wie Ihre Vorlage gepflegt und aktualisiert wird, falls dies in Zukunft erforderlich wird.

Nutzungsbedingungen

Bei jeder neu eingereichten Vorlage müssen die Nutzungsbedingungen der Community-Galerie für Vorlagen von Google Tag Manager akzeptiert werden. So bestätigen Sie die Zustimmung zu den Nutzungsbedingungen für Ihre Vorlage:

1. Lesen Sie die Nutzungsbedingungen für die Community-Galerie für Vorlagen von Google Tag Manager.
2. Öffnen Sie die Vorlage im Vorlageneditor zur Bearbeitung und klicken Sie auf dem Tab Info das Kästchen Zustimmung zu Nutzungsbedingungen der Community-Galerie für Vorlagen an.

Vorlage exportieren

Sobald Ihre Vorlage fertig ist, exportieren Sie die Vorlagendatei auf Ihren lokalen Rechner 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 namens template.tpl. Diese Datei muss aktualisiert werden, damit ein categories-Eintrag hinzugefügt werden kann.
2. Eine metadata.yaml-Datei.
3. Eine LICENSE-Datei. Der Dateiname muss in GROSSBUCHSTABEN geschrieben werden und der Inhalt der Lizenzdatei darf nur Apache 2.0 sein.
4. Fügen Sie eine README.md-Datei hinzu (optional, aber empfohlen).

Hinweis: Verwenden Sie das Beispielvorlagen-Repository auf GitHub als Modell. Kopieren Sie die Datei LICENSE aus der Beispielvorlage in Ihr Projekt und achten Sie darauf, dass der Inhalt keine Fehler enthält. Aktualisieren Sie außerdem die Zeile mit dem Urheberrecht in der Zeile „Copyright [yyyy] [name of copyright owner]“. in der Beispielversion. 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 Ihre Datei template.tpl mit einem categories-Eintrag im Bereich INFO und geben Sie mindestens einen relevanten Kategoriewert an, der aus der folgenden Tabelle ausgewählt ist. Wenn mehr als eine Kategorie geeignet ist, können Sie bis zu drei Kategoriewerte angeben. Die Werte sind von der relevantesten bis am wenigsten relevanten geordnet.

Hinweis :Die Werte für den categories-Eintrag müssen 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
TEST	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
SURVEY	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 Versionsinformationen. Jede Version ist durch eine Änderungsnummer gekennzeichnet, die auch als SHA-Nummer bezeichnet wird. Dies ist die mit dem Git-Commit verknüpfte Änderungsnummer. 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 den 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 in GitHub nach dem Commit, der die Änderungen enthält, die Sie für die ursprüngliche Version Ihrer Vorlage per Push übertragen möchten, und kopieren Sie die SHA-Nummer. Sie können die SHA-Nummer in GitHub ganz einfach abrufen, indem Sie eine Commit-Ansicht aufrufen und auf das Symbol für die Zwischenablage () klicken. Dadurch wird der gesamte SHA-Wert in die Zwischenablage kopiert. Fügen Sie diese Zahl wie unten gezeigt als Wert für Ihren sha-Eintrag 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 obigen Codebeispiel gezeigt übereinstimmen.

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 zu aktualisieren.

Auf GitHub hochladen

Der nächste Schritt besteht darin, Ihre Dateien auf GitHub hochzuladen. 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 enthalten, die sich auf der Stammebene des Git-Repositorys befinden. Jedes Git-Repository sollte nur eine template.tpl-Datei haben. Alle Ressourcen müssen sich im Hauptzweig Ihres GitHub-Repositorys befinden. Jedes Vorlagen-Repository, das nicht dieser Struktur entspricht, wird aus der Galerie entfernt.

Jeder Eintrag in der Community-Galerie für Vorlagen enthält einen Link zum Abschnitt Issues (Probleme) im GitHub-Repository der Vorlage. Nutzer können Ihnen so mitteilen, wenn sie einen Fehler finden. Achten Sie darauf, dass im GitHub-Repository Ihrer Vorlage keine Probleme deaktiviert wurden, damit Sie eventuell auftretende Probleme prüfen und beheben können.

Vorlage senden

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

1. Stellen Sie sicher, dass Sie in GitHub mit einem Konto angemeldet sind, das Zugriff auf das Vorlagen-Repository hat, das Sie zur 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 dafür vorgesehene Feld ein und klicken Sie auf Senden.

Vorlage aktualisieren

Nachdem Sie eine Vorlage veröffentlicht haben, können Sie sie von Zeit zu Zeit aktualisieren. Ihre Vorlagennutzer werden über eine Aktualisierung der Vorlage benachrichtigt und haben die Möglichkeit, die Vorlage auf die neueste Version zu aktualisieren.

Mit 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 die Änderungsnummer (SHA-Nummer) im Abschnitt versions Ihrer metadata.yaml-Datei hinzufügen.

1. Suchen Sie den Commit, der die Änderungen enthält, die Sie übertragen möchten, und kopieren Sie die SHA-Nummer. In GitHub können Sie dies ganz einfach tun, indem Sie eine Commit-Ansicht aufrufen und auf das Symbol für die Zwischenablage () klicken. Dadurch wird der gesamte SHA-Wert in die Zwischenablage kopiert.
2. Fügen Sie Ihrer versions-Liste in metadata.yaml einen neuen sha-Eintrag hinzu. (Siehe Beispiel 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. (Siehe Beispiel unten.)
4. Übernehmen Sie die Änderung zu metadata.yaml. Ihr Update wird normalerweise 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 Ä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.

Wichtig: Jede veröffentlichte Version der Vorlage sollte im Abschnitt versions enthalten sein und in umgekehrter chronologischer Reihenfolge geordnet sein.

Hinweis: Nicht jedes inkrementelle Commit muss als Versionsänderung in der Community-Galerie für Vorlagen enthalten sein. Wenn Sie beispielsweise inkrementelle Änderungen in 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 von Commit 1, 2 und 3 enthält.