Configurare un criterio JavaScript con sandbox

Puoi configurare uno script di criteri che limiti le autorizzazioni del contenitore lato server. In questa pagina viene mostrato come configurare un file di criteri per il tuo container. Queste istruzioni presuppongono che tu abbia già dimestichezza con i criteri dei modelli personalizzati per Tag Manager.

Un file dei criteri lato server è un file JavaScript che utilizza la sintassi di gtag.js per definire e registrare uno o più criteri.

  1. Crea un file JavaScript che crei e registri uno o più criteri. Ogni funzione dei criteri è registrata per una specifica autorizzazione o per tutte le autorizzazioni. Una funzione di criterio rifiuta una richiesta di autorizzazione quando restituisce false o genera un'eccezione. Ad esempio:

    gtag('policy', 'all', function(container, policy, data) {
      // This function will run for every permission check. Return true to
      // allow the permission check. Return false or throw an exception to
      // deny the permission check.
    
      // container is the container id (e.g. GTM-ABC123)
      // policy is the permission type (e.g. get_cookies)
      // data is an object containing data about the permission request
    
      // This policy applies to only one container. This check allows the
      // same policy file to apply to more than one Tag Manager server
      // container.
      if (container !== 'GTM-ABC123') return true;
    
      // Since this code runs on all permission checks, conditionally check
      // the permission type and decide to permit or deny the permission.
      switch (policy) {
    
        // Container GTM-ABC123 can send HTTP requests. Everything else is
        // prohibited.
        case 'send_http':
          return true;
    
        // All other permission requests are denied.
        default:
          return false;
      }
    });
    
    gtag('policy', 'get_cookies', function(container, policy, data) {
      // This function will run for checks on the get_cookies permission.
    
      // Deny all permission checks to read cookies except for the 'user_id'
      // cookie. This check applies to all containers that load this policy
      // file.
      return data.name === 'user_id';
    });
    
  2. Ospita il file JavaScript su un URL HTTPS accessibile pubblicamente. Il file può essere ospitato su qualsiasi server web, ma i passaggi seguenti descrivono come ospitarlo in un bucket Google Cloud Storage.

    1. Vai a console.cloud.google.com e seleziona il tuo progetto nella parte superiore della pagina.
    2. Seleziona Storage -> Browser dal menu di navigazione a sinistra.
    3. Fai clic su Crea bucket.
    4. Segui i passaggi per creare il bucket. In Controllo dell'accesso, seleziona Granulare.
    5. Fai clic su Carica file e carica il file JavaScript delle norme.
    6. Una volta caricato il file, fai clic sul nome, quindi seleziona Modifica autorizzazioni.
    7. Fai clic su Aggiungi voce con:
      • Entità: pubblica
      • Nome: allUsers
      • Accesso: lettore
    8. Fai clic su Salva.
    9. Fai clic su la freccia Indietro per tornare alla pagina precedente.
    10. Nella riga del file del criterio, fai clic su Copia URL.
  3. Per modificare la configurazione del server di tagging, segui le istruzioni riportate in Creare o riconfigurare un server di tagging. Quando viene richiesto l'URL di un criterio, inseriscilo nel passaggio 2.