Enviar una plantilla a la galería de plantillas de la comunidad

Gracias a la galería de plantillas de la comunidad de Google Tag Manager, tu organización puede crear y gestionar plantillas de variables y etiquetas que se pueden integrar de forma nativa en Tag Manager. Tu organización puede crear una plantilla, publicar el repositorio de plantilla en GitHub y enviar la plantilla a la galería de plantillas de la comunidad para que usuarios de todo el mundo puedan usarla. Estas son algunas de las ventajas para tu organización:

• Los clientes podrán añadir y utilizar tus plantillas fácilmente.
• Los usuarios de Tag Manager estarán expuestos a la marca de tu organización.
• Los clientes podrán implementar tus etiquetas en cuestión de minutos y no meses.
• Puedes actualizar tus plantillas y permitir que los clientes tengan acceso a estas actualizaciones automáticamente.

Para enviar una nueva plantilla a la galería de plantillas de la comunidad, debes seguir estos pasos:

1. Crear la plantilla
2. Preparar los archivos del proyecto
3. Subir los archivos a GitHub
4. Enviar la plantilla

Crear la plantilla

Para empezar, crea la plantilla en Google Tag Manager como plantilla personalizada. Prueba la plantilla, asegúrate de que el contenido sigue la guía de estilo y ten un plan o proceso para mantener la plantilla y actualizarla si es necesario.

Términos del Servicio

Todas las plantillas que se envíen deberán cumplir los Términos del Servicio de la Galería de Plantillas de la Comunidad de Google Tag Manager. Para confirmar que aceptas los Términos del Servicio de tu plantilla, haz lo siguiente:

1. Lee los Términos del Servicio de la Galería de Plantillas de la Comunidad de Google Tag Manager.
2. En el editor de plantillas, abre la plantilla para editarla y marca la casilla Aceptar los Términos del Servicio de la Galería de Plantillas de la Comunidad en la pestaña Información.

Exportar la plantilla

Una vez completada la plantilla, exporta el archivo de la plantilla a tu equipo local y cambia el nombre del archivo por template.tpl.

Preparar los archivos del proyecto

El siguiente paso es preparar el repositorio para publicarlo en GitHub. Todos los repositorios deben contener los siguientes archivos:

1. Un archivo de plantilla exportado con el nombre template.tpl. Este archivo se debe actualizar para añadir una entrada categories.
2. Un archivo metadata.yaml.
3. Un archivo LICENSE. El nombre del archivo debe estar en MAYÚSCULAS y el contenido del archivo de licencia debe ser solo Apache 2.0.
4. Un archivo README.md (opcional, pero recomendado).

Nota: Usa el repositorio de plantilla de muestra de GitHub como modelo. Copia el archivo LICENSE de la plantilla de muestra en tu proyecto para asegurarte de que no haya ningún error en el contenido y actualiza la línea de derechos de autor ("Copyright [yyyy] [name of copyright owner]" en la versión de muestra). Cambia yyyy por el año de copyright y [name of copyright owner] por el nombre del titular de los derechos de autor.

Añadir categorías a template.tpl

Actualiza el archivo template.tpl con una entrada categories en la sección INFO y proporciona al menos un valor de categoría de la siguiente tabla. Si hay más de una categoría adecuada, puedes proporcionar hasta tres valores de categoría, ordenados de más a menos relevante.

Nota: Los valores de la entrada categories deben tener formato de matriz.

Ejemplo:

___INFO___

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

Tabla de valores de categoría compatibles:

Categoría	Descripción
ADVERTISING	Publicidad
AFFILIATE_MARKETING	Marketing de afiliación
ANALYTICS	Analíticas
ATTRIBUTION	Atribución
CHAT	Chat
CONVERSIONS	Medición de conversiones
DATA_WAREHOUSING	Almacenamiento de datos
EMAIL_MARKETING	Marketing por correo electrónico
EXPERIMENTATION	Experimentos A/B y optimización del contenido
HEAT_MAP	Mapas de calor
LEAD_GENERATION	Generación de oportunidades de venta
MARKETING	Marketing
PERSONALIZATION	Personalización
REMARKETING	Remarketing
SALES	Ventas y CRM
SESSION_RECORDING	Registro de sesiones
SOCIAL	Redes sociales
SURVEY	Encuestas
TAG_MANAGEMENT	Sistemas de gestión de etiquetas
UTILITY	Utilidades de Google Tag Manager

metadata.yaml

El archivo metadata.yaml contiene información sobre la plantilla, incluidos los enlaces a la página principal de la organización, documentación de la plantilla e información de la versión. Cada versión se indica mediante un número de cambio, también conocido como "número SHA", que es el número de cambio asociado a la confirmación de Git. El campo changeNotes es opcional, pero se recomienda para informar a los usuarios de los cambios incluidos en la versión.

Para configurar el archivo metadata.yaml, sigue estos pasos:

1. Añade una entrada homepage. Debe ser una URL que dirija a la página principal de tu organización.
2. Añade una entrada para documentation. Debe ser una URL que dirija a la documentación de la plantilla.
3. En GitHub, busca la confirmación que incluya los cambios que quieras aplicar a la versión inicial de la plantilla y copia el número SHA. Una forma fácil de obtener el número SHA en GitHub es ir a una vista de confirmación y hacer clic en el icono del portapapeles (). Se copiará el número SHA completo en el portapapeles. Pega ese número en la entrada sha como elemento secundario del nodo versions, tal como se muestra más abajo.
4. Añade una entrada changeNotes al nodo versions para describir brevemente los cambios incluidos en la nueva versión.

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

Importante: Los elementos sha y changeNotes deben concordar a lo que se muestra en el ejemplo de código.

Nota: El valor sha debe hacer referencia al archivo template.tpl que quieres publicar. Recuerda que debes actualizar correctamente este valor con cada nueva versión.

Subir los archivos a GitHub

El siguiente paso es subir los archivos a GitHub. Crea un repositorio de GitHub con los archivos y la estructura adecuados, como se indica más arriba.

Los repositorios de plantillas deben tener los archivos * template.tpl, metadata.yaml y LICENSE a nivel de raíz del repositorio de Git. Los repositorios de Git solo deben tener un archivo template.tpl. Todos los recursos deben estar en la rama maestra del repositorio de GitHub. Los repositorios de plantillas que no sigan la estructura indicada se retirarán de la galería.

Todas las entradas de la galería de plantillas de la comunidad enlazan con la sección de problemas del repositorio de GitHub de la plantilla correspondiente para que los usuarios puedan avisarte si detectan un error. Asegúrate de que no se hayan inhabilitado los problemas del repositorio de GitHub en tu plantilla para que puedas revisar y solucionar los problemas que surjan.

Enviar la plantilla

Una vez que el repositorio de plantilla esté alojado en GitHub, podrás enviar tu plantilla a la galería de plantillas de la comunidad. Para enviar la plantilla, sigue estos pasos:

1. Inicia sesión en GitHub con una cuenta que tenga acceso al repositorio de la plantilla que quieras añadir a la galería.
2. Accede a la galería de plantillas de la comunidad en la página tagmanager.google.com/gallery.
3. Haz clic en y selecciona Enviar plantilla.
4. Introduce la URL del repositorio en el campo correspondiente y haz clic en Enviar.

Actualizar la plantilla

Una vez que hayas publicado una plantilla, podrás actualizarla cuando sea necesario. Los usuarios de la plantilla recibirán una notificación si se actualiza y tendrán la opción de actualizar la plantilla a la versión más reciente.

El archivo metadata.yaml se utiliza para determinar la versión de la plantilla que se debe utilizar en la galería. Para publicar nuevas versiones, debes añadir el número de cambio (número SHA) a la sección versions del archivo metadata.yaml.

1. Localiza la confirmación que incluye los cambios que quieres enviar y copia el número SHA. Una forma fácil de hacerlo es ir a la vista de confirmación y hacer clic en el icono del portapapeles {). Se copiará el número SHA completo en el portapapeles.
2. Añade una entrada sha al principio de la lista versions de metadata.yaml. Echa un vistazo al ejemplo que se muestra más abajo.
3. Añade changeNotes para describir brevemente los cambios incluidos en la nueva versión. Si quieres, puedes añadir comentarios de varias líneas. Consulta el ejemplo que se muestra más abajo.
4. Confirma el cambio en metadata.yaml. La actualización debería aparecer en la galería en un plazo de dos o tres días.

En este ejemplo se muestra cómo añadir información de una nueva versión, incluido el número SHA y las notas de cambio:

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.

Importante: Todas las versiones publicadas de la plantilla se deben incluir en la sección versions por orden cronológico inverso (de la más reciente a la más antigua).

Nota: No todas las confirmaciones incrementales se deben incluir como cambio de versión en la galería de plantillas de la comunidad. Por ejemplo, si haces cambios incrementales en las confirmaciones 1, 2 y 3, y la versión final es la confirmación 4, solo deberías añadir una entrada con la confirmación 4 que incluya todos los cambios de las confirmaciones 1, 2 y 3.