Configura la modalità proprietaria

Questo documento è rivolto agli utenti che vogliono eseguire il deployment del tag Google in modalità proprietaria. Consigliamo la modalità proprietaria per la configurazione dei tag più duratura.

Panoramica

Nota: la modalità proprietaria è in beta. La configurazione della modalità proprietaria può contribuire a migliorare il rendimento della configurazione dei tag, con il conseguente recupero degli indicatori di misurazione persi, nel rispetto della privacy. In caso di domande o problemi con la configurazione, contattaci all'indirizzo [e-mail].

La modalità proprietaria ti consente di eseguire il deployment del tag Google utilizzando la tua infrastruttura proprietaria, ospitata sul dominio del tuo sito web (ad es. example.com). Questa infrastruttura si trova tra il tuo sito web e i servizi di Google, rendendo la tua infrastruttura proprietaria l'unica tecnologia per interagire direttamente con gli utenti del tuo sito web. La modalità proprietaria aggiunge un livello di sicurezza dei dati e consente ulteriori controlli per la privacy dei dati, come l'offuscamento completo degli IP, senza compromettere la misurazione. La configurazione in questa documentazione ti aiuterà a recuperare X% in più di indicatori di misurazione sul tuo sito web. Puoi configurarlo utilizzando la rete CDN (Content Delivery Network), il bilanciatore del carico o il server web esistenti per attivare la modalità proprietaria.

Nelle configurazioni del tag Google standard, la tua pagina web richiede un tag Google da un dominio Google (ad es. www.googletagmanager.com). Quando si attiva, il tag invia richieste di misurazione direttamente al prodotto Google. In modalità proprietaria, il sito web carica il tag Google dal tuo dominio proprietario (ad es. example.com). Quando si attiva, il tag invia richieste di misurazione al tuo dominio proprietario, dove vengono inoltrate al prodotto Google pertinente.

Potrai usufruire della piena continuità di misurazione passando dalla configurazione di un tag Google standard alla configurazione in modalità proprietaria.

Questo diagramma rappresenta il flusso di informazioni in modalità proprietaria:

Prima di iniziare

Questa guida presuppone che il tuo sito web sia già configurato con:

• Un tag Google o un contenitore Tag Manager.
• Una rete CDN (Content Delivery Network) o un bilanciatore del carico che può inoltrare le richieste a endpoint esterni

1. Scegli il percorso di pubblicazione dei tag

Devi prenotare un percorso sul dominio del tuo sito web per la pubblicazione del tag. Assicurati che questo percorso non sia già in uso nel tuo dominio.

Scegli qualsiasi percorso per la configurazione della modalità proprietaria. Ecco alcuni esempi di percorsi da utilizzare: /metrics, /securemetric, /analytics o preferibilmente una stringa alfanumerica casuale che non è già utilizzata sul tuo sito web.

Compila il campo seguente per completare gli esempi di questo documento.

Your domain: example.com
Google tag ID: GTM-123456
Tag serving path: /metrics

Attenzione: questa configurazione reindirizza tutto il traffico con il percorso scelto. Per evitare influisce sul tuo sito web, scegli un percorso che non sia già in uso.

2. Indirizza il traffico

Questa sezione presuppone che il tuo sito web utilizzi già una CDN o un bilanciatore del carico che supporta il routing del traffico per percorsi.

Google Cloud

Devi configurare un nuovo backend che cerchi la posizione geografica approssimativamente del visitatore del sito e creare regole di routing nel tuo External Application Load Balancing esistente.

Crea il nuovo backend

1. Apri il bilanciatore del carico Google Cloud

2. Nel bilanciatore del carico, apri la sezione Configurazione backend. Crea un nuovo servizio di backend.

3. Configura il nuovo servizio di backend con le informazioni di geolocalizzazione:

   • Specifica un nome, ad esempio measurement-be-svc.
   • Imposta Tipo di backend su Gruppo di endpoint di rete internet.
   • Imposta Protocollo su HTTPS e lascia Timeout come valore precompilato.
   • In Backend, fai clic sul menu a discesa Gruppo di endpoint di rete internet e crea un nuovo gruppo di endpoint di rete internet:
     • Imposta Tipo di gruppo di endpoint di rete su NEG internet (globale, a livello di regione).
     • Imposta Ambito su Globale.
     • Imposta Aggiungi tramite su Nome di dominio e porta completi.
     • Imposta Nome di dominio completo su GTM-123456.fps.goog.
     • Fai clic su CREA per creare l'endpoint.
     • Chiudi la scheda Gruppo di endpoint di rete per tornare alla scheda Nuovo servizio di backend.
   • Cerca il nome del nuovo gruppo di endpoint di rete e selezionalo.
   • Apri la sezione Configurazioni avanzate. Aggiungi le seguenti intestazioni delle richieste personalizzate.

     Nome intestazione	Valore intestazione
     Host	GTM-123456.fps.goog
     X-Gclb-Country	{client_region}
     X-Gclb-Region	{client_region_subdivision}

   • Rivedi le altre impostazioni. Per questa integrazione non sono necessari né Cloud CDN né Cloud Armor, quindi puoi disabilitare entrambi.
   • Salva il nuovo servizio di backend.

Configura le regole di routing

1. Nel bilanciatore del carico, apri la sezione Regole di routing.

2. Aggiungi le seguenti regole relative a host e percorso:

   Host	Percorso	Backend
   *	/metrics/*	measurement-be-svc

3. Aggiorna la configurazione del bilanciatore del carico.

4. In un browser, verifica la configurazione visitando: https://example.com/metrics/healthy. La pagina deve contenere il testo ok. Verifica che le informazioni geografiche siano incluse navigando verso: https://example.com/metrics/?validate_geo=healthy. La pagina deve avere il testo ok.

Cloudflare

Per pubblicare il tag in modalità proprietaria, dovrai creare una voce CNAME per un nuovo sottodominio, creare una regola di origine per inoltrare le richieste e creare una regola di trasformazione per includere le informazioni di geolocalizzazione.

Crea voce CNAME

Nota: i tag non utilizzano questa voce CNAME, che viene utilizzata da Cloudflare per instradare le richieste internamente.

Scegli un sottodominio da prenotare per la voce CNAME. Compila il campo seguente per compilare gli esempi del documento. Il record CNAME non viene mai esposto al di fuori della configurazione di Cloudflare, quindi il nome è arbitrario.

CNAME subdomain: fps

1. Nella scheda DNS, apri la sezione Records (Record).
2. Aggiungi un nuovo record con la seguente configurazione:
   • Imposta Type (Tipo) su CNAME.
   • Imposta Nome su fps.
   • Imposta Target su GTM-123456.fps.goog.
3. Salva il record CNAME.

Crea la regola di origine

1. Nella scheda Regole, apri Regole di origine e crea la regola.
2. Inserisci un nome per la regola, ad esempio Route measurement.
3. Abbina le richieste in entrata in base a un'espressione di filtro personalizzata e fai clic su Modifica espressione.
4. Incolla la seguente espressione nello strumento di creazione: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
5. Aggiorna l'intestazione host in Riscrivi in... GTM-123456.fps.goog.
6. Aggiorna il Record DNS in Override to... fps.example.com.
7. Salva la regola di origine.
8. Se sono presenti altre regole di origine, aumenta la posizione della regola appena creata in modo che venga eseguita dopo qualsiasi altro percorso con caratteri jolly.
9. In un browser, per verificare la configurazione vai a: https://example.com/metrics/healthy. Nella pagina dovrebbe essere visualizzata la dicitura ok.

Includi informazioni di geolocalizzazione

1. Nella scheda Regole, apri Trasforma le regole.
2. Crea una regola per Modifica intestazione della richiesta.
3. Applica la regola a Tutte le richieste in arrivo.
4. Modifica l'intestazione della richiesta con la seguente configurazione:
   • Imposta l'operatore su Imposta dinamica.
   • Imposta Nome intestazione su X-CfIpCountryRegion.
   • Imposta Valore su ip.src.subdivision_1_iso_code.
5. Esegui il deployment della regola di trasformazione.
6. Attendi alcuni minuti per la propagazione della regola. In un browser, verifica la configurazione visitando: https://example.com/metrics/?validate_geo=healthy. Nella pagina dovrebbe essere visualizzata la dicitura ok.

(Facoltativo) Rimuovi le intestazioni IP dei visitatori

La modalità proprietaria non richiede l'IP visitatore per funzionare correttamente. Puoi rimuovere tutte le intestazioni IP dei visitatori utilizzando la funzionalità Rimuovi intestazioni IP visitatore Managed Transforms.

Altro

Per pubblicare il tag in modalità proprietaria, devi configurare la CDN o il bilanciatore del carico per instradare le richieste all'endpoint in modalità proprietaria.

1. Aggiungi un'origine o un backend che rimandi a GTM-123456.fps.goog.
2. Sostituisci l'intestazione Host in modo che sia uguale a GTM-123456.fps.goog. Consenti l'inoltro di tutti i cookie e le stringhe di query.
3. Aggiungi una regola percorso per /metrics/* per indirizzare il traffico alla modalità proprietaria.
4. Configura il percorso riservato in modo che abbia una priorità superiore rispetto alla regola predefinita.
5. In un browser, verifica la configurazione visitando: https://example.com/metrics/healthy. Nella pagina dovrebbe essere visualizzata la dicitura ok.

Passaggio 3. Aggiorna gli script sul sito web per utilizzare il percorso di misurazione

Sostituisci gli script su ogni pagina del sito web con uno dei seguenti:

gtag.js

Nella parte superiore della sezione <head>, individua le due righe di script con l'ID del tuo tag Google:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GTM-123456"></script>

e sostituirli con il percorso di misurazione:

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

gtm.js

Nella parte superiore della sezione <head>, sostituisci lo snippet di Tag Manager con quanto segue:

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->

Passaggio 4: verifica la configurazione della misurazione

Per verificare la configurazione della misurazione, configura il contenitore in modo che venga attivato almeno un tag.

1. Vai a Tag Assistant e visualizza l'anteprima del contenitore. Naviga nel tuo sito per attivare i tag.

2. Nella scheda Riepilogo > Output > Hit inviati, verifica che gli hit siano indirizzati a /metrics.

   

Passaggio 5: Feedback

Fornisci un feedback sulla modalità proprietaria tramite il modulo di feedback.