REST Resource: accounts.containers.workspaces.tags

Risorsa: tag

Rappresenta un tag Google Tag Manager.

Rappresentazione JSON
{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "liveOnly": boolean,
  "priority": {
    object (Parameter)
  },
  "notes": string,
  "scheduleStartMs": string,
  "scheduleEndMs": string,
  "parameter": [
    {
      object (Parameter)
    }
  ],
  "fingerprint": string,
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "setupTag": [
    {
      object (SetupTag)
    }
  ],
  "teardownTag": [
    {
      object (TeardownTag)
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": enum (TagFiringOption),
  "tagManagerUrl": string,
  "paused": boolean,
  "monitoringMetadata": {
    object (Parameter)
  },
  "monitoringMetadataTagNameKey": string,
  "consentSettings": {
    object (ConsentSetting)
  }
}
Campi
path

string

Percorso relativo dell'API del tag GTM.

accountId

string

ID account GTM.

containerId

string

ID contenitore GTM.

workspaceId

string

ID area di lavoro GTM.

tagId

string

L'ID tag identifica in modo univoco il tag GTM.

name

string

Nome visualizzato del tag.

type

string

Tipo di tag GTM.

liveOnly

boolean

Se impostato su true, questo tag viene attivato solo nell'ambiente di pubblicazione (ad es. non in modalità di anteprima o di debug).

priority

object (Parameter)

Priorità numerica del tag definita dall'utente. I tag vengono attivati in modo asincrono in ordine di priorità. I tag con valore numerico più alto vengono attivati per primi. La priorità di un tag può essere un valore positivo o negativo. Il valore predefinito è 0.

notes

string

Note dell'utente su come applicare questo tag nel contenitore.

scheduleStartMs

string (int64 format)

Il timestamp di inizio in millisecondi per pianificare un tag.

scheduleEndMs

string (int64 format)

Il timestamp di fine in millisecondi per pianificare un tag.

parameter[]

object (Parameter)

I parametri del tag.

fingerprint

string

L'impronta del tag GTM calcolata al momento dell'archiviazione. Questo valore viene ricalcolato ogni volta che il tag viene modificato.

firingTriggerId[]

string

ID attivatori di attivazione. Un tag viene attivato quando uno degli attivatori elencati è true e tutti i suoi

blockingTriggerIds

(se specificati) sono false.

blockingTriggerId[]

string

ID trigger di blocco. Se uno degli attivatori elencati ha valore true, il tag non viene attivato.

setupTag[]

object (SetupTag)

L'elenco dei tag di configurazione. Al momento ne consentiamo solo uno.

teardownTag[]

object (TeardownTag)

L'elenco dei tag di smontaggio. Al momento ne consentiamo solo uno.

parentFolderId

string

ID cartella principale.

tagFiringOption

enum (TagFiringOption)

Opzione per attivare questo tag.

tagManagerUrl

string

Link generato automaticamente all'interfaccia utente di Tag Manager

paused

boolean

Indica se il tag è in pausa, il che ne impedisce l'attivazione.

monitoringMetadata

object (Parameter)

Una mappa di coppie chiave-valore dei metadati dei tag da includere nei dati sugli eventi per il monitoraggio dei tag. Note:

  • Questo parametro deve essere di tipo

    MAP

    .

  • Ogni parametro nella mappa è di tipo

    TEMPLATE

    , ma non può contenere riferimenti a variabili.

monitoringMetadataTagNameKey

string

Se non è vuoto, il nome visualizzato del tag verrà incluso nella mappa dei metadati di monitoraggio utilizzando la chiave specificata.

consentSettings

object (ConsentSetting)

Impostazioni del consenso di un tag.

SetupTag

Rappresenta un riferimento a un tag che viene attivato prima di un altro tag per configurare le dipendenze.

Rappresentazione JSON
{
  "tagName": string,
  "stopOnSetupFailure": boolean
}
Campi
tagName

string

Il nome del tag di configurazione.

stopOnSetupFailure

boolean

Se true, attiva il tag principale se e solo se il tag di configurazione viene attivato correttamente. Se false, attiva il tag principale indipendentemente dallo stato di attivazione del tag di configurazione.

TeardownTag

Rappresenta un tag che viene attivato dopo un altro tag per rimuovere le dipendenze.

Rappresentazione JSON
{
  "tagName": string,
  "stopTeardownOnFailure": boolean
}
Campi
tagName

string

Il nome del tag di smontaggio.

stopTeardownOnFailure

boolean

Se true, attiva il tag di smantellamento se e solo se il tag principale viene attivato correttamente. Se il valore è falso, attiva il tag di smantellamento indipendentemente dallo stato di attivazione del tag principale.

TagFiringOption

Enum
tagFiringOptionUnspecified
unlimited Il tag può essere attivato più volte per evento.
oncePerEvent Il tag può essere attivato solo per evento, ma può essere attivato più volte per caricamento (ad es. caricamento dell'app o della pagina).
oncePerLoad Il tag può essere attivato solo per caricamento (ad es. caricamento dell'app o della pagina).

ConsentSetting

Rappresentazione JSON
{
  "consentStatus": enum (ManualConsentOption),
  "consentType": {
    object (Parameter)
  }
}
Campi
consentStatus

enum (ManualConsentOption)

Lo stato del consenso del tag. Se impostato su NEEDED, il runtime verificherà che i tipi di consenso specificati dal

consentType

siano stati concessi.

consentType

object (Parameter)

Il tipo di consensi da verificare durante l'attivazione dei tag se lo stato del consenso è NECESSARIO. Questo parametro deve essere di tipo

LIST

in cui ogni voce dell'elenco è di tipo

STRING

.

ManualConsentOption

Enum
notSet Valore predefinito per cui l'utente non ha specificato alcuna impostazione.
notNeeded Il tag non richiede impostazioni del consenso aggiuntive.
needed Il tag richiede impostazioni del consenso aggiuntive.

Metodi

create

Crea un tag GTM.

delete

Consente di eliminare un tag GTM.

get

Recupera un tag GTM.

list

Elenca tutti i tag GTM di un contenitore.

revert

Ripristina le modifiche apportate a un tag GTM in uno spazio di lavoro GTM.

update

Aggiorna un tag GTM.