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

.

Uwaga: jako modelu użyj przykładowego repozytorium szablonów w GitHubie. Skopiuj plik LICENSE z przykładowego szablonu do swojego projektu, aby mieć absolutną pewność, że w treści nie ma błędów, i upewnij się, że zaktualizuj wiersz Prawa autorskie w miejscu, w którym znajduje się napis „Copyright [yyyy] [name of copyright owner]” w wersji próbnej. Zastąp yyyy rokiem praw autorskich, a [name of copyright owner] nazwą właściciela praw autorskich.

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

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

Ważne: wartości sha i changeNotes muszą być wyrównane zgodnie z powyższym przykładem kodu.

Uwaga: wartość sha musi odwoływać się do konkretnego pliku template.tpl, który chcesz opublikować. Nie zapomnij prawidłowo aktualizować 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ą, 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 (). 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.

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

Uwaga: nie każde zatwierdzenie przyrostowe musi być uwzględniane jako zmiana wersji w Galerii szablonów społeczności. Jeśli na przykład wprowadzisz stopniowe zmiany w zatwierdzeniach 1, 2 i 3, a ostateczna wersja będzie miała zatwierdzenie 4, w przypadku zatwierdzenia 4 musisz mieć tylko 1 wpis, który zawiera wszystkie zmiany z zatwierdzeń 1, 2 i 3.