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

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).

Uwaga: użyj repozytorium przykładowych na GitHubie jako modelu. Skopiuj plik LICENSE z przykładowego szablonu do projektu, aby mieć pewność, że w treści nie ma błędów. Pamiętaj też, aby w przykładowej wersji zaktualizować wiersz „Prawa autorskie” o treści „Copyright [yyyy] [name of copyright owner]”. Zastąp ciąg yyyy rokiem praw autorskich, a [name of copyright owner] nazwą właściciela praw autorskich.

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.

Uwaga: wartości pozycji 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
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 (). 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.

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

Uwaga: wartość sha musi odnosić się do konkretnego pliku szablon.tpl, który chcesz opublikować. Nie zapomnij zaktualizować tej wartości prawidłowo w 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ą, 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 (). 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.

Ważne: każdą opublikowaną wersję szablonu należy uwzględnić w sekcji versions ułożonej w odwrotnej kolejności chronologicznej (od najstarszej do najstarszej).

Uwaga: nie każdy sposób przyrostowego zatwierdzenia musi być widoczny jako zmiana wersji w Galerii szablonów. Jeśli na przykład wprowadzasz przyrostowe zmiany w zatwierdzeniach 1, 2 i 3, a ostatnia wersja to 4 zatwierdzenie, musisz utworzyć tylko 1 wpis na zatwierdzenie 4 obejmujący wszystkie zmiany z zatwierdzeń 1, 2 i 3.