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 dei modelli su GitHub e poi 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 tuoi clienti potranno implementare i tag in pochi minuti, non mesi.
- Puoi pubblicare aggiornamenti nei tuoi modelli e renderli automaticamente disponibili per i clienti.
La procedura di invio di un nuovo modello alla Galleria modelli della community prevede i seguenti passaggi principali:
Crea il tuo modello
Per iniziare, crea il tuo modello in Google Tag Manager come modello personalizzato. Assicurati che il modello sia stato testato accuratamente, che i contenuti del modello siano conformi alla Guida di stile e che tu abbia impostato un piano o una procedura per la manutenzione e l'aggiornamento del modello qualora fosse necessario 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 tuo modello:
- Leggi i Termini di servizio della Galleria modelli della community di Google Tag Manager.
- Nell'Editor modelli, apri il modello per modificarlo e seleziona la casella nella scheda Informazioni con l'etichetta "Accetta i Termini di servizio della Galleria modelli della community".
Esportare il modello
Una volta completato il modello, esporta il file del modello sulla macchina locale e rinominalo template.tpl
.
Prepara i file del progetto
Il passaggio successivo è preparare il repository per la pubblicazione su GitHub. Ogni repository deve contenere i seguenti file:
- Un file modello esportato denominato
template.tpl
. Questo file deve essere aggiornato per aggiungere una voce dicategories
. - Un file
metadata.yaml
. - Un file
LICENSE
. Il nome del file deve essere TUTTO MAIUSCOLO e i contenuti del file di licenza devono essere solo Apache 2.0. - Aggiungi un file
README.md
(facoltativo, ma consigliato).
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 nella tabella seguente. Se sono appropriate più categorie, puoi specificare fino a tre valori, ordinati dal più pertinente al meno pertinente.
Esempio:
___INFO___
{
"displayName": "Example Template",
"categories": ["AFFILIATE_MARKETING", "ADVERTISING"],
// additional template properties, etc...
}
Tabella dei valori di categoria supportati:
Categoria | Descrizione |
---|---|
PUBBLICITÀ | Pubblicità |
MARKETING_AFFILIATE | Affiliate marketing |
DATI E ANALISI | Analytics per |
ATTRIBUZIONE | Attribuzione |
CHAT | Chatta |
OTTIMIZZATE | Misurazione delle conversioni |
DATA_WAREHOUSING | Data warehousing |
EMAIL_MARKETING | Email di marketing |
SPERIMENTAZIONE | Esperimenti A/B e ottimizzazione dei contenuti |
Mappa termica | Mappe termiche |
GENERAZIONE DI LEAD | Generazione di lead |
MARKETING | Marketing |
PERSONALIZZAZIONE | Personalizzazione |
REMARKETING | Remarketing |
PROMOZIONI | Vendite e CRM |
SESSION_RECORDING | Registrazioni delle sessioni |
SOCIAL | Social |
SONDAGGIO | Sondaggi |
TAG_GESTIONE | Sistemi di gestione tag |
UTILITÀ | Utilità di Google Tag Manager |
metadata.yaml
Il file metadata.yaml
contiene informazioni sul tuo modello, inclusi i link alla home page della tua organizzazione, la documentazione dei modelli e le informazioni sulla versione. Ogni versione è indicata da un numero di modifica, noto anche come 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
:
- Aggiungi una voce
homepage
. Deve essere un URL che rimanda alla home page della tua organizzazione. - Aggiungi una voce per
documentation
. Deve essere un URL che indirizza alla documentazione per il tuo modello. - In GitHub, individua 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 recuperare il numero SHA in GitHub è andare a una vista commit e fare clic sull'icona degli appunti (). In questo modo verrà copiato l'intero numero SHA negli appunti. Incolla questo numero come valore per la tua voce
sha
come figlio del nodoversions
, come mostrato di seguito. - Aggiungi una voce
changeNotes
al nodoversions
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
a livello della directory principale del repository Git. Ogni repository Git deve avere un solo file template.tpl
. Tutte le risorse devono essere nel ramo principale nel tuo repository GitHub. Eventuali repository di modelli che non corrispondono a questa struttura verranno rimossi dalla galleria.
Ogni voce nella Galleria modelli della community sarà collegata alla sezione Problemi del repository GitHub del modello, in modo che gli utenti possano comunicarti se trovano un bug. Assicurati che i problemi relativi al repository GitHub del modello non siano stati disattivati, in modo da poter esaminare e risolvere eventuali problemi.
Inviare il modello
Dopo aver ospitato il repository dei modelli su GitHub, puoi procedere con l'invio del modello alla Galleria modelli della community. Per inviare il tuo modello:
- Assicurati di aver eseguito l'accesso a GitHub con un account che abbia accesso al repository dei modelli che vuoi aggiungere alla galleria.
- Vai alla Galleria modelli della community all'indirizzo tagmanager.google.com/gallery.
- Fai clic su more_vert e seleziona Invia modello.
- Specifica l'URL del repository nell'apposito campo e fai clic su Invia.
Aggiorna il tuo modello
Dopo aver pubblicato un modello, potresti voler aggiornarlo di tanto in tanto. Gli utenti del modello riceveranno una notifica se viene aggiornato il modello e potranno aggiornarlo alla versione più recente.
Il file metadata.yaml
viene utilizzato per determinare quale versione del modello utilizzare per la galleria. Per pubblicare nuove versioni, devi aggiungere il numero di modifica (numero SHA) alla sezione versions
del tuo file metadata.yaml
.
- Individua il commit che include le modifiche di cui vuoi eseguire il push e copia il numero SHA. Un modo semplice per farlo è eseguire GitHub in una visualizzazione commit e fare clic sull'icona degli appunti (). In questo modo, copierai l'intero numero SHA negli appunti.
- Aggiungi una nuova voce
sha
all'inizio dell'elencoversions
inmetadata.yaml
. Vedi l'esempio riportato di seguito. - Aggiungi
changeNotes
per descrivere brevemente le modifiche contenute in questa nuova versione. Se vuoi, puoi creare commenti su più righe. Vedi l'esempio riportato di seguito. - Se confermi la modifica, il tuo aggiornamento
metadata.yaml
verrà visualizzato nella galleria entro due o tre giorni.
Questo esempio mostra come aggiungere informazioni sulla nuova versione, inclusi 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.