Перевод статьи Симо Ахава "GTM Tools Add-on For Google Sheets".
Содержание:
Зачем нужно расширение GTM Tools by Simo Ahava
GTM Tools by Simo Ahava - расширение для Google Таблиц, призванное помочь в управлении и обновлении элементов контейнеров GTM (теги, триггер и переменные).
В первой версии расширения есть инструмент сбора документации, который позволяет автоматически создавать документацию для последней версии контейнера GTM (тегов, триггеров и переменных). Так же дополнение включает в себя функцию отправки информации об изменения в поле примечаний, которая позволяет автоматически массово обновлять поле примечания (Notes) для тегов, триггеров и переменных.
Как установить расширение
В Google Таблицах откройте меню "Дополнения - Установить дополнения".
Вы увидите окно интернет-магазина Chrome. Введите "GTM Tools by Simo Ahava" в поле поиска и нажмите Enter. Нужное расширение появится в результатах поиска.
Нажмите кнопку "Установить". Вам будет предложено авторизоваться в своем Google аккаунте, и предоставить доступ расширению к вашим данным. Для расширения требуется доступ на чтение и запись данных из Диспетчера тегов Google, а также доступ для чтения и записи к учетной записи Google Таблиц.
Теперь вы готовы использовать расширение!
Сбор документации
В меню с дополнениями появится пункт "GTM Tools by Simo Ahava". Возможно, вам придется перезагрузить страницу, если пункт не появился, или в нем отсутствует часть подпунктов.
После нажатия на «Build Documentation», расширение предложит вам выбрать аккаунт и контейнер диспетчера тегов Google. В списке будут все контейнеры, к которым имеет доступ ваша текущий учетная запись Google. После выбора контейнера, нажмите «Build», чтобы запустить процесс.
Конструктор создаст четыре новых листа: один для вашей версии контейнера и по одному для ваших тегов, триггеров и переменных.
Каждый лист имеет префикс в виде ID контейнера.
На листах содержится информацию о контейнере на основе последней версии контейнера. Если версия еще не создана, функция создания документации не будет работать.
Никогда не переименовывайте листы, созданные инструментом! Название необходимо для работы расширения.
Выделение изменений в примечаниях
Еще вы можете отредактировать поле "Notes" на листах тегов, триггеров и переменных. Это поле можно редактировать на ваше усмотрение.
После внесения изменений в колонку "Notes" (изменения в других столбцах игнорируются, и вы НИКОГДА не должны изменять столбец JSON), выберите пункт "Mark changes to Notes" в меню расширения. Откроется новое диалоговое окно.
Когда вы нажимаете «Mark changes», инструмент пройдет по всем листам документации по тегам, триггерам и переменным, выделит маркером все поля, которые отличаются от последней версии. Это будет визуальной подсказкой о том, в каких полях изменились значения.
В диалоговом окне также будет информация, сколько полей было выделено в результате проверки.
Отправка изменений в заметки
После добавления заметок вы можете отправить их в контейнер GTM. Контейнер выбирается автоматически на основе активного листа таблицы. Поэтому, если у вас активен один из листов документации с префиксом GTM-XXXXX-X, он будет использоваться в качестве целевого контейнера для отправки. Если вы выбрали лист с префиксом GTM-YYYYY-Y, будет использоваться этот контейнер, и т.д.
На скриншоте из начала этой статьи показан пример того, как выглядит окно отправки, когда у вас выбран активный лист.
После нажатия на кнопку "PUSH CNANGES", расширение обновит все теги, триггеры и переменные на листах контейнера, добавляя информацию из поля примечаний в каждый элемент в соответствии с внесенными изменениями. Изменения будут добавлены в рабочую область, выбранную с помощью селектора в модальном окне.
После успешной отправки изменений, всплывающее окно сообщит, сколько изменений было внесено. Вы также можете нажать ссылку в модальном окне, чтобы расширение создало новую версию только что обновленного рабочего пространства.
Это действие на ваш страх и риск. Если рабочая область не прошла проверку, это приведет к ошибке. Обратите внимание, что все изменения в рабочей области будут добавлены в новую версию.
После внесения изменения, вам стоит как можно скорее создать новую версию. В противном случае документация всегда будет интерпретировать изменения в примечаниях как новые изменения, потому что они всегда сравниваются с последней версией контейнера.
При создании новой версии всегда следует повторно запускать функцию сбора документации.
Если ранее лист уже создавался, при пересборке документации надстройка всегда будет показывать соответствующую подсказку. Вы можете перезаписать лист или пропустить его в процессе сборки документации. Пока вы не внесли вручную изменения на листы, созданные с помощью инструмента сбора документации (я бы не рекомендовал этого делать), рекомендуется разрешать надстройке перезаписывать содержимое листов данными из последней версии контейнер.
Важно
Для правильной работы расширения, следуйте следующим правилам:
- Никогда не редактируйте названия листов - важно чтобы листы использовали имена по умолчанию, созданные надстройкой.
- Никогда не удаляйте и не изменяйте именованные диапазоны, созданные надстройкой.
- Никогда не изменяйте значения в столбце JSON.
Изменение значений в столбцах, кроме Notes, ничего не даст. В какой-то момент я добавлю возможность массового обновления и других полей.
