Questa pagina è stata tradotta dall'API Cloud Translation.

Tags: create

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: `boolean`: il valore rappresenta un valore booleano, rappresentato come "true" o "false" `integer`: il valore rappresenta un valore intero con segno a 64 bit, in base 10 `list`: è necessario specificare un elenco di parametri `map`: è necessario specificare una mappa dei parametri `template`: il valore rappresenta qualsiasi testo, inclusi riferimenti variabili (anche quelli a variabili che potrebbero restituire tipi diversi da una stringa) `trigger_reference`: il valore rappresenta un attivatore, rappresentato come ID attivatore I valori accettati sono: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	scrivibile
`priority.type`	`string`	Il tipo di parametro. I valori validi sono: `boolean`: il valore rappresenta un valore booleano, rappresentato come "true" o "false" `integer`: il valore rappresenta un valore intero con segno a 64 bit, in base 10 `list`: è necessario specificare un elenco di parametri `map`: è necessario specificare una mappa dei parametri `template`: il valore rappresenta qualsiasi testo, inclusi riferimenti variabili (anche quelli a variabili che potrebbero restituire tipi diversi da una stringa) `trigger_reference`: il valore rappresenta un attivatore, rappresentato come ID attivatore I valori accettati sono: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	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.