Cómo crear una variable personalizada

En esta guía, se explica cómo crear una plantilla de variable personalizada. Cuándo se usa esta variable, tomará un array de valores y los mostrará como un una cadena delimitada por comas.

1. Para comenzar con tu primera plantilla de variables, haz clic en Plantillas a la izquierda. y haz clic en el botón New en Variable Templates sección.

2. En la pestaña Info, define el Name y la Description de la variable.

   El nombre es el que se les presentará a los usuarios cuando implementen esto. en toda la interfaz de usuario de Tag Manager.

   Una descripción es justo lo que parece: un resumen (de 200 caracteres o menos) descripción de lo que hace esta variable.

3. Haz clic en Actualizar para obtener una vista previa de tu plantilla.

   A la derecha de las entradas del campo, hay la ventana Template Preview. Cada vez que se realice un cambio en el editor, el botón Actualizar para que aparezca la opción. Haz clic en Actualizar para ver qué efecto tienen tus cambios en el aspecto de tu de salida.

4. Haz clic en Campos para agregar campos a tu plantilla de variables.

   La pestaña Campos del Editor de plantillas te permite crear y editar campos en la plantilla de variables. Los campos se utilizan para ingresar datos personalizados, como una cuenta. ID. Puedes agregar los elementos estándares del formulario, como campos de texto, menús menús, botones de selección y casillas de verificación.

5. Haz clic en Agregar campo y selecciona Tabla simple. Reemplaza el nombre predeterminado (p.ej., "simpleTable1") con "list". En Vista previa de la plantilla, haz clic en Actualizar.

   Repite este paso para una Entrada de texto y nómbrala "array", con dos Checkboxes. llamado "use_array" y "sort", y una entrada de texto llamada "{delimitador". En "delimitador", asígnale un valor predeterminado de ""," haciendo clic en el ícono de ajustes, activando "Valor predeterminado" y completa el nuevo Valor predeterminado. campo de entrada.

6. Haz clic en la pestaña Code y, luego, ingresa JavaScript de zona de pruebas en el editor:

   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 || ',');
   

   El código para esta variable es bastante sencillo, pero hay algunos lo que vale la pena señalar.

   • data.

     Hay algunos campos a los que se accede desde el data global. data contendrá los valores que configuraste en el paso anterior. Por eso, podemos acceder a data.use_array, data.sort, data.list y data.delimiter.

   • delimiter se establece en un valor predeterminado de "," si data.delimiter es no proporcionado. Es una buena práctica establecer valores predeterminados para un campo si uno tiene sentido. Esto facilita el uso de la variable plantilla, ya que no tiene que completar todos los campos para usar la variable.

7. Haz clic en Guardar para guardar el progreso. Se cargarán los permisos detectados en el Editor de plantillas.

   Algunas APIs de plantillas tienen permisos asociados que determinan qué pueden o no pueden hacer. Cuando usas una API de plantilla, como sendPixel, en tu código, Tag Manager mostrará los permisos relevantes en la sección Permisos .

8. En la pestaña Vista previa de la plantilla, agrega algunos valores para los "valores". entrada, haz clic Ejecuta el código y consulta la consola para ver el resultado de la variable.

   Si hay algún error, aparecerá en la ventana de la consola.

9. Haz clic en Guardar y cierra el Editor de plantillas.

   La plantilla de variables ya debería estar lista para usarse.