I tag associati al contenitore. I tag sono generalmente associati a una o più regole di attivazione (vedi firingRuleId
di seguito) e, facoltativamente, a una o più regole di blocco (vedi blockingRuleId
di seguito). Quando almeno una regola di attivazione ha valore true e esattamente zero regole di blocco hanno valore true, il tag si attiva (esecuzione). Utilizza la proprietà facoltativa priority
per modificare i tag che vengono attivati prima di altri. Utilizza la proprietà dependencies
per specificare quali altri tag devono essere attivati e completati prima dell'attivazione di questo tag. Per informazioni dettagliate sui parametri che possono essere impostati per i tag di Google Tag Manager, consulta la documentazione di riferimento sul dizionario dei tag.
Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.
Rappresentazioni delle risorse
Rappresenta un tag di Google Tag Manager.
{ "accountId": string, "containerId": string, "tagId": string, "name": string, "type": string, "firingRuleId": [ string ], "blockingRuleId": [ string ], "firingTriggerId": [ string ], "blockingTriggerId": [ string ], "liveOnly": boolean, "priority": { "type": string, "key": string, "value": string, "list": [ (Parameter) ], "map": [ (Parameter) ] }, "notes": string, "scheduleStartMs": long, "scheduleEndMs": long, "parameter": [ { "type": string, "key": string, "value": string, "list": [ (Parameter) ], "map": [ (Parameter) ] } ], "fingerprint": string, "setupTag": [ { "tagName": string, "stopOnSetupFailure": boolean } ], "teardownTag": [ { "tagName": string, "stopTeardownOnFailure": boolean } ], "parentFolderId": string, "tagFiringOption": string, "paused": boolean }
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
accountId |
string |
ID account GTM. | |
blockingRuleId[] |
list |
ID regole di blocco. Se una delle regole elencate restituisce true, il tag non si attiverà. | scrivibile |
blockingTriggerId[] |
list |
ID trigger di blocco. Se uno degli attivatori elencati restituisce true, il tag non si attiverà. | scrivibile |
containerId |
string |
ID contenitore GTM. | |
fingerprint |
string |
L'impronta del tag GTM calcolata al momento dell'archiviazione. Questo valore viene ricalcolato ogni volta che il tag viene modificato. | |
firingRuleId[] |
list |
ID delle regole di attivazione. Un tag si attiva quando una qualsiasi delle regole elencate è vera e tutte le sue blockingRuleIds (se specificate) sono false. |
scrivibile |
firingTriggerId[] |
list |
ID degli attivatori di attivazione. Un tag si attiva quando uno degli attivatori elencati è true e tutti i relativi blockingTriggerIds (se specificati) sono falso. |
scrivibile |
liveOnly |
boolean |
Se è impostato su true, questo tag si attiverà solo nell'ambiente di pubblicazione (ad es. non in modalità di anteprima o debug). | scrivibile |
name |
string |
Nome visualizzato del tag. | scrivibile |
notes |
string |
Note dell'utente su come applicare questo tag nel contenitore. | scrivibile |
parameter[] |
list |
I parametri del tag. | scrivibile |
parameter[].key |
string |
La chiave denominata che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello e per i valori della mappa. Ignorato per i valori dell'elenco. | scrivibile |
parameter[].list[] |
list |
Parametri di questo parametro elenco (le chiavi verranno ignorate). | scrivibile |
parameter[].map[] |
list |
I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). | scrivibile |
parameter[].type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
parameter[].value |
string |
Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. | scrivibile |
parentFolderId |
string |
ID cartella principale. | |
paused |
boolean |
True se il tag è in pausa. | scrivibile |
priority |
nested object |
Priorità numerica del tag definita dall'utente. I tag vengono attivati in modo asincrono in ordine di priorità. I tag con un valore numerico più alto vengono attivati per primi. La priorità di un tag può essere un valore positivo o negativo. Il valore predefinito è 0. | scrivibile |
priority.key |
string |
La chiave denominata che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello e per i valori della mappa. Ignorato per i valori dell'elenco. | scrivibile |
priority.list[] |
list |
Parametri di questo parametro elenco (le chiavi verranno ignorate). | scrivibile |
priority.map[] |
list |
I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). | scrivibile |
priority.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
priority.value |
string |
Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. | scrivibile |
scheduleEndMs |
long |
Il timestamp di fine in millisecondi per pianificare un tag. | scrivibile |
scheduleStartMs |
long |
Il timestamp di inizio in millisecondi per pianificare un tag. | scrivibile |
setupTag[] |
list |
L'elenco dei tag di configurazione. Al momento consentiamo solo uno. | |
setupTag[].stopOnSetupFailure |
boolean |
Se il valore è true, attiva il tag principale solo se il tag di configurazione si attiva correttamente. Se il valore è false, attiva il tag principale indipendentemente dallo stato di attivazione del tag di impostazione. | |
setupTag[].tagName |
string |
Il nome del tag di impostazione. | |
tagFiringOption |
string |
Opzione per attivare questo tag.
I valori accettati sono:
|
|
tagId |
string |
L'ID tag identifica in modo univoco il tag GTM. | |
teardownTag[] |
list |
L'elenco dei tag di disinstallazione. Al momento consentiamo solo uno. | |
teardownTag[].stopTeardownOnFailure |
boolean |
Se true, attiva il tag di disinstallazione solo se e solo se il tag principale si attiva correttamente. Se il valore è false, attiva il tag di eliminazione indipendentemente dallo stato di attivazione del tag principale. | |
teardownTag[].tagName |
string |
Il nome del tag di disinstallazione. | |
type |
string |
Tipo di tag GTM. | scrivibile |
Metodi
Utilizza i metodi riportati di seguito per creare, modificare, eliminare o recuperare i tag.
- creazione
- Crea un tag GTM.
- elimina
- Elimina un tag GTM.
- ricevi
- Ottene un tag GTM.
- list
- Elenca tutti i tag GTM di un contenitore.
- aggiornamento
- Aggiorna un tag GTM.