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:
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:
- Weitere Informationen finden Sie in den Nutzungsbedingungen der Community-Galerie für Vorlagen in Google Tag Manager.
- Ö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:
- Eine exportierte Vorlagendatei namens
template.tpl
. Diese Datei muss aktualisiert werden, damit eincategories
-Eintrag hinzugefügt werden kann. - Eine
metadata.yaml
-Datei. - Eine
LICENSE
-Datei. Der Dateiname muss in GROSSBUCHSTABEN geschrieben werden und der Inhalt der Lizenzdatei darf nur Apache 2.0 sein. - Fügen Sie eine
README.md
-Datei hinzu (optional, aber empfohlen).
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.
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:
- 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 für Ihre Vorlage verweist. - 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 Knotensversions
ein, wie unten gezeigt. - Fügen Sie dem Knoten
versions
einenchangeNotes
-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.
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:
- 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.
- Rufen Sie 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 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.
- 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.
- Füge einen neuen
sha
-Eintrag oben deinerversions
-Liste inmetadata.yaml
hinzu. (siehe Beispiel unten). - 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). - Ü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.