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 są natywnie zintegrowane 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 społeczności, aby udostępnić go użytkownikom na całym świecie. Korzyści dla Twojej organizacji:

• Twoi klienci będą mogli bez trudu dodawać szablony i używać ich.
• Dzięki temu użytkownicy Menedżera tagów będą mogli zapoznać się 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ć te aktualizacje 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. Przesyłanie plików do GitHuba
4. Przesyłanie szablonu

Tworzenie szablonu

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

Warunki korzystania z usługi

Każde przesłane nowy szablon musi być zgodne z Warunkami korzystania z usługi Menedżer tagów Google w Galerii szablonów. Aby potwierdzić zgodę na 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 na karcie Informacje zaznacz pole „Akceptuję Warunki korzystania z Galerii szablonów społeczności”.

Eksportowanie szablonu

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

Przygotuj pliki 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ć tylko Apache 2.0.
4. Dodaj plik README.md (opcjonalne, ale zalecane).

Uwaga: jako modelu użyj przykładowego repozytorium szablonów na GitHubie. Skopiuj plik LICENSE z przykładowego szablonu do swojego projektu, aby mieć absolutną pewność, że jego treść nie zawiera żadnych błędów. Pamiętaj też o zaktualizowaniu wiersza dotyczącego praw autorskich w miejscu, w którym znajduje się napis „Copyright [yyyy] [name of copyright owner]” w przykładowej wersji. Zastąp yyyy rokiem praw autorskich, a [name of copyright owner] – imieniem i nazwiskiem właściciela praw autorskich.

Dodaj kategorie do pokoju template.tpl

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

Uwaga: wartości wpisu categories powinny być sformatowane jako tablica.

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	Analityka
UZNANIE AUTORSTWA	Atrybucja
CZAT	Czat
KONWERSJE	Pomiar konwersji
DATA_WAREHOUSING	Hurtownie danych
EMAIL_MARKETING	E-maile marketingowe
EKSPERYMENTACJA	Eksperymenty A/B i optymalizacja treści
HEAT_MAP	Mapy termiczne
LEAD_GENERATION	Zwiększenie liczby potencjalnych klientów
MARKETING	Dział marketingu
SPERSONALIZACJA	Personalizacja
REMARKETING	Remarketing
WYPRZEDAŻ	Sprzedaż i zarządzanie relacjami z klientami
SESSION_RECORDING	Nagrania sesji
SOCIAL	Sieci społecznościowe
ANKIETA	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ę szablonów i informacje o wersji. Każda wersja jest oznaczona numerem zmiany (nazywanym też numerem SHA) i 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 strony głównej Twojej organizacji.
2. Dodaj wpis dla documentation. Powinien to być adres URL prowadzący do dokumentacji Twojego szablonu.
3. W GitHubie znajdź zatwierdzenie zawierające zmiany, które chcesz przekazać do początkowej wersji szablonu, i skopiuj numer SHA. Aby w prosty sposób uzyskać numer SHA z GitHuba, otwórz widok zatwierdzenia i kliknij ikonę schowka (). Spowoduje to skopiowanie całego numeru SHA do schowka. Wklej tę liczbę jako wartość wpisu sha jako podrzędnego węzła versions, jak pokazano poniżej.
4. Dodaj wpis changeNotes do węzła versions, aby krótko opisać zmiany zawarte w tej nowej wersji.

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

Ważne: sha i changeNotes muszą być wyrównane, tak jak w powyższym przykładzie kodu.

Uwaga: wartość sha musi odnosić się do konkretnego plikutemplate.tpl, który chcesz opublikować. Nie zapomnij zaktualizować tej wartości przy każdej nowej wersji.

Prześlij do GitHuba

Następnym krokiem jest przesłanie plików do GitHuba. Utwórz repozytorium GitHub z odpowiednimi plikami i strukturą zgodnie z opisem 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 mieć tylko 1 plik template.tpl. Wszystkie zasoby muszą znajdować się w głównej gałęzi w 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 społeczności będzie zawierał link do sekcji Problemy w repozytorium szablonu na GitHubie, dzięki czemu użytkownicy będą mogli informować Cię o znalezieniu błędu. Sprawdź, czy problemy z repozytorium GitHub szablonu nie zostały wyłączone, aby można było je przejrzeć i rozwiązać.

Przesyłanie szablonu

Gdy Twoje repozytorium szablonów będzie przechowywane na GitHubie, możesz przesłać szablon do Galerii szablonów społeczności. Aby przesłać szablon, wykonaj te czynności:

1. Pamiętaj, aby zalogować się na 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 wyświetlonym polu wpisz URL repozytorium i kliknij Prześlij.

Aktualizowanie szablonu

Po opublikowaniu szablonu możesz co jakiś czas wprowadzać do niego aktualizacje. Użytkownicy szablonu zostaną powiadomieni o aktualizacji szablonu i będą mogli zaktualizować szablon 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 w pliku metadata.yaml.

1. Znajdź zatwierdzenie zawierające zmiany, które chcesz przekazać, i skopiuj numer SHA. Możesz w prosty sposób zrobić to na GitHubie, otwierając widok zatwierdzenia i klikając ikonę schowka (). Spowoduje to skopiowanie całego numeru SHA do schowka.
2. Dodaj nowy wpis sha na początku listy versions w: metadata.yaml. Zobacz przykład poniżej.
3. Aby krótko opisać zmiany wprowadzone w nowej wersji, dodaj atrybut changeNotes. Jeśli chcesz, możesz utworzyć komentarze wielowierszowe. Zobacz przykład poniżej.
4. Zatwierdź zmianę na metadata.yaml, a aktualizacja powinna pojawić się w galerii zazwyczaj w ciągu 2–3 dni.

Ten przykład pokazuje, jak dodać informacje o nowej wersji, w tym numer SHA i notatki 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.

Ważne: każda opublikowana wersja szablonu powinna zostać uwzględniona w sekcji versions w odwrotnej kolejności chronologicznej (od najnowszych do najstarszych).

Uwaga: nie każde zatwierdzenie przyrostowe musi być uwzględnione jako zmiana wersji w Galerii szablonów społeczności. Jeśli na przykład stopniowo wprowadzasz zmiany w zatwierdzeniach 1, 2 i 3, a ostateczna wersja to zatwierdzenie 4, musisz mieć tylko 1 wpis dla zatwierdzenia 4 ze wszystkimi zmianami z zatwierdzeń 1, 2 i 3.