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 poi inviare il modello 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 verranno a conoscenza del brand della tua organizzazione.
• I tuoi clienti potranno implementare i tuoi tag in pochi minuti, non in mesi.
• Puoi pubblicare aggiornamenti dei tuoi modelli e renderli automaticamente disponibili ai tuoi clienti.

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

1. Crea il modello
2. Prepara i file di progetto
3. Carica i file su GitHub
4. Invia il modello

Crea il modello

Per iniziare, crea il modello in Google Tag Manager come un modello personalizzato. Assicurati che il modello sia stato testato a fondo, che i contenuti del modello rispettino la Guida di stile e di avere un piano o una procedura per la manutenzione e l'aggiornamento del modello in caso di necessità in futuro.

Termini di servizio

Ogni nuovo invio di modelli 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 di modelli, apri il modello per la modifica e seleziona la casella sotto la scheda Informazioni con l'etichetta "Accetto i Termini di servizio della Galleria modelli della community".

Esporta il modello

Una volta completato il modello, esporta il file del modello sul computer locale e rinomina il file 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 del modello esportato denominato template.tpl. Questo file deve essere aggiornato per aggiungere una voce categories.
2. Un metadata.yaml file.
3. Un file LICENSE. Il nome del file deve essere in 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 del modello di esempio su GitHub come modello. Copia il file LICENSE dal modello di esempio al tuo progetto per assicurarti che non ci siano errori nei contenuti e aggiorna la riga del copyright in cui è scritto "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 dalla tabella seguente. Se sono appropriate più categorie, puoi fornire fino a tre valori di categoria, ordinati dal più pertinente al meno pertinente.

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

Esempio:

___INFO___

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

Tabella dei valori di categoria supportati:

Categoria	Descrizione
ADVERTISING	Pubblicità
AFFILIATE_MARKETING	Affiliate marketing
ANALYTICS	Analytics
ATTRIBUTION	Attribuzione
CHAT	Chat
CONVERSIONS	Misurazione delle conversioni
DATA_WAREHOUSING	Data warehousing
EMAIL_MARKETING	Marketing via email
EXPERIMENTATION	Esperimenti A/B e ottimizzazione dei contenuti
HEAT_MAP	Mappe termiche
LEAD_GENERATION	Generazione di lead
MARKETING	Marketing
PERSONALIZATION	Personalizzazione
REMARKETING	Remarketing
SALES	Vendite e CRM
SESSION_RECORDING	Registrazioni delle sessioni
SOCIAL	Social
SURVEY	Sondaggi
TAG_MANAGEMENT	Sistemi di gestione dei tag
UTILITY	Utilità di Google Tag Manager

metadata.yaml

Il file metadata.yaml contiene informazioni sul modello, inclusi link alla home page dell'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 rimanda alla home page della tua organizzazione.
2. Aggiungi una voce per documentation. Deve essere un URL che rimanda alla documentazione del modello.
3. In GitHub, trova il commit che include le modifiche che 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 è andare a una visualizzazione del commit e fare clic sull'icona degli appunti (). In questo modo, l'intero numero SHA verrà copiato negli appunti. Incolla questo 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 riportato sopra.

Nota: il valore sha deve fare riferimento al file template.tpl specifico che vuoi pubblicare. Non dimenticare di aggiornare correttamente questo valore 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 dei modelli devono avere i file * template.tpl, metadata.yaml e LICENSE a livello di root del repository Git. Ogni repository Git deve avere un solo file template.tpl. Tutte le risorse devono essere nel 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 rimanderà alla sezione Problemi del repository GitHub del modello, in modo che gli utenti possano comunicarti se trovano un bug.

Importante: assicurati che l'opzione Problemi non sia stata disattivata per il repository GitHub del modello e che le notifiche via email siano attivate in modo da ricevere una notifica di eventuali problemi che si verificano durante la revisione del modello.

Invia il modello

Una volta ospitato il repository del modello su GitHub, puoi procedere all'invio del modello alla Galleria modelli della community. Per inviare il modello:

1. Assicurati di aver eseguito l'accesso a GitHub con un account che ha accesso al repository del modello 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, potresti voler fornire aggiornamenti al modello di tanto in tanto. Gli utenti del modello riceveranno una notifica se è disponibile un aggiornamento del modello 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 di cui vuoi eseguire il push e copia il numero SHA. Un modo semplice per farlo in GitHub è andare a una visualizzazione del commit e fare clic sull'icona degli appunti (). In questo modo, l'intero numero SHA verrà copiato negli appunti.
2. Aggiungi una nuova voce sha all'inizio 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 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-3 giorni.

Questo esempio mostra come aggiungere le informazioni sulla nuova versione, inclusi il numero SHA e le note sulle 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 più vecchia).

Nota: non è necessario includere ogni commit incrementale come modifica della versione nella Galleria modelli della community. Ad esempio, se apporti modifiche incrementali nei commit 1, 2 e 3 e la versione finale è il commit 4, devi avere una sola voce per il commit 4 che includa tutte le modifiche dei commit 1, 2 e 3.

Sposta il repository

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

Rimuovi 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 galleria rileverà questa modifica e rimuoverà automaticamente il modello.