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 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:

1. Creare il modello
2. Prepara i file del 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 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:

1. Leggi i Termini di servizio della Galleria modelli della community di Google Tag Manager.
2. 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:

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

Nota: utilizza il repository modello di esempio su GitHub come modello. Copia il file LICENSE dal modello di esempio nel tuo progetto per assicurarti che non ci siano errori nei contenuti e assicurati che la riga del copyright indichi "Copyright [yyyy] [name of copyright owner]" nella versione di esempio. Sostituisci yyyy con l'anno del copyright e [name of copyright owner] con il nome del titolare del copyright.

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.

Nota: i valori per la voce categories devono essere formattati come array.

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:

1. Aggiungi una voce homepage. Deve essere un URL che rimanda alla home page della tua organizzazione.
2. Aggiungi una voce per documentation. Deve essere un URL che indirizza alla documentazione per il tuo modello.
3. 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 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.

Importante: sha e changeNotes devono essere allineati come nell'esempio di codice riportato sopra.

Nota: il valore sha deve fare riferimento al file modello.tpl specifico che vuoi pubblicare. Non dimenticare di aggiornare correttamente questo valore in ogni nuova versione.

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:

1. Assicurati di aver eseguito l'accesso a GitHub con un account che abbia accesso al repository dei 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. 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.

1. 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.
2. Aggiungi una nuova voce sha all'inizio dell'elenco versions in metadata.yaml. Vedi l'esempio riportato 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 riportato di seguito.
4. 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.

Importante: ogni versione pubblicata del modello deve essere inclusa nella sezione versions ordinata in ordine cronologico inverso (dalla più recente alla meno recente).

Nota: non tutti i commit incrementali devono essere inclusi come versione della Galleria modelli. Ad esempio, se apporti modifiche incrementali nei commit 1, 2 e 3 e la versione finale è commit 4, dovresti avere una sola voce per il commit 4 che include tutte le modifiche dei commit 1, 2 e 3.