Norme per i modelli personalizzati

I criteri vengono implementati su una pagina web. Quando un contenitore viene eseguito nella pagina, i criteri vengono applicati alle definizioni dei modelli personalizzati di Tag Manager per controllare in che modo determinate caratteristiche e funzionalità possono essere utilizzate. I criteri vengono implementati con l'API gtag('policy', ...).

L'API gtag('policy', ...) richiede definizioni per dataLayer e gtag(). Assicurati che dataLayer e gtag() siano definiti nel codice prima che gtag('policy', ...) venga richiamato più tardi nello script:

window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}

Utilizza l'API gtag('policy', ...) in una pagina web per impostare criteri per le autorizzazioni per i modelli personalizzati:

gtag('policy', <permissionId>, <function>)

L'argomento <permissionId> è uno dei tipi di autorizzazioni supportati, ad esempio inject_script. Il criterio viene chiamato ogni volta che un container vuole verificare se questa autorizzazione è consentita.

gtag('policy', 'inject_script', function(containerId, permissionId, data) {
  // Specific inject_script check goes here.
});

Specifica 'all' per interagire con tutti i controlli dei criteri.

gtag('policy', 'all', function(containerId, permissionId, data) {
  // System-wide check goes here.
});

Il terzo argomento <function> è una funzione che implementa il criterio indicato con questa firma:

function(containerId, permissionId, data) {...}

• containerId è l'ID contenitore di Tag Manager, ad esempio 'GTM-1234'.
• permissionId è una stringa che specifica il tipo di criterio da controllare.
• data è un oggetto contenente tutte le informazioni pertinenti per il tipo di autorizzazione indicato, ad esempio 'url' per un'autorizzazione 'send_pixel'.

Una funzione di criterio rifiuta una richiesta di autorizzazione quando restituisce false o genera un'eccezione. Eventuali eccezioni di tipo string o Error vengono visualizzate nella sezione Errori del riquadro di debug quando è attiva la modalità anteprima. Quando vengono registrati più controlli dei criteri, ciascuno di essi viene richiamato e ogni controllo può rifiutare una richiesta di criterio.

In questo esempio viene creato un criterio che verifica l'autorizzazione 'inject_script':

gtag('policy', 'inject_script', function(containerId, permissionId, data) {

  // reference the url of the script to be injected
  let url = data.url || '';

  // if the url of the injected script exactly matches, allow it.
  // otherwise throw an error
  if (url === 'https://scripts.example.com/analytics.js') {
    return true;
  } else {
    throw 'Only permitted to inject https://scripts.example.com/analytics.js';
  }
});

In questo esempio viene utilizzata la parola chiave 'all' per controllare più scenari di criteri:

gtag('policy', 'all', function(containerId, permissionId, data) {

  // Only set policy for 1 specific container.
  // This enables other containers loaded on the page to
  // operate without restrictions on permissions.
  if (container != 'GTM-4321') return true;

  // Since the policy is 'all', adjust permissions conditionally.
  switch (permissionId) {

    case 'send_pixel':
      return true;

    case 'write_globals':
      return data.key && data.key == '_gaq';

    case 'inject_script':
      let url = data.url || '';
      if (url.indexOf('https://example.com') != 0)
        throw 'Only example.com scripts are permitted';

    default:
      // IT staff decides that all unknown permissions
      // are rejected.
      return false;
  }
});