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

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

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

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

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

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

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

Условия использования

Каждый новый шаблон должен соответствовать Условиям использования Галереи шаблонов сообщества Диспетчера тегов Google. Чтобы подтвердить согласие с Условиями использования вашего шаблона:

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

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

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

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

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

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

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

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

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

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

Пример:

___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 :

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. Любой репозиторий шаблонов, не соответствующий этой структуре, будет удален из Галереи.

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

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

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

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.