Styleguide für Vorlagen

Dieser Stilleitfaden soll Ihnen bei der Entscheidung helfen, wie Sie Vorlagen für die Community-Galerie für Vorlagen vorbereiten. Dieser Stilguide basiert auf den Schreibprinzipien von Google Material Design. Einfach ausgedrückt:

  • Präzise formulieren
  • Schreiben Sie einfach und direkt.
  • Nutzer klar ansprechen
  • Wichtige Details mitteilen
  • Für alle Leseniveaus schreiben
  • Menschlich sein: Schreiben Sie für Menschen, nicht für Roboter

Beachten Sie diese Richtlinien, damit alle Vorlagen ein einheitliches Erscheinungsbild haben und Nutzer die Verwendung Ihrer Vorlage besser nachvollziehen können.

Info

Diese Richtlinien gelten für Elemente auf dem Tab Info im Vorlageneditor.

Name

Der Name der Vorlage wird Tag Manager-Nutzern in der Benutzeroberfläche von Tag Manager und in der Community-Galerie für Vorlagen angezeigt. Sie wird oben auf der Detailseite einer Vorlage und in der Liste der Vorlagen angezeigt.

  • Verwenden Sie den Namen Ihres Unternehmens/Ihrer Organisation und den funktionalen Namen der Vorlage: Name der Organisation Name der Vorlage.
  • Verwenden Sie Großbuchstaben am Wortanfang.
  • Verwenden Sie Begriffe, die die Funktion beschreiben.
  • Verwenden Sie den Begriff „Offizielle“ in Vorlagennamen nur, wenn Sie von der entsprechenden Organisation dazu berechtigt sind.

Beispiele:Conversion-Analyse-Tag von „Meine Firma“, Variable „Kampagnen-ID von „Meine Firma““

Beschreibung

Die Vorlagenbeschreibung ist eine Beschreibung der Vorlage, die auf Detailseiten als kurze Zusammenfassung der Vorlagenfunktionen angezeigt wird.

  • Beschreiben Sie in klaren und prägnanten Sätzen, wozu die Vorlage dient.
  • Beschreiben Sie klar, welchen Nutzen Ihre Vorlage für die Nutzer hat. Beispiel: „Mit der Zielgruppenerstellungsvorlage von beispiel.de können Sie neue Zielgruppenlisten aus Websitebesuchern erstellen.“
  • Vermeiden Sie Fachjargon.
  • Fügen Sie Links zu zusätzlichen Informationen, Dokumentationen und Support hinzu.

Symbol

Das Symbol Ihrer Vorlage wird in Tag Manager und in der Galerie für Community-Vorlagen als Thumbnail angezeigt.

  • Verwenden Sie PNG, JPEG oder GIF als Bildformat.
  • Das Bild muss quadratisch sein, mindestens 48 × 48 Pixel groß und darf maximal 96 × 96 Pixel groß sein.
  • Die Dateigröße darf 50 Kilobyte nicht überschreiten.
  • Verwenden Sie offizielle Unternehmenslogos nur, wenn Sie von der entsprechenden Organisation dazu berechtigt sind.
  • Felder
  • Auf dem Tab „Felder“ im Vorlageneditor können Sie Formularelemente wie Textfelder und Kästchen hinzufügen.

Felder

Diese Stilrichtlinien gelten für den Tab Felder im Vorlageneditor.

Parametername

Das ist der Name des Felds, wie er im Vorlageneditor angezeigt wird, nicht wie er für den Nutzer angezeigt wird. Die Namen sollten die Art der verwendeten Daten beschreiben. Formatieren Sie Parameternamen als lowerCamelCase. Beispiele:userName, customerID, shoppingCartValue.

Feldlabels

Feldlabels umfassen Anzeigenamenfelder, Kästchentext und zugehörige Elemente.

  • Achten Sie auf korrekte Groß- und Kleinschreibung.
  • Eine kürzere Anzeige ist besser.
  • Verwenden Sie anschauliche Worte.
  • Verwenden Sie gängige Wörter.

Hilfetext

Hilfetext ist ein informativer Inhalt, der als Kurzinfo angezeigt wird, um Nutzern zu helfen, einen gültigen Wert in das Vorlagenfeld einzugeben. Geben Sie nach Möglichkeit Beispieleingaben an und beschreiben Sie, wie das Vorlagenfeld verwendet wird oder welche Auswirkungen die Angabe bestimmter Werte hat.

  • Achten Sie auf korrekte Groß- und Kleinschreibung.
  • Seien Sie kurz, aber verständlich. Sie können auch Konjunktive verwenden und in der zweiten Person schreiben.
  • Unterstützte Feldtypen
  • Eine grundlegende HTML-Formatierung ist zulässig. Beispiele: <strong>, <em>.

Unterstützte Feldtypen

Typ
 Beschreibung
Texteingabe Texteingabe Der Wert eines Vorlagenparameters dieses Typs ist ein String, der sich auf Variablen beziehen kann. Das Texteingabe-Widget, das in der Tag Manager-Benutzeroberfläche gerendert wird, kann entweder ein einzeiliges Textfeld oder eine mehrzeilige Eingabe sein.
Drop-down-Menü Drop-down-Menü, in dem nur ein Element als Wert des Vorlagenparameters ausgewählt werden konnte. Listen Sie die Elemente in alphabetischer Reihenfolge auf, es sei denn, es gibt einen triftigen Grund, dies nicht zu tun.
Kästchen Kästcheneingaben Der Wert eines Vorlagenparameters dieses Typs ist boolescher Natur: „wahr“ für angeklickt, „falsch“ für nicht angeklickt.
Optionsfeld Radioeingabe Bei einem Vorlagenparameter dieses Typs wird in der Tag Manager-Benutzeroberfläche eine Liste mit Auswahlmöglichkeiten angezeigt. Der Nutzer darf nur eine der Optionen als Wert für den Vorlagenparameter auswählen.
Einfache Tabelle Eine einfache Tabelleneingabe. Jede Zelle in der Tabelle kann direkt bearbeitet werden. Es gibt zwei Arten von Zellen: Texteingabe oder Drop-down-Menü. Der Wert eines Vorlagenparameters dieses Typs ist ein Array von Objekten: Jedes Objekt codiert eine Zeile, jeder Schlüssel im Objekt muss einer der Spaltennamen sein und jeder Wert im Objekt ist der Wert der entsprechenden Zelle.