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 relativo repository su GitHub e inviarlo alla Galleria 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 clienti potranno implementare i tag in pochi minuti, non mesi.
  • Puoi pubblicare aggiornamenti nei tuoi modelli e renderli automaticamente disponibili per i tuoi clienti.

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

  1. Crea il tuo modello
  2. Preparare i file di progetto
  3. Caricare 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 dettagliato, che i relativi contenuti siano conformi alla Guida di stile e di disporre di un piano o di un processo 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 relativi al tuo 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 nella scheda Informazioni con l'etichetta "Accetta i Termini di servizio della Galleria modelli della community".

Esporta il modello

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

Prepara i file di progetto

Il passaggio successivo consiste nel preparare il 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 TUTTO MAIUSCOLO e il contenuto del file di licenza deve essere soltanto su Apache 2.0.
  4. (Facoltativo, ma consigliato) Aggiungi un file README.md.

Aggiungi categorie a template.tpl

Aggiorna il file template.tpl con una voce categories per la sezione INFO e fornisci almeno un valore di categoria pertinente selezionato dalla tabella seguente. Se è appropriata più di una categoria, puoi fornire 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 Affiliate marketing
ANALYTICS Analisi
ATTRIBUZIONE Attribuzione
CHAT Chat
OTTIMIZZATE Misurazione delle conversioni
DATA_WAREHOUSING Data warehousing
EMAIL_MARKETING Email di marketing
SPERIMENTAZIONE Esperimenti A/B e ottimizzazione dei contenuti
HEAT_MAP Mappe termiche
LEAD_GENERATION Generazione di lead
MARKETING Marketing
PERSONALIZZAZIONE Personalizzazione
REMARKETING Remarketing
PROMOZIONI Vendite e CRM
SESSION_RECORDING Registrazioni delle sessioni
SOCIAL Social
SONDAGGIO Sondaggi
TAG_MANAGEMENT Sistemi di gestione tag
UTILITÀ Utilità di Google Tag Manager

metadata.yaml

Il file metadata.yaml contiene informazioni sul modello, tra cui link alla home page della tua organizzazione, documentazione relativa al modello e 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 indirizza alla documentazione del 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 è aprire una vista commit e fare clic sull'icona degli appunti (icona appunti). In questo modo, l'intero numero SHA viene copiato negli appunti. Incolla questo numero come valore per la 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.
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 avere 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 sul ramo principale del repository GitHub. Qualsiasi repository di modelli che non corrisponde a questa struttura verrà rimosso dalla galleria.

Ogni voce nella Galleria modelli della community rimanda alla sezione Problemi del repository GitHub del modello in modo che gli utenti possano avvisarti in caso di bug. Assicurati che i problemi non siano stati disabilitati 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, segui questi passaggi:

  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 repository nel campo fornito e fai clic su Invia.

Aggiorna il modello

Dopo aver pubblicato un modello, di tanto in tanto ti consigliamo di aggiornarlo. Gli utenti del modello riceveranno una notifica in caso di aggiornamento e avranno la possibilità di aggiornare il modello alla versione più recente.

Il file metadata.yaml viene utilizzato per determinare quale versione del modello utilizzare nella galleria. Per pubblicare nuove versioni, devi aggiungere il numero di 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: aprire una vista commit e fare clic sull'icona degli appunti (icona appunti). In questo modo, l'intero numero SHA viene copiato negli appunti.
  2. Aggiungi una nuova voce sha in cima al tuo 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.