Галерея шаблонов сообщества Диспетчера тегов Google позволяет вашей организации создавать шаблоны тегов и переменных, которые естественным образом интегрируются с Диспетчером тегов Google, и управлять ими. Ваша организация может создать шаблон, опубликовать репозиторий шаблонов на GitHub, а затем отправить его в галерею шаблонов сообщества, чтобы сделать его доступным для пользователей по всему миру. Преимущества для вашей организации включают в себя:
- Ваши клиенты смогут легко добавлять и использовать ваши шаблоны.
- Пользователи Менеджера тегов будут видеть бренд вашей организации.
- Ваши клиенты смогут развернуть ваши теги в течение нескольких минут, а не месяцев.
- Вы можете публиковать обновления своих шаблонов и автоматически делать эти обновления доступными для своих клиентов.
Процесс отправки нового шаблона в галерею шаблонов сообщества включает следующие основные этапы:
Создайте свой шаблон
Для начала создайте свой шаблон в Диспетчере тегов Google как собственный шаблон . Убедитесь, что ваш шаблон был тщательно протестирован, что его содержимое соответствует Руководству по стилю и что у вас есть план или процесс поддержки и обновления вашего шаблона, если в этом возникнет необходимость.
Условия использования
Каждый новый шаблон должен соответствовать Условиям использования Галереи шаблонов сообщества Диспетчера тегов Google. Чтобы подтвердить согласие с Условиями использования вашего шаблона:
- Ознакомьтесь с Условиями использования галереи шаблонов сообщества Диспетчера тегов Google .
- В редакторе шаблонов откройте шаблон для редактирования и установите флажок на вкладке «Информация» с надписью «Принять условия использования галереи шаблонов сообщества» .
Экспортируйте свой шаблон
После завершения создания шаблона экспортируйте файл шаблона на локальный компьютер и переименуйте файл template.tpl
.
Подготовьте файлы проекта
Следующий шаг — подготовить репозиторий для публикации на GitHub. Каждый репозиторий должен содержать следующие файлы:
- Экспортированный файл шаблона с именем
template.tpl
. Этот файл необходимо обновить, чтобы добавить записьcategories
. - Файл
metadata.yaml
. -
LICENSE
файл. Имя файла должно быть написано ЗАГЛАВНЫМИ БУКВАМИ, а содержимое файла лицензии должно быть только Apache 2.0 . - Добавьте файл
README.md
(необязательно, но рекомендуется).
Добавьте категории в template.tpl
Обновите файл template.tpl
, добавив запись categories
в раздел INFO
, и укажите хотя бы одно соответствующее значение категории, выбранное из следующей таблицы. Если подходит более одной категории, вы можете указать до трех значений категорий, упорядоченных от наиболее релевантных к наименее релевантным.
Пример:
___INFO___
{
"displayName": "Example Template",
"categories": ["AFFILIATE_MARKETING", "ADVERTISING"],
// additional template properties, etc...
}
Таблица поддерживаемых значений категорий:
Категория | Описание |
---|---|
РЕКЛАМА | Реклама |
AFFILIATE_MARKETING | Партнерский маркетинг |
АНАЛИТИКА | Аналитика |
АТРИБУЦИЯ | Атрибуция |
ЧАТ | Чат |
КОНВЕРСИИ | Измерение конверсий |
ДАННЫЕ_ХРАНИЛИЩЕ | Хранилище данных |
EMAIL_MARKETING | Электронный маркетинг |
ЭКСПЕРИМЕНТАЦИЯ | A/B эксперименты и оптимизация контента |
HEAT_MAP | Тепловые карты |
LEAD_GENERATION | Генерация лидов |
МАРКЕТИНГ | Маркетинг |
ПЕРСОНАЛИЗАЦИЯ | Персонализация |
РЕМАРКЕТИНГ | Ремаркетинг |
ПРОДАЖИ | Продажи и CRM |
СЕССИЯ_RECORDING | Записи сеансов |
СОЦИАЛЬНЫЙ | Социальные |
ОПРОС | Опросы |
TAG_MANAGEMENT | Системы управления тегами |
ПОЛЕЗНОСТЬ | Утилиты Диспетчера тегов Google |
метаданные.yaml
Файл metadata.yaml
содержит информацию о вашем шаблоне, включая ссылки на домашнюю страницу вашей организации, документацию по шаблону и информацию о версии. Каждая версия обозначается номером изменения, также известным как номер SHA, который представляет собой номер изменения, связанный с фиксацией Git. Поле changeNotes
является необязательным, но рекомендуется для информирования пользователей об изменениях, включенных в версию.
Чтобы настроить файл metadata.yaml
:
- Добавьте
homepage
записи. Это должен быть URL-адрес, указывающий на домашнюю страницу вашей организации. - Добавьте запись для
documentation
. Это должен быть URL-адрес, указывающий на документацию для вашего шаблона. - В GitHub найдите коммит, содержащий изменения, которые вы хотите внести в исходную версию шаблона, и скопируйте номер SHA. Самый простой способ получить номер SHA в GitHub — перейти к представлению фиксации и щелкнуть значок буфера обмена ( ). Это скопирует весь номер SHA в буфер обмена. Вставьте это число в качестве значения для вашей записи
sha
как дочернего элемента узлаversions
, как показано ниже. - Добавьте запись
changeNotes
в узелversions
, чтобы кратко описать изменения, содержащиеся в этой новой версии.
homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
- sha: 5f02a788b90ae804f86b04aa24af8937e567874a
changeNotes: Initial release.
Загрузить на GitHub
Следующий шаг — загрузка файлов на GitHub. Создайте репозиторий GitHub с соответствующими файлами и структурой, как описано выше .
В репозиториях шаблонов должны быть файлы * template.tpl
, metadata.yaml
и LICENSE
, расположенные на корневом уровне репозитория Git. В каждом репозитории Git должен быть только один файл template.tpl
. Все ресурсы должны находиться в основной ветке вашего репозитория GitHub. Любой репозиторий шаблонов, не соответствующий этой структуре, будет удален из Галереи.
Каждая запись в галерее шаблонов сообщества будет содержать ссылку на раздел «Проблемы» репозитория шаблона GitHub, чтобы пользователи могли сообщить вам, если они найдут ошибку. Убедитесь, что в репозитории GitHub вашего шаблона не отключены проблемы, чтобы вы могли просматривать и устранять любые возникающие проблемы.
Отправьте свой шаблон
Как только ваш репозиторий шаблонов будет размещен на GitHub, вы сможете отправить его в галерею шаблонов сообщества. Чтобы отправить шаблон, выполните следующие действия:
- Убедитесь, что вы вошли в GitHub с учетной записью, имеющей доступ к репозиторию шаблонов, который вы хотите добавить в галерею.
- Перейдите в галерею шаблонов сообщества по адресу tagmanager.google.com/gallery .
- Нажмите more_vert и выберите «Отправить шаблон» .
- Укажите URL-адрес репозитория в соответствующем поле и нажмите «Отправить» .
Обновите свой шаблон
После публикации шаблона вы можете время от времени обновлять его. Пользователи вашего шаблона будут уведомлены в случае обновления шаблона и смогут обновить шаблон до последней версии .
Файл metadata.yaml
используется для определения того, какую версию вашего шаблона использовать в галерее. Чтобы публиковать новые версии, вам необходимо добавить номер изменения (номер SHA) в раздел versions
вашего файла metadata.yaml
.
- Найдите фиксацию, включающую изменения, которые вы хотите отправить, и скопируйте номер SHA. Самый простой способ сделать это в GitHub — перейти к представлению фиксации и щелкнуть значок буфера обмена ( ). Это скопирует весь номер SHA в буфер обмена.
- Добавьте новую запись
sha
в начало спискаversions
вmetadata.yaml
. (См. пример ниже.) - Добавьте
changeNotes
, чтобы кратко описать изменения, содержащиеся в этой новой версии. При желании вы можете создавать многострочные комментарии. (См. пример ниже.) - Внесите изменения в
metadata.yaml
, и ваше обновление появится в галерее обычно в течение 2–3 дней.
В этом примере показано, как добавить информацию о новой версии, включая номер SHA и примечания к изменениям:
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.