Dziękujemy za podgląd nowej dokumentacji platformy tagów Google Ta witryna jest w publicznej wersji beta. (Opinie)

Przesyłanie szablonu do galerii szablonów społeczności

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Galeria szablonów Menedżera tagów Google umożliwia organizacji tworzenie szablonów tagów i zmiennych oraz zarządzanie nimi, które bezpośrednio integrują się z Menedżerem tagów Google. Twoja organizacja może utworzyć szablon, opublikować jego szablon w GitHubie, a następnie przesłać go do Galerii szablonów społeczności, aby udostępnić go użytkownikom na całym świecie. Korzyści dla organizacji obejmują:

  • Twoi klienci będą mogli łatwo dodawać szablony i ich używać.
  • Użytkownicy Menedżera tagów zobaczą markę Twojej organizacji.
  • Twoi klienci będą mogli wdrożyć Twoje tagi w ciągu kilku minut, a nie miesięcy.
  • Możesz publikować aktualizacje w swoich szablonach i automatycznie udostępniać je klientom.

Proces przesyłania nowego szablonu do Galerii szablonów społeczności wiąże się z tymi głównymi krokami:

  1. Tworzenie szablonu
  2. Przygotowywanie plików projektów
  3. Przesyłanie plików do GitHuba
  4. Przesyłanie szablonu

Utwórz szablon

Na początek utwórz szablon w Menedżerze tagów Google jako szablon niestandardowy. Sprawdź, czy szablon został dokładnie przetestowany, czy jego szablon jest zgodny z przewodnikiem po stylach oraz czy masz plan lub proces konserwacji i aktualizowania szablonu, jeśli zajdzie taka potrzeba.

Warunki usługi

Każdy nowy szablon musi zostać zaakceptowany w Galerii szablonów Menedżera tagów Google. Aby potwierdzić warunki korzystania z szablonu:

  1. Przeczytaj Warunki korzystania z Galerii szablonów Menedżera tagów Google.
  2. W edytorze szablonów otwórz szablon do edycji i zaznacz pole na karcie Informacje oznaczone jako "Zaakceptuj warunki korzystania z galerii szablonów społeczności.

Eksportowanie szablonu

Po utworzeniu szablonu wyeksportuj plik szablonu na komputer lokalny i zmień jego nazwę template.tpl.

Przygotowywanie plików projektu

Kolejnym krokiem jest przygotowanie repozytorium do publikacji w GitHubie. Każde repozytorium powinno zawierać te pliki:

  1. Wyeksportowany plik szablonu o nazwie template.tpl. Zaktualizuj ten plik, aby dodać wpis categories.
  2. Plik metadata.yaml.
  3. Plik LICENSE. Nazwa pliku musi być zapisana WIELKIMI LITERAMI, a ich zawartość musi znajdować się tylko Apache 2.0.
  4. Dodaj plik README.md (opcjonalny, ale zalecany).

Dodaj kategorie do template.tpl

Zaktualizuj plik template.tpl przez dodanie wpisu categories do sekcji INFO i podaj co najmniej 1 odpowiednią wartość kategorii wybraną z poniższej tabeli. Jeśli więcej niż jedna kategoria jest odpowiednia, możesz podać maksymalnie 3 wartości kategorii posortowane od najtrafniejszych do najtrafniejszych.

Przykład:

___INFO___

{
  "displayName": "Example Template",
  "categories": ["AFFILIATE_MARKETING", "ADVERTISING"],
  // additional template properties, etc...
}

Tabela obsługiwanych wartości kategorii:

Kategoria Opis
REKLAMA Reklamy
AFFILIA__MARKETING Marketing afiliacyjny
STATYSTYKI Statystyki
UZNANIE AUTORSTWA Atrybucja
CZAT czat
KONWERSJE Pomiar konwersji
PRZEGLĄDANIE DANYCH Magazyn danych
MARKA_E-MAILA E-maile marketingowe
EKSPERYMENTY Eksperymenty A/B i optymalizacja treści
MAPA OGRZEWANIA Mapy termiczne
POTENCJALNE_POZYSKIWANIE POTENCJALNYCH KLIENTÓW Zwiększenie liczby potencjalnych klientów
MARKETING Marketing
SPERSONALIZOWANIE Personalizacja
REMARKETING Remarketing
WYPRZEDAŻ Sprzedaż i zarządzanie relacjami z klientami
REKORD Nagrania sesji
SIEĆ SPOŁECZNOŚCIOWA Sieci społecznościowe
ANKIETA Ankiety
TAG_ZARZĄDZANIE Systemy zarządzania tagami
PRZYDATNOŚĆ Narzędzia Menedżera tagów Google

metadane.yaml

Plik metadata.yaml zawiera informacje o szablonie, w tym linki do strony głównej Twojej organizacji, dokumentację szablonu i informacje o wersji. Każda wersja jest oznaczona numerem zmiany, który jest też nazywany numerem SHA – numerem zmiany powiązanym z zatwierdzeniem Git. Pole changeNotes jest opcjonalne, ale zalecane, aby poinformować użytkowników o zmianach wprowadzonych w wersji.

Aby skonfigurować plik metadata.yaml:

  1. Dodaj wpis homepage. Powinien to być adres URL wskazujący stronę główną Twojej organizacji.
  2. Dodaj wpis dla: documentation. Powinien to być URL wskazujący dokumentację szablonu.
  3. W GitHubie znajdź zatwierdzenie zawierające zmiany, które chcesz przekazać w ramach początkowej wersji szablonu, i skopiuj numer SHA. Aby w prosty sposób uzyskać numer SHA w GitHubie, otwórz widok zatwierdzenia i kliknij ikonę schowka (ikona schowka). Spowoduje to skopiowanie całego numeru SHA do schowka. Wklej ten numer jako wartość wpisu sha jako elementu podrzędnego węzła versions, jak pokazano poniżej.
  4. Dodaj wpis changeNotes do węzła versions, aby krótko opisać zmiany wprowadzone w nowej wersji.
homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

Prześlij do GitHuba

Następnym krokiem jest przesłanie plików do GitHuba. Utwórz repozytorium GitHub z odpowiednimi plikami i strukturą, jak opisano powyżej.

Repozytorium szablonów musi zawierać pliki * template.tpl, metadata.yaml i LICENSE na poziomie głównym repozytorium Git. Każde repozytorium Git powinno mieć tylko 1 plik template.tpl. Wszystkie zasoby muszą znajdować się w głównej gałęzi repozytorium GitHub. Repozytorium szablonów niezgodne z tą strukturą zostanie usunięte z Galerii.

Każdy wpis w Galerii szablonów jest połączony z sekcją Problemy w szablonie GitHuba, dzięki czemu użytkownicy mogą informować Cię o błędzie. Sprawdź, czy repozytorium szablonu nie zostało wyłączone, aby można było sprawdzić i rozwiązać występujące problemy.

Przesyłanie szablonu

Gdy Twoje repozytorium szablonów będzie hostowane na GitHubie, możesz przesłać szablon do galerii szablonów społeczności. Aby przesłać szablon:

  1. Pamiętaj, aby zalogować się na GitHubie za pomocą konta, które ma dostęp do repozytorium szablonów, które chcesz dodać do Galerii.
  2. Otwórz Galerię szablonów społeczności na tagmanager.google.com/library.
  3. Kliknij i wybierz Prześlij szablon.
  4. Podaj URL repozytorium w odpowiednim polu i kliknij Prześlij.

Zaktualizuj szablon

Po opublikowaniu szablonu warto je okresowo aktualizować. Użytkownicy szablonu otrzymają powiadomienie o jego aktualizacjach i będą mogli zaktualizować go do najnowszej wersji.

Plik metadata.yaml pozwala określić, której wersji szablonu chcesz użyć w galerii. Aby opublikować nowe wersje, musisz dodać numer zmiany (numer SHA) do sekcji versions w pliku metadata.yaml.

  1. Znajdź zatwierdzenie zawierające zmiany, które chcesz przekazać, i skopiuj numer SHA. Możesz w tym celu w prosty sposób otworzyć widok zatwierdzenia i kliknąć ikonę schowka (ikona schowka). Spowoduje to skopiowanie całego numeru SHA do schowka.
  2. Dodaj nowy wpis sha u góry listy versions w: metadata.yaml. Zobacz przykład poniżej.
  3. Dodaj changeNotes, aby krótko opisać zmiany wprowadzone w nowej wersji. Jeśli chcesz, możesz utworzyć komentarze z wieloma wierszami. Zobacz przykład poniżej.
  4. Zatwierdź zmianę na metadata.yaml, a aktualizacja pojawi się w galerii zazwyczaj w ciągu 2–3 dni.

Ten przykład pokazuje, jak dodać nowe informacje o wersji, w tym numer SHA i uwagi dotyczące zmian:

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.