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

La galería de plantillas de la comunidad de Google Tag Manager le permite a su organización crear y administrar etiquetas y plantillas variables que se integran de forma nativa con Google Tag Manager. Su organización puede crear una plantilla, publicar el repositorio de plantillas en GitHub y luego enviar su plantilla a la Galería de plantillas de la comunidad para que esté disponible para los usuarios de todo el mundo. Los beneficios para su organización incluyen:

• Sus clientes podrán agregar y usar sus plantillas fácilmente.
• Los usuarios de Tag Manager estarán expuestos a la marca de su organización.
• Sus clientes podrán implementar sus etiquetas en cuestión de minutos, no meses.
• Puede publicar actualizaciones en sus plantillas y hacer que esas actualizaciones estén automáticamente disponibles para sus clientes.

El proceso para enviar una nueva plantilla a la Galería de plantillas de la comunidad implica estos pasos principales:

1. Crea tu plantilla
2. Prepare sus archivos de proyecto
3. Sube tus archivos a GitHub
4. Envía tu plantilla

Crea tu plantilla

Para comenzar, cree su plantilla en Google Tag Manager como una plantilla personalizada . Asegúrese de que su plantilla se haya probado exhaustivamente, que el contenido de su plantilla siga la Guía de estilo y que tenga un plan o proceso implementado sobre cómo mantener y actualizar su plantilla en caso de que surja la necesidad de hacerlo en el futuro.

Términos de servicio

Cada nuevo envío de plantilla debe aceptar las Condiciones de servicio de la Galería de plantillas de la comunidad de Google Tag Manager. Para confirmar la aceptación de los Términos de servicio de su plantilla:

1. Lea las Condiciones de servicio de la galería de plantillas de la comunidad de Google Tag Manager .
2. En el Editor de plantillas, abra su plantilla para editarla y marque la casilla debajo de la pestaña Información con la etiqueta "Acepto los Términos de servicio de la Galería de plantillas de la comunidad" .

Exporta tu plantilla

Una vez que su plantilla esté completa, exporte el archivo de plantilla a su máquina local y cambie el nombre del archivo template.tpl .

Prepare sus archivos de proyecto

El siguiente paso es preparar su repositorio para publicar en GitHub. Cada repositorio debe contener los siguientes archivos:

1. Un archivo de plantilla exportado denominado template.tpl . Este archivo debe actualizarse para agregar 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. Agregue un archivo README.md (opcional, pero recomendado).

Nota: Use el repositorio de plantillas de muestra en GitHub como modelo. Copie el archivo LICENSE de la plantilla de muestra a su proyecto para estar absolutamente seguro de que no hay errores en el contenido, y asegúrese de actualizar la línea de Copyright donde dice " Copyright [yyyy] [name of copyright owner] " en la versión de muestra. Reemplace yyyy con el año de los derechos de autor y [name of copyright owner] con el nombre del propietario de los derechos de autor.

Agregar categorías a template.tpl

Actualice su archivo template.tpl con una entrada categories en la sección INFO y proporcione al menos un valor de categoría relevante seleccionado de la siguiente tabla. Si es adecuada más de una categoría, puede proporcionar hasta tres valores de categoría, ordenados del más relevante al menos relevante.

Nota: Los valores para la entrada categories deben formatearse como una matriz.

Ejemplo:

___INFO___

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

Tabla de valores de categoría admitidos:

Categoría	Descripción
PUBLICIDAD	Publicidad
LA COMERCIALIZACIÓN DEL AFILIADO	La comercialización del afiliado
ANALÍTICA	Analítica
ATRIBUCIÓN	Atribución
CHARLAR	Charlar
CONVERSIONES	Medida de conversión
ALMACENAMIENTO DE DATOS	Almacenamiento de datos
CORREO DE PROPAGANDA	Correo de propaganda
EXPERIMENTACIÓN	Experimentos A/B y optimización de contenidos
MAPA DE CALOR	mapas de calor
GENERACIÓN LÍDER	Generación líder
MARKETING	Marketing
PERSONALIZACIÓN	Personalización
REMARKETING	Remarketing
VENTAS	Ventas y CRM
SESIÓN_GRABACIÓN	Grabaciones de sesiones
SOCIAL	Social
ENCUESTA	Encuestas
TAG_GESTIÓN	Sistemas de gestión de etiquetas
UTILIDAD	Utilidades del administrador de etiquetas de Google

metadatos.yaml

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

Para configurar su archivo metadata.yaml :

1. Agregue una homepage de entrada. Esta debe ser una URL que apunte a la página de inicio de su organización.
2. Agregue una entrada para documentation . Esta debe ser una URL que apunte a la documentación de su plantilla.
3. En GitHub, busque la confirmación que incluye los cambios que desea impulsar para su versión inicial de su plantilla y copie el número SHA. Una manera 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 ( ). Esto copiará el número SHA completo en su portapapeles. Pegue ese número como el valor de su entrada sha como elemento secundario del nodo versions , como se muestra a continuación.
4. Agregue una entrada changeNotes al nodo versions para describir brevemente los cambios contenidos en esta nueva versión.

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

Importante: sha y changeNotes deben estar alineados como se muestra en el ejemplo de código anterior.

Nota: El valor sha debe hacer referencia al archivo template.tpl específico que desea publicar. ¡No olvide actualizar este valor correctamente con cada nueva versión !

Subir a GitHub

El siguiente paso es subir sus archivos a GitHub. Cree un repositorio de GitHub con los archivos y la estructura adecuados, como se describe anteriormente .

Los repositorios de plantillas deben tener los archivos * template.tpl , metadata.yaml y LICENSE en el nivel raíz del repositorio de Git. Cada repositorio de Git solo debe tener un archivo template.tpl . Todos los recursos deben estar en la rama principal de su repositorio de GitHub. Cualquier repositorio de plantillas que no coincida con esta estructura se eliminará de la Galería.

Cada entrada en la Galería de plantillas de la comunidad se vinculará a la sección Problemas del repositorio de GitHub de la plantilla para que los usuarios puedan informarle si encuentran un error. Asegúrese de que los problemas no se hayan deshabilitado para el repositorio de GitHub de su plantilla para que pueda revisar y abordar cualquier problema que surja.

Envía tu plantilla

Una vez que su repositorio de plantillas esté alojado en GitHub, puede proceder a enviar su plantilla a la Galería de plantillas de la comunidad. Para enviar su plantilla, siga estos pasos:

1. Asegúrese de haber iniciado sesión en GitHub con una cuenta que tenga acceso al repositorio de plantillas que desea agregar a la Galería.
2. Vaya a la Galería de plantillas de la comunidad en tagmanager.google.com/gallery .
3. Haga clic en y seleccione Enviar plantilla .
4. Proporcione la URL del repositorio en el campo provisto y haga clic en Enviar .

Actualiza tu plantilla

Después de haber publicado una plantilla, es posible que desee proporcionar actualizaciones a su plantilla de vez en cuando. Los usuarios de su plantilla serán notificados si hay una actualización de la plantilla y tendrán la opción de actualizar la plantilla a la última versión .

El archivo metadata.yaml se usa para determinar qué versión de su plantilla usar en la galería. Para publicar nuevas versiones, debe agregar el número de cambio (número SHA) a la sección versions de su archivo metadata.yaml .

1. Busque la confirmación que incluye los cambios que desea enviar y copie el número SHA. Una forma sencilla de hacerlo en GitHub es ir a una vista de confirmación y hacer clic en el icono del portapapeles ( ). Esto copiará el número SHA completo en su portapapeles.
2. Agrega una nueva entrada sha en la parte superior de tu lista versions en metadata.yaml . (Vea el ejemplo a continuación).
3. Agregue changeNotes para describir brevemente los cambios contenidos en esta nueva versión. Puede crear comentarios de varias líneas, si lo desea. (Vea el ejemplo a continuación).
4. Confirme el cambio en metadata.yaml y su actualización aparecerá en la galería normalmente dentro de 2 a 3 días.

Este ejemplo demuestra cómo agregar información de la 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: Cada versión publicada de la plantilla debe incluirse en la sección versions ordenadas en orden cronológico inverso (de la más reciente a la más antigua).

Nota: No es necesario incluir todas las confirmaciones incrementales como un cambio de versión en la Galería de plantillas de la comunidad. Por ejemplo, si realiza cambios incrementales en las confirmaciones 1, 2 y 3, y la versión final es la confirmación 4, debe tener solo una entrada para la confirmación 4 que incluya todos los cambios de las confirmaciones 1, 2 y 3.