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 oraz zarządzanie nimi, które są natywnie zintegrowane z Menedżerem tagów Google. Organizacja może utworzyć szablon, opublikować repozytorium szablonów 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 Twojej organizacji:

• Klienci będą mogli łatwo dodawać i używać Twoich szablonów.
• Użytkownicy Menedżera tagów będą mieli dostęp do marki Twojej organizacji.
• Twoi klienci będą mogli wdrażać tagi w ciągu minut, a nie miesięcy.
• Możesz publikować aktualizacje swoich szablonów i automatycznie udostępniać je klientom.

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

1. Tworzenie szablonu
2. Przygotowanie plików projektu
3. Przesyłanie plików do GitHuba
4. Przesyłanie szablonu

Tworzenie szablonu

Aby rozpocząć, utwórz szablon w Menedżerze tagów Google jako szablon niestandardowy. Upewnij się, że szablon został dokładnie przetestowany, że jego zawartość jest zgodna ze wskazówkami redakcyjnymi oraz że masz plan lub proces konserwacji i aktualizacji szablonu, gdyby w przyszłości pojawiła się taka potrzeba.

Warunki korzystania z usługi

Każdy nowy przesłany szablon musi być zgodny z Warunkami korzystania z Galerii szablonów społeczności Menedżera tagów Google. Aby potwierdzić akceptację Warunków korzystania z usługi dotyczących Twojego szablonu:

1. Zapoznaj się z Warunkami korzystania z Galerii szablonów społeczności Menedżera tagów Google.
2. W edytorze szablonów otwórz szablon do edycji i zaznacz pole na karcie Informacje o nazwie „Akceptuję Warunki korzystania z Galerii szablonów społeczności”.

Eksportowanie szablonu

Gdy szablon będzie gotowy, wyeksportuj plik szablonu na komputer lokalny i nazwij go template.tpl.

Przygotuj pliki projektu

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

1. Wyeksportowany plik szablonu o nazwie template.tpl. Aby dodać wpis categories, musisz zaktualizować ten plik.
2. plik metadata.yaml.
3. plik LICENSE. Nazwa pliku musi być zapisana WIELKIMI LITERAMI, a zawartość pliku licencji musi zawierać tylko licencję Apache 2.0.
4. Dodaj plik README.md (opcjonalnie, ale zalecane).

Dodawanie kategorii do template.tpl

Zaktualizuj plik template.tpl, dodając do sekcji INFO wpis categories i podając co najmniej jedną odpowiednią wartość kategorii wybraną z tabeli poniżej. Jeśli pasuje więcej niż 1 kategoria, możesz podać maksymalnie 3 wartości kategorii uporządkowane od najbardziej do najmniej odpowiedniej.

Przykład:

___INFO___

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

Tabela obsługiwanych wartości kategorii:

metadata.yaml

Plik metadata.yaml zawiera informacje o szablonie, w tym linki do strony głównej organizacji, dokumentacji szablonu i informacji o wersji. Każda wersja jest oznaczona numerem zmiany, zwanym też numerem SHA, który jest numerem zmiany powiązanej z komitowaniem w Git. Pole changeNotes jest opcjonalne, ale zalecamy jego wypełnienie, aby poinformować użytkowników o zmianach wprowadzonych w tej wersji.

Aby skonfigurować plik metadata.yaml:

1. Dodaj wpis homepage. Powinien to być adres URL wskazujący na stronę główną Twojej organizacji.
2. Dodaj wpis dla documentation. Powinien to być adres URL wskazujący na dokumentację szablonu.
3. W GitHubie znajdź commit zawierający zmiany, które chcesz przesłać w przypadku początkowej wersji szablonu, i skopiuj numer SHA. Aby łatwo uzyskać numer SHA w GitHub, 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 elementu podrzędnego węzła versions, jak pokazano poniżej.
4. Dodaj do węzła versions wpis changeNotes, 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.

Przesyłanie do GitHuba

Następnym krokiem jest przesłanie plików na GitHuba. Utwórz repozytorium GitHub z odpowiednimi plikami i strukturą opisaną wyżej.

Repozytoria szablonów muszą zawierać pliki * template.tpl, metadata.yaml i LICENSE znajdujące się na poziomie katalogu głównego repozytorium Git. Każde repozytorium Git powinno zawierać tylko jeden plik template.tpl. Wszystkie zasoby muszą znajdować się na gałęzi głównej w repozytorium GitHub. 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 GitHub szablonu, aby użytkownicy mogli poinformować Cię o problemach. Upewnij się, że problemy nie zostały wyłączone w repozytorium GitHuba szablonu, aby móc sprawdzić i rozwiązać wszelkie problemy.

Przesyłanie szablonu

Gdy 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. Upewnij się, że jesteś zalogowany(-a) w GitHub na koncie, 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 stronie tagmanager.google.com/gallery.
3. Kliknij more_vert i wybierz Prześlij szablon.
4. Wpisz URL repozytorium w odpowiednim polu i kliknij Prześlij.

Aktualizowanie szablonu

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

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

1. Odszukaj commita zawierającego zmiany, które chcesz przesłać, i skopiuj numer SHA. W GitHub możesz to łatwo zrobić, przechodząc do widoku zatwierdzania 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 sekcji metadata.yaml. (patrz przykład poniżej).
3. Dodaj changeNotes, aby krótko opisać zmiany wprowadzone w nowej wersji. W razie potrzeby możesz utworzyć komentarze wielowierszowe. (patrz przykład poniżej).
4. Przenieś zmianę do metadata.yaml, a aktualizacja 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.

Przenoszenie repozytorium

Jeśli chcesz zmienić właścicieli lub nazwy repozytoriów, możesz skorzystać z procesu przenoszenia repozytoriów GitHub. Nowa lokalizacja zostanie wykryta, a użytkownicy zostaną automatycznie przekierowani do nowego repozytorium przy następnej aktualizacji szablonu.

Usuwanie szablonu

Aby usunąć szablon z galerii, usuń plik LICENSE lub plik metadata.yaml z repozytorium. System monitorowania galerii wykryje tę zmianę i automatycznie usunie szablon.