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 del percorso | ||
accountId |
string |
L'ID account GTM. |
containerId |
string |
L'ID 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. | scrivibile |
parameter[].type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
priority.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
type |
string |
Tipo di tag GTM. | scrivibile |
Proprietà facoltative | |||
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 |
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 |
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[].value |
string |
Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. | scrivibile |
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.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 |
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.
Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.