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 potranno implementare i tag in pochi minuti, non in mesi.
• Puoi pubblicare aggiornamenti ai tuoi 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 del progetto
3. Carica i file su GitHub
4. Inviare il modello

Creare il modello

Per iniziare, crea il modello in Google Tag Manager come modello personalizzato. Assicurati che il modello sia stato testato a fondo, che i contenuti del modello rispettino la guida di stile e che tu abbia un piano o una procedura per la gestione e l'aggiornamento del modello nel caso in cui in futuro si rendesse necessario.

Termini di servizio

Ogni nuovo modello inviato deve rispettare 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. In Editor dei modelli, apri il modello per la modifica e seleziona la casella nella scheda Informazioni etichettata "Accetto i Termini di servizio della Galleria modelli della community".

Esportare il modello

Una volta completato il modello, esporta il file del modello sulla tua macchina locale e rinominalo template.tpl.

Preparare 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 in MAIUSCOLO e i contenuti del file della licenza devono essere solo Apache 2.0.
4. Aggiungi un file README.md (facoltativo, ma consigliato).

Nota: utilizza il repository di modelli di esempio su GitHub come modello. Copia il file LICENSE dal modello di esempio al tuo progetto per assicurarti che non siano presenti errori nei contenuti e aggiorna la riga del copyright dove è presente il testo "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.

Aggiungere 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 tabella seguente. Se è appropriata più di una categoria, puoi fornire fino a tre valori di categoria, ordinati dalla più pertinente alla 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 delle categorie supportati:

Categoria	Descrizione
PUBBLICITÀ	Pubblicità
AFFILIATE_MARKETING	Affiliate marketing
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 delle sessioni
SOCIAL	Social
SONDAGGIO	Sondaggi
TAG_MANAGEMENT	Sistemi di gestione dei tag
UTILITÀ	Utilità di Google Tag Manager

metadata.yaml

Il file metadata.yaml contiene informazioni sul modello, inclusi link alla home page della tua organizzazione, alla documentazione del modello e alle 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 rimandi alla home page della tua organizzazione.
2. Aggiungi una voce per documentation. Deve essere un URL che rimandi alla documentazione del modello.
3. In GitHub, trova il commit che include le modifiche che vuoi inviare per la versione iniziale del modello e copia il numero SHA. Un modo semplice per ottenere il numero SHA in GitHub è andare a una visualizzazione dei commit e fare clic sull'icona degli appunti (). In questo modo, l'intero numero SHA verrà copiato negli appunti. Incolla il numero come valore per la voce sha come elemento 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 mostrato nell'esempio di codice precedente.

Nota: il valore sha deve fare riferimento al file template.tpl specifico che vuoi pubblicare. Non dimenticare di aggiornare questo valore correttamente con 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 contenere i file * template.tpl, metadata.yaml e LICENSE a livello di radice del repository Git. Ogni repository Git deve avere un solo file template.tpl. Tutte le risorse devono trovarsi nel branch principale del tuo repository GitHub. Qualsiasi repository di modelli che non corrisponde a questa struttura verrà rimosso dalla Galleria.

Ogni voce della Galleria di modelli della community rimanda alla sezione Issues del repository GitHub del modello, in modo che gli utenti possano comunicarti se trovano un bug. Assicurati che i problemi non siano stati disattivati per il repository GitHub del tuo modello, in modo da poterli esaminare e risolvere.

Inviare il modello

Una volta che il repository del modello è ospitato su GitHub, puoi procedere inviando il modello alla galleria modelli della community. Per inviare il modello:

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 nell'apposito campo e fai clic su Invia.

Aggiornare il modello

Dopo aver pubblicato un modello, potresti volerlo aggiornare di tanto in tanto. Gli utenti del modello riceveranno una notifica in caso di aggiornamento e avranno la possibilità di aggiornare il modello all'ultima versione.

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 che vuoi inviare e copia il numero SHA. Un modo semplice per farlo è andare a una visualizzazione dei commit su GitHub e fare clic sull'icona della clipboard (). In questo modo, l'intero numero SHA verrà copiato nella clipboard.
2. Aggiungi una nuova voce sha nella parte superiore dell'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 multilinea. (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-3 giorni.

Questo esempio mostra come aggiungere nuove informazioni sulla versione, tra cui il numero SHA e le note relative alle modifiche:

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 in ordine cronologico inverso (dalla più recente alla meno recente).

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

Spostare il repository

Se vuoi modificare i proprietari o i nomi dei repository, puoi utilizzare la procedura di trasferimento del repository GitHub. La nuova posizione verrà rilevata e gli utenti verranno reindirizzati automaticamente al nuovo repository al successivo aggiornamento del modello.

Rimuovere il modello

Per rimuovere un modello dalla galleria, elimina il file LICENSE o il file metadata.yaml dal relativo repository. Il sistema di monitoraggio della galleriarileverà questa modifica e rimuoverà automaticamente il modello.