Macros

Le macro di un contenitore. Le macro rappresentano i valori che vengono valutati al momento dell'attivazione. Puoi fare riferimento alle macro quando configuri regole e tag. Per informazioni dettagliate sulle proprietà che possono essere impostate per le macro di Google Tag Manager, consulta la pagina di riferimento sul dizionario delle macro. Per informazioni sull'impostazione e l'utilizzo delle macro da parte degli utenti, consulta la sezione Macro nel Centro assistenza Google Tag Manager.

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

Rappresentazioni delle risorse

Rappresenta una macro di Google Tag Manager.

{
  "accountId": string,
  "containerId": string,
  "macroId": string,
  "name": string,
  "type": string,
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "enablingRuleId": [
    string
  ],
  "disablingRuleId": [
    string
  ],
  "fingerprint": string,
  "parentFolderId": string
}
Nome proprietà Valore Descrizione Note
accountId string ID account GTM.
containerId string ID contenitore GTM.
disablingRuleId[] list Solo per i contenitori per dispositivi mobili: un elenco di ID regola per la disattivazione delle macro condizionali; la macro viene attivata se una delle regole di attivazione è vera e tutte le regole di disattivazione sono false. Sono considerati come un insieme non ordinato. scrivibile
enablingRuleId[] list Solo per i contenitori per dispositivi mobili: un elenco di ID regola per l'attivazione di macro condizionali; la macro viene attivata se una delle regole di attivazione è vera e tutte le regole di disattivazione sono false. Sono considerati come un insieme non ordinato. scrivibile
fingerprint string L'impronta della macro GTM calcolata al momento dell'archiviazione. Questo valore viene ricalcolato ogni volta che la macro viene modificata.
macroId string L'ID macro identifica in modo univoco la macro GTM.
name string Nome visualizzato della macro. scrivibile
notes string Note dell'utente su come applicare questa macro nel contenitore. scrivibile
parameter[] list I parametri della macro. 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[].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
parameter[].value string Il valore di un parametro (può contenere riferimenti a macro come "") a seconda del tipo specificato. scrivibile
parentFolderId string ID cartella principale.
scheduleEndMs long Il timestamp di fine in millisecondi per pianificare una macro. scrivibile
scheduleStartMs long Il timestamp di inizio in millisecondi per pianificare una macro. scrivibile
type string Tipo di macro GTM. scrivibile

Metodi

Per creare, modificare, eliminare o recuperare le macro, utilizza i metodi descritti di seguito.

creazione
Crea una macro GTM.
elimina
Elimina una macro GTM.
ricevi
Recupera una macro GTM.
list
Elenca tutte le macro GTM di un contenitore.
aggiornamento
Aggiorna una macro GTM.