Отправьте шаблон в галерею шаблонов сообщества.

Галерея шаблонов сообщества Google Tag Manager позволяет вашей организации создавать и управлять шаблонами тегов и переменных, которые изначально интегрируются с Google Tag Manager. Ваша организация может создать шаблон, опубликовать репозиторий шаблонов на GitHub, а затем отправить свой шаблон в Галерею шаблонов сообщества, чтобы сделать его доступным для пользователей по всему миру. Преимущества для вашей организации включают:

• Ваши клиенты смогут легко добавлять и использовать ваши шаблоны.
• Пользователи Менеджера тегов увидят бренд вашей организации.
• Ваши клиенты смогут развернуть ваши теги в течение нескольких минут, а не месяцев.
• Вы можете публиковать обновления своих шаблонов и делать эти обновления автоматически доступными для своих клиентов.

Процесс отправки нового шаблона в Галерею шаблонов сообщества включает в себя следующие основные этапы:

1. Создайте свой шаблон
2. Подготовьте файлы вашего проекта
3. Загрузите ваши файлы на GitHub
4. Отправьте свой шаблон

Создайте свой шаблон

Для начала создайте свой шаблон в Google Tag Manager как пользовательский шаблон . Убедитесь, что ваш шаблон был тщательно протестирован, что его содержимое соответствует Руководству по стилю , и что у вас есть план или процесс для поддержания и обновления вашего шаблона, если в будущем возникнет такая необходимость.

Условия обслуживания

Каждая новая отправка шаблона должна соответствовать Условиям обслуживания галереи шаблонов сообщества Google Tag Manager. Чтобы подтвердить согласие с Условиями обслуживания для вашего шаблона:

1. Ознакомьтесь с Условиями обслуживания галереи шаблонов сообщества Google Tag Manager .
2. В редакторе шаблонов откройте шаблон для редактирования и установите флажок на вкладке « Информация» с надписью «Согласен с Условиями обслуживания галереи шаблонов сообщества» .

Экспортируйте свой шаблон

После завершения создания шаблона экспортируйте файл шаблона на локальный компьютер и переименуйте файл template.tpl .

Подготовьте файлы вашего проекта

Следующий шаг — подготовить ваш репозиторий для публикации на GitHub. Каждый репозиторий должен содержать следующие файлы:

1. Экспортированный файл шаблона с именем template.tpl . Этот файл необходимо обновить, чтобы добавить запись categories .
2. Файл metadata.yaml .
3. Файл LICENSE . Имя файла должно быть ВСЕМИ ЗАГЛАВНЫМИ БУКВАМИ, а содержимое файла лицензии должно быть только Apache 2.0 .
4. Добавьте файл README.md (необязательно, но рекомендуется).

Примечание: используйте репозиторий шаблонов примеров на GitHub в качестве модели. Скопируйте файл LICENSE из шаблона примеров в свой проект, чтобы быть абсолютно уверенным в отсутствии ошибок в содержании, и обязательно обновите строку Copyright, где в версии примера указано " Copyright [yyyy] [name of copyright owner] ". Замените yyyy на год авторских прав, а [name of copyright owner] на имя владельца авторских прав.

Добавить категории в template.tpl

Обновите файл template.tpl , добавив в раздел INFO запись categories , и укажите хотя бы одно релевантное значение категории, выбранное из следующей таблицы. Если подходит более одной категории, вы можете указать до трех значений категории, упорядоченных от наиболее релевантных до наименее релевантных.

Примечание: значения для записи categories должны быть отформатированы как массив.

Пример:

___INFO___

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

Таблица поддерживаемых значений категорий:

Категория	Описание
РЕКЛАМА	Реклама
АФФИЛИАТ_МАРКЕТИНГ	Партнерский маркетинг
АНАЛИТИКА	Аналитика
АТРИБУЦИЯ	Атрибуция
ЧАТ	Чат
КОНВЕРСИИ	Измерение конверсии
ХРАНЕНИЕ_ДАННЫХ	Хранилище данных
МАРКЕТИНГ_ЭЛЕКТРОННОЙ ПОЧТЫ	Маркетинг по электронной почте
ЭКСПЕРИМЕНТИРОВАНИЕ	Эксперименты A/B и оптимизация контента
ТЕПЛОВАЯ_КАРТА	Тепловые карты
ГЕНЕРАЦИЯ_ЛИДОВ	Генерация лидов
МАРКЕТИНГ	Маркетинг
ПЕРСОНАЛИЗАЦИЯ	Персонализация
РЕМАРКЕТИНГ	Ремаркетинг
ПРОДАЖИ	Продажи и CRM
ЗАПИСЬ_СЕАНСА	Записи сеансов
СОЦИАЛЬНЫЕ	Социальный
ОПРОС	Опросы
УПРАВЛЕНИЕ_ТЕГОМ	Системы управления тегами
ПОЛЕЗНОСТЬ	Утилиты Google Tag Manager

метаданные.yaml

Файл metadata.yaml содержит информацию о вашем шаблоне, включая ссылки на домашнюю страницу вашей организации, документацию шаблона и информацию о версии. Каждая версия обозначается номером изменения, также известным как номер SHA, который является номером изменения, связанным с коммитом Git. Поле changeNotes необязательно, но рекомендуется для информирования пользователей об изменениях, включенных в версию.

Чтобы настроить файл metadata.yaml :

1. Добавьте homepage записи. Это должен быть URL-адрес, указывающий на домашнюю страницу вашей организации.
2. Добавьте запись для documentation . Это должен быть URL, указывающий на документацию для вашего шаблона.
3. В GitHub найдите коммит, включающий изменения, которые вы хотите отправить для вашей первоначальной версии шаблона, и скопируйте номер SHA. Простой способ получить номер SHA в GitHub — перейти к просмотру коммита и щелкнуть значок буфера обмена ( ). Это скопирует весь номер SHA в буфер обмена. Вставьте этот номер в качестве значения для вашей записи sha в качестве дочернего элемента узла versions , как показано ниже.
4. Добавьте запись changeNotes в узел versions , чтобы кратко описать изменения, содержащиеся в этой новой версии.

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

Важно: sha и changeNotes должны быть выровнены, как показано в приведенном выше примере кода.

Примечание: Значение sha должно ссылаться на конкретный файл template.tpl, который вы хотите опубликовать. Не забудьте правильно обновить это значение с каждой новой версией !

Загрузить на GitHub

Следующий шаг — загрузить файлы на GitHub. Создайте репозиторий GitHub с соответствующими файлами и структурой, как описано выше .

Репозитории шаблонов должны иметь файлы * template.tpl , metadata.yaml и LICENSE , находящиеся на корневом уровне репозитория Git. Каждый репозиторий Git должен иметь только один файл template.tpl . Все ресурсы должны находиться в основной ветке вашего репозитория GitHub. Любой репозиторий шаблонов, который не соответствует этой структуре, будет удален из Галереи.

Каждая запись в галерее шаблонов сообщества будет ссылаться на раздел Issues репозитория шаблона GitHub, чтобы пользователи могли сообщить вам, если они найдут ошибку. Убедитесь, что Issues не отключены для репозитория вашего шаблона GitHub, чтобы вы могли просматривать и решать любые возникающие проблемы.

Отправьте свой шаблон

После того, как ваш репозиторий шаблонов будет размещен на GitHub, вы можете приступить к отправке вашего шаблона в Community Template Gallery. Чтобы отправить ваш шаблон, выполните следующие действия:

1. Убедитесь, что вы вошли в GitHub с учетной записью, имеющей доступ к репозиторию шаблонов, который вы хотите добавить в Галерею.
2. Перейдите в Галерею шаблонов сообщества по адресу tagmanager.google.com/gallery .
3. Нажмите и выберите «Отправить шаблон» .
4. Укажите URL-адрес репозитория в соответствующем поле и нажмите «Отправить» .

Обновите свой шаблон

После публикации шаблона вы можете время от времени предоставлять обновления для вашего шаблона. Ваши пользователи шаблона будут уведомлены, если есть обновление шаблона, и будут иметь возможность обновить шаблон до последней версии .

Файл metadata.yaml используется для определения версии вашего шаблона, которую следует использовать в галерее. Чтобы опубликовать новые версии, вам необходимо добавить номер изменения (номер SHA) в раздел versions вашего файла metadata.yaml .

1. Найдите коммит, включающий изменения, которые вы хотите отправить, и скопируйте номер SHA. Самый простой способ сделать это в GitHub — перейти к просмотру коммита и щелкнуть значок буфера обмена ( ). Это скопирует весь номер SHA в буфер обмена.
2. Добавьте новую запись sha в начало списка versions в metadata.yaml . (См. пример ниже.)
3. Добавьте changeNotes , чтобы кратко описать изменения, содержащиеся в этой новой версии. При желании вы можете создать многострочные комментарии. (См. пример ниже.)
4. Зафиксируйте изменение в 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.

Важно: каждая опубликованная версия шаблона должна быть включена в раздел versions , упорядоченный в обратном хронологическом порядке (от самой новой к самой старой).

Примечание: Не каждый инкрементальный коммит нужно включать в качестве изменения версии в галерею шаблонов сообщества. Например, если вы вносите инкрементальные изменения в коммиты 1, 2 и 3, а финальная версия — коммит 4, у вас должна быть только одна запись для коммита 4, которая включает все изменения из коммитов 1, 2 и 3.

Переместите свой репозиторий

Если вы хотите изменить владельцев или имена репозиториев, вы можете использовать процесс переноса репозитория GitHub . Новое местоположение будет обнаружено, и пользователи будут автоматически перенаправлены в новый репозиторий при следующем обновлении шаблона.

Удалить ваш шаблон

Чтобы удалить шаблон из галереи, удалите либо файл LICENSE , либо файл metadata.yaml из его репозитория. Система мониторинга галереи обнаружит это изменение и автоматически удалит шаблон.