Thanks for previewing Google's new tag platform documentation! This site is in public beta. (Feedback)

Создать пользовательскую переменную

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

В этом руководстве вы узнаете, как создать собственный шаблон переменной. Когда эта переменная используется, она принимает массив значений и возвращает их в виде строки с разделителями-запятыми.

  1. Чтобы создать свой первый шаблон переменных, нажмите «Шаблоны» в левой панели навигации и нажмите кнопку «Создать» в разделе «Шаблоны переменных» .

  2. На вкладке «Информация» определите имя и описание переменной.

    Имя — это то, что будет представлено пользователям, когда они перейдут к реализации этой переменной в пользовательском интерфейсе Диспетчера тегов.

    Описание — это то, на что оно похоже — краткое (не более 200 символов) описание того, что делает эта переменная.

  3. Нажмите «Обновить» , чтобы просмотреть свой шаблон.

    Справа от полей ввода находится окно предварительного просмотра шаблона . Каждый раз, когда в редакторе вносятся изменения, появляется кнопка «Обновить» . Нажмите «Обновить», чтобы увидеть, как ваши изменения повлияют на внешний вид вашей переменной.

  4. Нажмите «Поля» , чтобы добавить поля в шаблон переменных.

    Вкладка « Поля » редактора шаблонов позволяет создавать и редактировать поля в шаблоне переменных. Поля используются для ввода пользовательских данных, таких как идентификатор учетной записи. Вы можете добавить стандартные элементы формы, такие как текстовые поля, раскрывающиеся меню, переключатели и флажки.

  5. Нажмите «Добавить поле» и выберите «Простая таблица» . Замените имя по умолчанию (например , «simpleTable1» ) на «список» . В предварительном просмотре шаблона нажмите «Обновить» .

    Повторите этот шаг для текстового ввода и назовите его «массив» , двух флажков с именами « use_array » и «sort» и текстового ввода с именем «разделитель» . Для «разделителя» присвойте ему значение по умолчанию «,», щелкнув значок шестеренки, включив «Значение по умолчанию» , а затем заполнив новое поле ввода «Значение по умолчанию».

  6. Перейдите на вкладку «Код» и введите изолированный JavaScript в редакторе:

    var input = data.array;
    
    if (!data.use_array) {
      input = [];
      for (var i = 0; i < data.list.length; i++) {
        input.push(data.list[i].values);
      }
    }
    
    if (data.sort) {
      input.sort();
    }
    
    return input.join(data.delimiter || ',');
    

    Код для этой переменной довольно прост, но есть несколько моментов, на которые стоит обратить внимание.

    • поля data .

      Есть несколько полей, доступ к которым осуществляется вне глобальных data . data будут содержать значения, которые вы установили на предыдущем шаге. Вот почему мы можем получить доступ к data.use_array , data.sort , data.list и data.delimiter .

    • delimiter устанавливается значение по умолчанию "," если data.delimiter не указан. Хорошей практикой является установка значений по умолчанию для поля, если это имеет смысл. Это упрощает пользователям использование шаблона переменной, поскольку им не нужно заполнять каждое поле, чтобы использовать переменную.

  7. Нажмите Сохранить , чтобы сохранить свой прогресс. Это загрузит все обнаруженные разрешения в редактор шаблонов.

    Некоторые API-интерфейсы шаблонов имеют связанные с ними разрешения , которые определяют, что они могут или не могут делать. Когда вы используете API-интерфейс шаблона, такой как sendPixel в своем коде, Диспетчер тегов покажет соответствующие разрешения на вкладке «Разрешения» .

  8. На вкладке «Предварительный просмотр шаблона» добавьте несколько значений для ввода «значения», нажмите «Выполнить код» и посмотрите на консоль , чтобы увидеть выходные данные для вашей переменной.

    Если есть какие-либо ошибки, они появятся в окне консоли .

  9. Нажмите «Сохранить » и закройте редактор шаблонов.

    Теперь шаблон переменной должен быть готов к использованию.