Crea un tag GTM. Prova subito.
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/tagmanager/v2/+parent/tags
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri percorso | ||
parent |
string |
Percorso relativo dell'API di GTM Workspace. Esempio: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id} |
Autorizzazione
Questa richiesta richiede l'autorizzazione con il seguente ambito:
Ambito |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.
Corpo della richiesta
Nel corpo della richiesta, fornisci una risorsa Tag con le seguenti proprietà:
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
Proprietà obbligatorie | |||
consentSettings.consentType.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
accessibile in scrittura |
monitoringMetadata.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
accessibile in scrittura |
name |
string |
Nome visualizzato del tag. | accessibile in scrittura |
parameter[].type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
accessibile in scrittura |
priority.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
accessibile in scrittura |
type |
string |
Tipo di tag GTM. | accessibile in scrittura |
Proprietà facoltative | |||
blockingRuleId[] |
list |
ID regole di blocco. Se una qualsiasi delle regole elencate restituisce true, il tag non si attiva. | accessibile in scrittura |
blockingTriggerId[] |
list |
Blocco degli ID trigger. Se uno degli attivatori elencati restituisce true, il tag non si attiva. | accessibile in scrittura |
consentSettings |
nested object |
Impostazioni relative al consenso di un tag. | accessibile in scrittura |
consentSettings.consentType.key |
string |
La chiave con nome che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello, così come per i valori della mappa. Ignorato per i valori dell'elenco. | accessibile in scrittura |
consentSettings.consentType.list[] |
list |
Parametri di questo elenco (le chiavi verranno ignorate). | accessibile in scrittura |
consentSettings.consentType.map[] |
list |
I parametri di questo parametro della mappa (devono avere chiavi; le chiavi devono essere univoche). | accessibile in scrittura |
consentSettings.consentType.value |
string |
Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. | accessibile in scrittura |
firingRuleId[] |
list |
ID regole di attivazione. Un tag viene attivato quando una qualsiasi delle regole elencate è vera e tutti i suoi blockingRuleIds (se specificati) sono false. |
accessibile in scrittura |
firingTriggerId[] |
list |
ID attivatore in corso. Un tag viene attivato quando uno qualsiasi degli attivatori elencati è vero e tutti i suoi blockingTriggerIds (se specificati) sono falsi. |
accessibile in scrittura |
liveOnly |
boolean |
Se impostato su true, questo tag si attiva solo nell'ambiente di pubblicazione (ad es. non in modalità di anteprima o debug). | accessibile in scrittura |
monitoringMetadata |
nested object |
Una mappa di coppie chiave-valore di metadati di tag da includere nei dati sull'evento per il monitoraggio dei tag. Note.
|
accessibile in scrittura |
monitoringMetadata.key |
string |
La chiave con nome che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello, così come per i valori della mappa. Ignorato per i valori dell'elenco. | accessibile in scrittura |
monitoringMetadata.list[] |
list |
Parametri di questo elenco (le chiavi verranno ignorate). | accessibile in scrittura |
monitoringMetadata.map[] |
list |
I parametri di questo parametro della mappa (devono avere chiavi; le chiavi devono essere univoche). | accessibile in scrittura |
monitoringMetadata.value |
string |
Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. | accessibile in scrittura |
monitoringMetadataTagNameKey |
string |
Se il campo non è vuoto, il nome visualizzato del tag verrà incluso nella mappa dei metadati di monitoraggio utilizzando la chiave specificata. | accessibile in scrittura |
notes |
string |
Note dell'utente su come applicare questo tag nel contenitore. | accessibile in scrittura |
parameter[] |
list |
I parametri del tag. | accessibile in scrittura |
parameter[].key |
string |
La chiave con nome che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello, così come per i valori della mappa. Ignorato per i valori dell'elenco. | accessibile in scrittura |
parameter[].list[] |
list |
Parametri di questo elenco (le chiavi verranno ignorate). | accessibile in scrittura |
parameter[].map[] |
list |
I parametri di questo parametro della mappa (devono avere chiavi; le chiavi devono essere univoche). | accessibile in scrittura |
parameter[].value |
string |
Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. | accessibile in scrittura |
paused |
boolean |
Indica se il tag è in pausa, impedendo l'attivazione. | accessibile in scrittura |
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. | accessibile in scrittura |
priority.key |
string |
La chiave con nome che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello, così come per i valori della mappa. Ignorato per i valori dell'elenco. | accessibile in scrittura |
priority.list[] |
list |
Parametri di questo elenco (le chiavi verranno ignorate). | accessibile in scrittura |
priority.map[] |
list |
I parametri di questo parametro della mappa (devono avere chiavi; le chiavi devono essere univoche). | accessibile in scrittura |
priority.value |
string |
Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. | accessibile in scrittura |
scheduleEndMs |
long |
Il timestamp di fine in millisecondi per pianificare un tag. | accessibile in scrittura |
scheduleStartMs |
long |
Il timestamp di inizio in millisecondi per pianificare un tag. | accessibile in scrittura |
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa Tag nel corpo della risposta.
Prova
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.