Inviare un modello alla Galleria modelli della community

La Galleria modelli della community di Google Tag Manager consente alla tua organizzazione di creare e gestire modelli di tag e variabili che si integrano in modo nativo con Google Tag Manager. La tua organizzazione può creare un modello, pubblicare il repository del modello su GitHub e inviarlo alla galleria di modelli della community per renderlo disponibile agli utenti di tutto il mondo. I vantaggi per la tua organizzazione includono:

  • I tuoi clienti potranno aggiungere e utilizzare facilmente i tuoi modelli.
  • Gli utenti di Tag Manager saranno esposti al brand della tua organizzazione.
  • I tuoi clienti saranno in grado di implementare i tuoi tag in pochi minuti, non mesi.
  • Puoi pubblicare aggiornamenti dei modelli e renderli disponibili automaticamente per i tuoi clienti.

La procedura per inviare un nuovo modello alla Galleria modelli della community prevede i seguenti passaggi principali:

  1. Creare il modello
  2. Preparare i file di progetto
  3. Carica i file su GitHub
  4. Inviare il modello

Crea il tuo modello

Per iniziare, crea il tuo modello in Google Tag Manager come modello personalizzato. Assicurati che il modello sia stato testato in modo approfondito, che i relativi contenuti rispettino la Guida di stile e di disporre di un piano o di una procedura per gestire e aggiornare il modello qualora fosse necessario farlo in futuro.

Termini di servizio

Ogni nuovo modello inviato deve accettare i Termini di servizio della Galleria modelli della community di Google Tag Manager. Per confermare l'accettazione dei Termini di servizio per il modello:

  1. Leggi i Termini di servizio della Galleria modelli della community di Google Tag Manager.
  2. Nell'Editor dei modelli, apri il modello da modificare e seleziona la casella "Accetta i Termini di servizio della Galleria modelli della community" nella scheda Informazioni.

Esporta il modello

Una volta completato il modello, esporta il file del modello nel tuo computer locale e rinomina il file template.tpl.

Prepara i file di progetto

Il passaggio successivo prevede la preparazione del repository per la pubblicazione su GitHub. Ogni repository deve contenere i seguenti file:

  1. Un file modello esportato denominato template.tpl. Questo file deve essere aggiornato per aggiungere una voce categories.
  2. Un file metadata.yaml.
  3. Un file LICENSE. Il nome del file deve essere COMPLETAMENTE IN MAIUSCOLO e i contenuti del file di licenza devono essere solo Apache 2.0.
  4. Aggiungi un file README.md (facoltativo, ma consigliato).
di Gemini Advanced.

Aggiungi categorie a template.tpl

Aggiorna il file template.tpl con una voce categories nella sezione INFO e fornisci almeno un valore di categoria pertinente selezionato dalla seguente tabella. Se sono appropriate più categorie, puoi specificare fino a tre valori di categoria, ordinati dal più pertinente al meno pertinente.

Esempio:

___INFO___

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

Tabella dei valori delle categorie supportate:

Categoria Descrizione
PUBBLICITÀ Pubblicità
AFFILIATE_MARKETING Marketing di affiliazione
ANALYTICS Analytics
ATTRIBUZIONE Attribuzione
CHAT Chat
CONVERSIONI Misurazione delle conversioni
DATA_WAREHOUSING Data warehousing
EMAIL_MARKETING Marketing via email
SPERIMENTAZIONE Esperimenti A/B e ottimizzazione dei contenuti
HEAT_MAP Mappe termiche
LEAD_GENERATION Generazione di lead
MARKETING Marketing
PERSONALIZZAZIONE Personalizzazione
REMARKETING Remarketing
VENDITE Vendite e CRM
SESSION_RECORDING Registrazioni della sessione
SOCIAL Social
SURVEY Sondaggi
TAG_MANAGEMENT Sistemi di gestione tag
UTILITÀ Utilità di Google Tag Manager

metadata.yaml

Il file metadata.yaml contiene informazioni sul modello, inclusi i link alla home page dell'organizzazione, alla documentazione del modello e alle informazioni sulla versione. Ogni versione è indicata da un numero di modifica, chiamato anche numero SHA, che è il numero di modifica associato al commit Git. Il campo changeNotes è facoltativo, ma consigliato, per informare gli utenti delle modifiche incluse nella versione.

Per configurare il file metadata.yaml:

  1. Aggiungi una voce homepage. Deve essere un URL che indirizza alla home page della tua organizzazione.
  2. Aggiungi una voce per documentation. Deve essere un URL che rimanda alla documentazione per il tuo modello.
  3. In GitHub, trova il commit che include le modifiche di cui vuoi eseguire il push per la versione iniziale del modello e copia il numero SHA. Un modo semplice per ottenere il numero SHA in GitHub è passare a una visualizzazione commit e fare clic sull'icona degli appunti (icona appunti). L'intero numero SHA verrà copiato negli appunti. Incolla questo numero come valore della voce sha come elemento secondario del nodo versions, come mostrato di seguito.
  4. Aggiungi una voce changeNotes al nodo versions per descrivere brevemente le modifiche contenute in questa nuova versione.
di Gemini Advanced. 
homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

Carica su GitHub

Il passaggio successivo consiste nel caricare i file su GitHub. Crea un repository GitHub con i file e la struttura appropriati come descritto sopra.

I repository di modelli devono contenere i file * template.tpl, metadata.yaml e LICENSE che si trovano al livello principale del repository Git. Ogni repository Git deve avere un solo file template.tpl. Tutte le risorse devono trovarsi nel ramo principale del tuo repository GitHub. Qualsiasi repository di modelli che non corrisponde a questa struttura verrà rimosso dalla Galleria.

Ogni voce nella Galleria modelli della community contiene un link alla sezione Problemi del repository GitHub del modello, in modo che gli utenti possano farti sapere se trovano un bug. Assicurati che non siano stati disabilitati problemi per il repository GitHub del tuo modello, in modo da poter esaminare e risolvere eventuali problemi.

Invia il modello

Una volta che il repository dei modelli è ospitato su GitHub, puoi procedere con l'invio del modello alla Galleria modelli della community. Per inviare il modello, procedi nel seguente modo:

  1. Assicurati di aver eseguito l'accesso a GitHub con un account che abbia accesso al repository di modelli che vuoi aggiungere alla galleria.
  2. Vai alla Galleria modelli della community all'indirizzo tagmanager.google.com/gallery.
  3. Fai clic su e seleziona Invia modello.
  4. Fornisci l'URL del repository nel campo fornito e fai clic su Invia.

Aggiorna il modello

Dopo aver pubblicato un modello, puoi di tanto in tanto fornire aggiornamenti. Gli utenti verranno avvisati in caso di aggiornamento del modello e avranno la possibilità di aggiornarlo alla versione più recente.

Il file metadata.yaml viene utilizzato per determinare quale versione del modello usare nella galleria. Per pubblicare nuove versioni, devi aggiungere il numero della modifica (numero SHA) alla sezione versions del file metadata.yaml.

  1. Individua il commit che include le modifiche di cui vuoi eseguire il push e copia il numero SHA. Un modo semplice per farlo è in GitHub è andare su una vista commit e fare clic sull'icona degli appunti (icona appunti). L'intero numero SHA verrà copiato negli appunti.
  2. Aggiungi una nuova voce sha in cima all'elenco versions in metadata.yaml. (vedi l'esempio di seguito).
  3. Aggiungi changeNotes per descrivere brevemente le modifiche contenute in questa nuova versione. Se vuoi, puoi creare commenti su più righe. (vedi l'esempio di seguito).
  4. Esegui il commit della modifica in metadata.yaml e l'aggiornamento verrà visualizzato nella galleria in genere entro 2 o 3 giorni.

Questo esempio mostra come aggiungere informazioni sulla nuova versione, tra cui il numero SHA e le note di modifica:

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.