Vorlagen an die Community-Galerie für Vorlagen senden

In der Community-Galerie für Vorlagen in Google Tag Manager kann Ihre Organisation 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 Ihre Vorlage dann an die Community-Galerie für Vorlagen senden, um sie Nutzern weltweit zugänglich zu machen. Zu den Vorteilen für Ihre Organisation gehören:

• 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 in wenigen Minuten implementieren.
• Sie können Updates für Ihre Vorlagen veröffentlichen und diese automatisch für Ihre Kunden zur Verfügung stellen.

Um eine neue Vorlage für die Community-Galerie für Vorlagen einzureichen, sind folgende Schritte erforderlich:

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

Vorlage erstellen

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

Nutzungsbedingungen

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

1. Weitere Informationen finden Sie in den Nutzungsbedingungen der Community-Galerie für Vorlagen in Google Tag Manager.
2. Öffnen Sie die Vorlage im Vorlageneditor zur Bearbeitung und klicken Sie auf dem Tab Info das Kästchen Den Nutzungsbedingungen der Community-Galerie für Vorlagen zustimmen an.

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 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. Kopiere die Datei LICENSE aus der Beispielvorlage in dein Projekt, um dich absolut sicher zu sein, dass der Inhalt keine Fehler enthält. Außerdem muss die Urheberrechtszeile an der Stelle „Copyright [yyyy] [name of copyright owner]“ in der Beispielversion aktualisiert werden. Ersetzen Sie yyyy durch das Jahr des Urheberrechts und [name of copyright owner] durch den Namen des Urheberrechtsinhabers.

Kategorien zur Kampagne „template.tpl“ hinzufügen

Aktualisieren Sie die Datei template.tpl mit einem categories-Eintrag auf den Abschnitt INFO und geben Sie mindestens einen relevanten Kategoriewert aus der folgenden Tabelle an. Wenn mehr als eine Kategorie angemessen ist, können Sie bis zu drei Kategoriewerte angeben, sortiert von der höchsten bis zur niedrigsten Relevanz.

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

Example:

___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	Analysen
LIZENZINFORMATION	Attribution
CHAT	Chat
CONVERSIONS	Conversion-Analyse
DATA_WAREHOUSING	Data-Warehouse-Prozesse
EMAIL_MARKETING	E-Mail-Marketing
EXPERIMENTIERUNG	A/B-Tests und Contentoptimierung
HEAT_MAP	Heat maps
LEAD_GENERATION	Lead-Generierung
MARKETING	Marketing
PERSONALISIERUNG	Personalisierung
REMARKETING	Remarketing
ANGEBOTE	Vertrieb und CRM
SESSION_RECORDING	Aufzeichnungen von Sitzungen
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, Vorlagendokumentation und Versionsinformationen. Jede Version ist durch eine Änderungsnummer gekennzeichnet, die auch als SHA-Nummer bezeichnet wird. Dies 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. Dies sollte eine URL sein, die auf die Dokumentation für Ihre Vorlage verweist.
3. Suchen Sie in GitHub nach dem Commit mit den Änderungen, die Sie für die ursprüngliche Version Ihrer Vorlage per Push übertragen möchten, und kopieren Sie die SHA-Nummer. Eine einfache Möglichkeit zum Abrufen der SHA-Nummer in GitHub besteht darin, die Commit-Ansicht aufzurufen und auf das Symbol für die Zwischenablage () zu klicken. Dadurch wird die gesamte SHA-Nummer in die Zwischenablage kopiert. Fügen Sie diese Nummer als Wert für den Eintrag sha als untergeordnetes Element des Knotens versions ein, wie unten gezeigt.
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 dargestellt ausgerichtet sein.

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

In 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 haben, 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 in Ihrem GitHub-Repository befinden. Vorlagen-Repositorys, die nicht dieser Struktur entsprechen, werden aus der Galerie entfernt.

Jeder Eintrag in der Community-Galerie für Vorlagen ist mit dem Abschnitt Issues (Probleme) im GitHub-Repository der Vorlage verlinkt. 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 alle auftretenden 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. 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 dafür vorgesehene Feld ein und klicken Sie auf Senden.

Vorlage aktualisieren

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

Mit der Datei metadata.yaml wird bestimmt, 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 mit den Änderungen, die Sie übertragen möchten, und kopieren Sie die SHA-Nummer. In GitHub können Sie dazu einfach die Commit-Ansicht aufrufen und auf das Symbol für die Zwischenablage () klicken. Dadurch wird die gesamte SHA-Nummer in die Zwischenablage kopiert.
2. Füge einen neuen sha-Eintrag oben deiner versions-Liste in metadata.yaml 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. Ihr Update wird dann 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 Ä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: Jede veröffentlichte Version der Vorlage sollte im Abschnitt versions in umgekehrter chronologischer Reihenfolge sortiert sein (neueste zuerst).

Hinweis: Nicht jeder inkrementelle Commit muss als Versionsänderung in die Community-Vorlagengalerie aufgenommen werden. 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 aus den Commits 1, 2 und 3 enthält.