Richiede l'autorizzazione
Crea un tag GTM. Prova subito o guarda un esempio.
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri percorso | ||
accountId |
string |
L'ID account GTM. |
containerId |
string |
L'ID del contenitore GTM. |
Autorizzazione
Questa richiesta richiede l'autorizzazione con il seguente ambito (scopri di più su autenticazione e autorizzazione).
Ambito |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Corpo della richiesta
Nel corpo della richiesta, fornisci una risorsa Tag con le seguenti proprietà:
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
Proprietà obbligatorie | |||
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 |
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 |
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 |
True se il tag è in pausa. | 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.
Esempi
Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).
Java
Utilizza la libreria client Java.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request creates a new tag. */ // Construct the parameters. Parameter arg0 = new Parameter(); arg0.setType("template"); arg0.setKey("trackingId"); arg0.setValue("UA-123456-1"); Parameter arg1 = new Parameter(); arg1.setType("template"); arg1.setKey("type"); arg1.setValue("TRACK_TRANSACTION"); // Construct the tag object. Tag tag = new Tag(); tag.setName("Sample Universal Analytics Tag"); tag.setType("ua"); tag.setLiveOnly(false); tag.setParameter(Arrays.asList(arg0, arg1)); try { Tag response = tagmanager.accounts().containers(). tags().create("123456", "54321", tag).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); } /* * The results of the create method are stored in response object. * The following code shows how to access the created id and fingerprint. */ System.out.println("Tag id = " + response.getTagId()); System.out.println("Tag Fingerprint = " + response.getFingerprint());
Python
Utilizza la libreria client Python.
# Note: This code assumes you have an authorized tagmanager service object. # This request creates a new container tag. try: response = tagmanager.accounts().containers().tags().create( accountId='123456', containerId='54321', body={ 'name': 'Universal Analytics Tag', 'type': 'ua', 'liveOnly': False, 'parameter': [ { 'type': 'template', 'key': 'trackingId', 'value': 'UA-123456-1' }, { 'type': 'template', 'key': 'type', 'value': 'TRACK_TRANSACTION' } ] } ).execute() except TypeError, error: # Handle errors in constructing a query. print 'There was an error in constructing your query : %s' % error except HttpError, error: # Handle API errors. print ('There was an API error : %s : %s' % (error.resp.status, error.resp.reason)) # The results of the create method are stored in the response object. # The following code shows how to access the created id and fingerprint. print response.get('tagId') print response.get('fingerprint')
Prova
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.