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 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: `boolean`: il valore rappresenta un valore booleano, rappresentato come "true" o "false" `integer`: il valore rappresenta un valore intero a 64 bit con segno, in base 10 `list`: è necessario specificare un elenco di parametri `map`: è necessario specificare una mappa di parametri `template`: il valore rappresenta qualsiasi testo; questo può includere riferimenti a variabili (anche riferimenti a variabili che potrebbero restituire tipi non stringa) `trigger_reference`: il valore rappresenta un attivatore, rappresentato come ID attivatore di Gemini Advanced. I valori accettati sono: . "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	accessibile in scrittura
`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 a 64 bit con segno, in base 10 `list`: è necessario specificare un elenco di parametri `map`: è necessario specificare una mappa di parametri `template`: il valore rappresenta qualsiasi testo; questo può includere riferimenti a variabili (anche riferimenti a variabili che potrebbero restituire tipi non stringa) `trigger_reference`: il valore rappresenta un attivatore, rappresentato come ID attivatore di Gemini Advanced. I valori accettati sono: . "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	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.