Prześlij szablon do Galerii szablonów społeczności

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

  • Twoi klienci będą mogli łatwo dodawać szablony i z nich korzystać.
  • Użytkownicy Menedżera tagów będą mieć kontakt z marką Twojej organizacji.
  • Klienci będą mogli wdrożyć tagi w ciągu kilku minut, a nie miesięcy.
  • Możesz publikować aktualizacje szablonów i automatycznie udostępniać je klientom.

Proces przesyłania nowego szablonu do Galerii szablonów społeczności obejmuje te główne kroki:

  1. Tworzenie szablonu
  2. Przygotowywanie plików projektu
  3. Prześlij pliki do GitHuba
  4. Przesyłanie szablonu

Tworzenie szablonu

Na początek utwórz szablon w Menedżerze tagów Google jako szablon niestandardowy. Upewnij się, że Twój szablon został dokładnie przetestowany, jego zawartość jest zgodna z Przewodnikiem po stylach oraz masz wdrożony plan lub proces utrzymania i aktualizowania szablonu, jeśli w przyszłości zajdzie taka potrzeba.

Warunki korzystania z usługi

Każdy nowy szablon musi zaakceptować Warunki korzystania z Galerii szablonów Menedżera tagów Google. Aby potwierdzić, że akceptujesz Warunki korzystania z usługi obowiązujące w przypadku Twojego 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 na karcie Informacje zaznacz pole „Akceptuję warunki korzystania z usługi Galeria szablonów społeczności”.

Eksportowanie szablonu

Gdy szablon będzie gotowy, wyeksportuj go na komputer lokalny i zmień nazwę pliku template.tpl.

Przygotowywanie plików projektu

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

  1. Wyeksportowany plik szablonu o nazwie template.tpl. Musisz zaktualizować ten plik, aby dodać wpis categories.
  2. Plik metadata.yaml.
  3. Plik LICENSE. Nazwa pliku musi być pisana WIELKIMI LITERAMI, a zawartość pliku licencji może zawierać wyłącznie Apache 2.0.
  4. Dodaj plik README.md (opcjonalne, ale zalecane).
.

Dodaj kategorie do grupy reklam template.tpl

W sekcji INFO dodaj do pliku template.tpl wpis categories i podaj co najmniej jedną odpowiednią wartość kategorii wybranej z poniższej tabeli. Jeśli odpowiednia jest więcej niż jedna kategoria, można podać maksymalnie 3 wartości kategorii (od najtrafniejszych do najmniej trafnych).

Przykład:

___INFO___

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

Tabela obsługiwanych wartości kategorii:

Kategoria Opis
REKLAMY Reklamy
AFFILIATE_MARKETING Marketing afiliacyjny
STATYSTYKI Analytics
UZNANIE AUTORSTWA Atrybucja
CZAT Czat
KONWERSJE Pomiar konwersji
DATA_WAREHOUSING Gromadzenie danych
EMAIL_MARKETING Marketing e-mailowy
EKSPERYMENT Eksperymenty A/B i optymalizacja treści
HEAT_MAP Mapy termiczne
LEAD_GENERATION Zwiększanie liczby potencjalnych klientów
MARKETING Marketing
PERSONALIZACJA Personalizacja
REMARKETING Remarketing
WYPRZEDAŻ Sprzedaż i zarządzanie relacjami z klientami
SESSION_RECORDING Nagrania sesji
SIEĆ SPOŁECZNOŚCIOWA Sieci społecznościowe
SURVEY Ankiety
TAG_MANAGEMENT Systemy zarządzania tagami
FUNKCJA Narzędzia Menedżera tagów Google

metadata.yaml

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

Aby skonfigurować plik metadata.yaml:

  1. Dodaj wpis homepage. Powinien to być adres URL wskazujący stronę główną organizacji.
  2. Dodaj wpis dotyczący domeny documentation. Powinien to być URL prowadzący do dokumentacji szablonu.
  3. W GitHubie znajdź zatwierdzenie zawierające zmiany, które chcesz przekazać dla początkowej wersji szablonu, i skopiuj numer SHA. Prostym sposobem na uzyskanie numeru SHA z GitHuba jest otwarcie widoku zatwierdzenia i kliknięcie ikony schowka (ikona schowka). Spowoduje to skopiowanie całego numeru SHA do schowka. Wklej tę liczbę 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 w tej 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.

Repozytoria szablonów muszą zawierać pliki * template.tpl, metadata.yaml i LICENSE znajdujące się na poziomie głównym repozytorium Git. Każde repozytorium Git powinno zawierać tylko 1 plik template.tpl. Wszystkie zasoby muszą być w gałęzi głównej repozytorium GitHub. Każde repozytorium szablonów, które nie pasuje do tej struktury, zostanie usunięte z Galerii.

Każdy wpis w Galerii szablonów będzie zawierał link do sekcji Problemy w repozytorium GitHub szablonu, dzięki czemu użytkownicy będą mogli poinformować Cię o znalezieniu błędu. Sprawdź, czy problemy z repozytorium szablonu GitHub nie zostały wyłączone, aby móc przejrzeć i rozwiązać ewentualne problemy.

Przesyłanie szablonu

Gdy repozytorium szablonów zostanie hostowane w GitHubie, możesz przesłać szablon do Galerii szablonów. Aby przesłać szablon, wykonaj te czynności:

  1. Zaloguj się w GitHubie na konto z dostępem do repozytorium szablonów, które chcesz dodać do Galerii.
  2. Otwórz Galerię szablonów społeczności na tagmanager.google.com/gallery.
  3. Kliknij i wybierz Prześlij szablon.
  4. W odpowiednim polu wpisz URL repozytorium i kliknij Prześlij.

Aktualizowanie szablonu

Po opublikowaniu szablonu możesz co jakiś czas aktualizować go. Użytkownicy szablonu otrzymają powiadomienie o aktualizacji szablonu i będą mogli zaktualizować go do najnowszej wersji.

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

  1. Znajdź zatwierdzenie zawierające zmiany, które chcesz przekazać, i skopiuj numer SHA. Aby to zrobić, otwórz widok zatwierdzenia i kliknij ikonę schowka (ikona schowka). Spowoduje to skopiowanie całego numeru SHA do schowka.
  2. Dodaj nowy wpis sha na początku listy versions w sekcji metadata.yaml. Zobacz przykład poniżej.
  3. Dodaj changeNotes, aby krótko opisać zmiany w tej nowej wersji. Jeśli chcesz, możesz utworzyć komentarze wielowierszowe. Zobacz przykład poniżej.
  4. Wprowadź zmianę na metadata.yaml, a aktualizacja pojawi się w galerii zwykle w ciągu 2–3 dni.

Ten przykład pokazuje, jak dodać informacje o nowej wersji, w tym numer SHA i uwagi o zmianach:

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.