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:
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:
- Lesen Sie die Nutzungsbedingungen für die Google Tag Manager-Community-Galerie für Vorlagen.
- Ö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:
- Eine exportierte Vorlagendatei mit dem Namen
template.tpl
. Diese Datei muss aktualisiert werden, um einencategories
-Eintrag hinzuzufügen. - Eine
metadata.yaml
-Datei - Eine
LICENSE
-Datei Der Dateiname muss ausschließlich in Großbuchstaben geschrieben sein und der Inhalt der Lizenzdatei darf nur Apache 2.0 enthalten. - Fügen Sie eine
README.md
-Datei hinzu (optional, aber empfohlen).
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.
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:
- Fügen Sie einen Eintrag
homepage
hinzu. Dies sollte eine URL sein, die auf die Startseite Ihrer Organisation verweist. - Fügen Sie einen Eintrag für
documentation
hinzu. Dies sollte eine URL sein, die auf die Dokumentation Ihrer Vorlage verweist. - 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 Knotensversions
ein. - Fügen Sie dem Knoten
versions
einenchangeNotes
-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.
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:
- 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.
- Rufe die Community-Galerie für Vorlagen unter tagmanager.google.com/gallery auf.
- Klicken Sie auf more_vert und wählen Sie Vorlage senden aus.
- 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.
- 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.
- Füge oben in der Liste "
versions
" inmetadata.yaml
einen neuen Eintrag für "sha
" hinzu. (Beispiel siehe unten). - 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). - Ü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.