Rules

Le regole di un container. Le regole restituiscono true o false durante il tempo di esecuzione. Possono essere utilizzati per controllare quando un tag viene attivato o quando viene bloccata, nonché per controllare quando le macro in un contenitore per dispositivi mobili vengono attivate o disattivate. Per maggiori dettagli, consulta, rispettivamente, le regole di attivazione e disattivazione della configurazione di un tag e le regole di attivazione e disattivazione della configurazione di una macro.

Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.

Rappresentazioni delle risorse

Rappresenta una regola di Google Tag Manager.

{
  "accountId": string,
  "containerId": string,
  "ruleId": string,
  "name": string,
  "notes": string,
  "condition": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ]
    }
  ],
  "fingerprint": string
}

Nome proprietà	Valore	Descrizione	Note
accountId	string	ID account GTM.
condition[]	list	L'elenco di condizioni che costituiscono questa regola (implicita AND tra le condizioni).	scrivibile
condition[].parameter[]	list	Un elenco di parametri denominati (chiave/valore), a seconda del tipo di condizione. Note: Per gli operatori binari, includi i parametri denominati arg0 e arg1 per specificare rispettivamente gli operandi sinistro e destro. Al momento, l'operando sinistro (arg0) deve essere un riferimento a una macro. Per la corrispondenza con espressioni regolari senza distinzione tra maiuscole e minuscole, includi un parametro booleano denominato ignore_case impostato su true. Se non viene specificato o impostato su un altro valore, la corrispondenza sarà sensibile alle maiuscole. Per escludere un operatore, includi un parametro booleano denominato negate e impostalo su true.	scrivibile
condition[].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
condition[].parameter[].list[]	list	Parametri di questo parametro elenco (le chiavi verranno ignorate).	scrivibile
condition[].parameter[].map[]	list	I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche).	scrivibile
condition[].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; possono essere inclusi riferimenti alle macro (anche riferimenti alle macro che potrebbero restituire tipi diversi da una stringa) I valori accettati sono: "boolean" "integer" "list" "map" "template"	scrivibile
condition[].parameter[].value	string	Il valore di un parametro (può contenere riferimenti a macro come "") a seconda del tipo specificato.	scrivibile
condition[].type	string	Il tipo di operatore per questa condizione. I valori accettati sono: "contains" "cssSelector" "endsWith" "equals" "greater" "greaterOrEquals" "less" "lessOrEquals" "matchRegex" "startsWith" "urlMatches"	scrivibile
containerId	string	ID contenitore GTM.
fingerprint	string	L'impronta della regola GTM calcolata al momento dell'archiviazione. Questo valore viene ricalcolato ogni volta che la regola viene modificata.
name	string	Nome visualizzato della regola.	scrivibile
notes	string	Note dell'utente su come applicare questa regola nel contenitore.	scrivibile
ruleId	string	L'ID regola identifica in modo univoco la regola GTM.

Metodi

Utilizza i metodi riportati di seguito per creare, modificare, eliminare o recuperare le regole.

creazione

Crea una regola GTM.

elimina

Elimina una regola GTM.

ricevi

Consente di ottenere una regola GTM.

list

Elenca tutte le regole GTM di un contenitore.

aggiornamento

Aggiorna una regola GTM.