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

Галерея шаблонов сообщества Диспетчера тегов 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 (необязательно, но рекомендуется).

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

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

Пример:

___INFO___

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

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

Категория Описание
РЕКЛАМА Реклама
ПАРТНЕРСКИЙ МАРКЕТИНГ Партнерский маркетинг
АНАЛИТИКА Аналитика
АТРИБУЦИЯ Атрибуция
ЧАТ Чат
КОНВЕРСИИ Измерение конверсий
ХРАНИЛИЩЕ ДАННЫХ Хранилище данных
РЕКЛАМНАЯ РАССЫЛКА Рекламная рассылка
ЭКСПЕРИМЕНТАЦИЯ A/B эксперименты и оптимизация контента
ТЕПЛОВАЯ КАРТА Тепловые карты
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 — перейти к представлению фиксации и щелкнуть значок буфера обмена ( clipboard icon ). Это скопирует весь номер SHA в буфер обмена. Вставьте это число в качестве значения для вашей записи sha как дочернего элемента узла versions , как показано ниже.
  4. Добавьте запись 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, вы сможете отправить его в галерею шаблонов сообщества. Чтобы отправить шаблон, выполните следующие действия:

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

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

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

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

  1. Найдите фиксацию, включающую изменения, которые вы хотите отправить, и скопируйте номер SHA. Самый простой способ сделать это в GitHub — перейти к представлению фиксации и щелкнуть значок буфера обмена ( clipboard icon ). Это скопирует весь номер 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.