Configura il tagging lato server con Cloud Run

Questa guida spiega come:

Esegui il provisioning di un server di anteprima per attivare la funzionalità di anteprima per il contenitore.
Esegui il provisioning di un server di tagging per gestire il traffico in tempo reale.
Aumenta o diminuisci il numero di server che eseguono il contenitore Google Tag Manager.
Mantieni aggiornata la versione del server di tagging dopo il provisioning.

Prerequisiti

Devi avere un account GCP. Se non ne hai uno, crea un nuovo account GCP.
È necessario un account di fatturazione GCP. Se non ne hai uno, crea un account di fatturazione GCP (richiede il ruolo di creatore dell'account di fatturazione).
Devi disporre dei ruoli Creatore progetto e Utente account di fatturazione. Scopri di più sull'aggiunta di ruoli.

Esegui il provisioning di un server di anteprima e di tagging

Puoi eseguire il provisioning di un servizio Cloud Run automaticamente in Google Tag Manager o manualmente in Google Cloud.

Modifica la configurazione del servizio

Per modificare la configurazione del servizio:

Apri Cloud Run.
Seleziona il servizio da modificare.
Fai clic su Modifica ed esegui il deployment di una nuova revisione.
Apporta le modifiche e fai clic su Esegui il deployment.

Costo di Cloud Run

In questa configurazione di Cloud Run, ogni server costa circa 45 $al mese (USD). Ogni server è un'istanza Cloud Run con 1 vCPU e 0,5 GB di memoria che utilizza il modello di prezzi con CPU sempre allocata.

Consigliamo di eseguire un minimo di due istanze per ridurre il rischio di perdita di dati in caso di interruzione del server. Tuttavia, puoi scegliere di eseguire un numero inferiore (o superiore) di server. Prevediamo che la scalabilità automatica di 2-10 server gestirà 35-350 richieste al secondo, anche se il rendimento varierà in base al numero di tag e alla loro funzione.

Cloud Run verrà scalato dinamicamente in base al carico. L'impostazione max-instances è lo scenario peggiore per quanto riguarda l'importo che dovrai pagare per le risorse. Cloud Run non esegue il provisioning di così tante istanze a meno che non sia necessario.

Stima dei costi di Cloud Run

Per stimare il costo mensile di esecuzione dei server di tagging, utilizza il Calcolatore prezzi di Google Cloud. La calcolatrice si apre con una stima preconfigurata per un'implementazione predefinita del tagging lato server. Puoi modificare le impostazioni per ottenere una stima più precisa in base al traffico previsto.

(Facoltativo) Eseguire la migrazione da App Engine

Se in precedenza hai creato un deployment App Engine e hai verificato che non riceve più traffico, disattiva l'applicazione App Engine per evitare addebiti imprevisti.

(Facoltativo) Deployment multiregionale

Se il tuo sito web ha una presenza globale o vuoi integrare la ridondanza nel servizio, esegui il deployment dei server di tagging in più regioni.

Prima di iniziare:

Crea un bilanciatore del carico
Prendi nota del BACKEND_NAME che hai scelto.

Per aggiungere altre regioni al deployment:

Sostituisci REGION con la regione in cui è stato eseguito il deployment del server di anteprima. Questo campo potrebbe essere già compilato se hai seguito le opzioni della riga di comando per eseguire il provisioning del server di anteprima e tagging.
Sostituisci CONTAINER_CONFIG con la stringa di configurazione del contenitore di Tag Manager. Questo campo potrebbe essere già compilato se hai seguito le opzioni della riga di comando per eseguire il provisioning del server di anteprima e tagging.
Sostituisci NEW_REGION con la nuova regione in cui vuoi eseguire il deployment del server di tagging.
Sostituisci BACKEND_NAME con il nome scelto durante il provisioning del bilanciatore del carico.
(Facoltativo) Per aggiungere un'altra regione, sostituisci la variabile NEW_REGION ed esegui di nuovo lo snippet di codice.

    gcloud run deploy "server-side-tagging" \
    --region NEW_REGION \
    --image gcr.io/cloud-tagging-10302018/gtm-cloud-image:stable \
    --platform managed \
    --ingress all \
    --min-instances 2 \
    --max-instances 10 \
    --timeout 60 \
    --allow-unauthenticated \
    --no-cpu-throttling \
    --update-env-vars PREVIEW_SERVER_URL="$(
      gcloud run services describe server-side-tagging-preview \--region "REGION" \
      --format="value(status.url)")",CONTAINER_CONFIG="CONTAINER_CONFIG" && \

    gcloud compute network-endpoint-groups create server-side-tagging-neg \
    --region=NEW_REGION \
    --network-endpoint-type=SERVERLESS \
    --cloud-run-service="server-side-tagging" && \

    gcloud compute backend-services add-backend --global "BACKEND_NAME" \
    --network-endpoint-group-region=NEW_REGION \
    --network-endpoint-group=server-side-tagging-neg

(Facoltativo) Disabilita il logging

Logging delle richieste

Per impostazione predefinita, vengono registrate informazioni su ogni singola richiesta (ad es. percorso della richiesta, parametri della query e così via). Se il tuo server di tagging gestisce molte richieste al mese (ad es. più di 1 milione), questi messaggi di log potrebbero comportare costi di logging significativi. Per ridurre o eliminare gli addebiti per la registrazione, ti consigliamo di disattivare la registrazione delle richieste.

Per disattivare il logging delle richieste:

Nella piattaforma Google Cloud, apri Logs Router. Assicurati di trovarti nel progetto che corrisponde all'ID contenitore:
Per Tipo: Bucket Cloud Logging, Nome: riga _Default, seleziona il menu Altro e poi fai clic su Modifica sink.
In Destinazione sink, seleziona il bucket di log _Default.
In Scegli i log da includere nel sink, aggiungi una nuova riga. Inserisci la seguente regola nel filtro di inclusione esistente:
```
NOT LOG_ID("run.googleapis.com/requests")
```
Per disattivare la registrazione anche dal bilanciatore del carico, aggiungi una nuova riga e inserisci la seguente regola al filtro di inclusione esistente:
```
NOT LOG_ID("requests")
```
Nota: questa azione disattiva tutti i log del bilanciatore del carico, incluse le richieste che non vengono inviate al contenitore del server.
Aggiorna il sink per applicare le modifiche. Ora le richieste verranno escluse dalla registrazione.
Verifica che non vengano visualizzate nuove richieste nei log di Esplora log.

Logging della console

Il server di tagging, i client o i tag in un contenitore possono registrare messaggi nella console che potrebbero comportare costi di logging. Per ridurre o eliminare gli addebiti per la registrazione, puoi disattivare i messaggi di log della console indesiderati.

Identifica i log della console indesiderati:

In GCP, apri Esplora log.
Cerca eventuali messaggi di log indesiderati provenienti dai tuoi tag. Ad esempio:

Un tag potrebbe inviare i seguenti log:
```
const logToConsole = require('logToConsole');

logToConsole('Custom message: ' + data.param1);
logToConsole('An important message to keep around!');
data.gtmOnSuccess()
```
Cerca i messaggi di log corrispondenti nel campo textPayload:

Per disattivare il messaggio di log della console:

Nella piattaforma Google Cloud, apri Logs Router. Assicurati di trovarti nel progetto che corrisponde all'ID contenitore:
Per Tipo: Bucket Cloud Logging, Nome: riga _Default, seleziona il menu Altro e poi fai clic su Modifica sink.
In Destinazione sink, seleziona il bucket di log _Default.
In Scegli i log da includere nel sink, aggiungi una nuova riga. Inserisci la seguente regola nel filtro di inclusione esistente:
```
NOT textPayload:"Custom message:"
```
Per i log della console, sostituisci il testo Custom message: con una sottostringa del log della console che vuoi disattivare. Per filtri più elaborati, utilizza il linguaggio di query di Logging.
Aggiorna il sink per applicare le modifiche. Il messaggio logToConsole corrispondente deve essere escluso dalla registrazione.
Verifica che non vengano visualizzati nuovi messaggi di log della console in Esplora log.

2. Mappa il deployment sul tuo dominio personalizzato

Configura un dominio personalizzato per utilizzare un dominio diverso dall'indirizzo predefinito fornito da Cloud Run.

3. Aggiungere l'URL del server a Google Tag Manager

Ora che hai un server, devi assicurarti che Google Tag Manager sappia che deve utilizzarlo.

Apri Google Tag Manager.
Fai clic sul contenitore del server che vuoi indirizzare al server di tagging.
Apri le impostazioni del contenitore del server nella scheda Amministrazione > Impostazioni contenitore.
Fai clic su Aggiungi URL e incolla l'URL del server.
Salva e torna all'area di lavoro.

4. Convalida

Ora che hai configurato il server di tagging, assicurati che funzioni come previsto. Nel workspace di Tag Manager, fai clic sul pulsante Anteprima. Se la pagina di anteprima viene caricata, significa che tutto è configurato correttamente.

Visualizzare l'anteprima di più URL

Se hai mappato più domini a un singolo server di tagging, assicurati che ogni URL venga aggiunto alle impostazioni del contenitore.

Se hai fornito più URL, tutti i percorsi (la stringa dopo il nome di dominio) devono corrispondere.

Works	Non funziona
URL 1: `example.com/abc` URL 2: `example2.com/abc`	URL 1: `example.com/abc` URL 2: `example2.com/def`

Se vengono aggiunti più URL, vedrai un'icona accanto al pulsante Anteprima che ti consente di selezionare l'URL di cui visualizzare l'anteprima.

Aggiornare la versione del server di tagging

I nuovi aggiornamenti del server di tagging contengono correzioni di vulnerabilità della sicurezza e nuove funzionalità. Ti consigliamo di aggiornare il server di tagging almeno per ogni rilascio di versione principale (ad es. l'upgrade dalla versione 1.x.x alla 2.x.x) quando Tag Manager ti notifica di eseguire l'aggiornamento.

Per aggiornare il server di tagging, implementa una nuova revisione utilizzando le stesse impostazioni che hai utilizzato in precedenza.

Apri Cloud Run.
Seleziona il servizio che vuoi aggiornare.
Fai clic su Modifica ed esegui il deployment di una nuova revisione.
Assicurati che l'URL immagine container sia impostato su gcr.io/cloud-tagging-10302018/gtm-cloud-image:stable e fai clic su Esegui il deployment.

Per verificare che l'aggiornamento sia riuscito:

Nel contenitore server, fai clic sul pulsante Anteprima per avviare una nuova sessione di debug e inviare una richiesta in una scheda separata.
Nel riepilogo, seleziona la scheda Console e assicurati che non siano presenti messaggi che ti chiedono di aggiornare il server di tagging.

Tag Manager potrebbe mostrare messaggi che ti chiedono di aggiornare il server di tagging fino a un giorno dopo l'aggiornamento del server. Tuttavia, la pagina di anteprima mostrerà un messaggio aggiornato sulla versione del server di tagging.