Questa pagina è stata tradotta dall'API Cloud Translation.

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 riduci il numero di server su cui è in esecuzione il contenitore di Google Tag Manager.
Mantieni aggiornata la versione del server di tagging dopo il provisioning del server.

Prerequisiti

È necessario un account Google Cloud. Se non ne hai uno, crea un nuovo account Google Cloud.
Devi disporre di un account di fatturazione Google Cloud. Se non ne hai uno, crea un account di fatturazione Google Cloud (è richiesto il ruolo Creatore account di fatturazione).
Devi disporre del ruolo Creatore progetto e Utente account di fatturazione. Scopri di più sull'aggiunta di ruoli.

Esegui il provisioning di un server di anteprima e 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 prezzo con CPU sempre allocata.

Consigliamo di eseguire almeno due istanze per ridurre il rischio di perdita di dati in caso di interruzione del servizio del server. Tuttavia, puoi scegliere di eseguire meno (o più) server. Prevediamo che la scalabilità automatica di 2-10 server gestirà 35-350 richieste al secondo, anche se le prestazioni varieranno in base al numero di tag e alla loro funzione.

Cloud Run eseguirà la scalabilità dinamica in base al carico. L'impostazione max-instances corrisponde allo scenario peggiore per quanto riguarda l'importo che dovrai pagare per le risorse. Cloud Run non eseguirà il provisioning di così tante istanze, a meno che non sia necessario.

Calcolatrice Cloud Run

(Facoltativo) Migrazione da App Engine

Se in precedenza hai creato un deployment di 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 creare ridondanza nel servizio, esegui il deployment dei server di tagging in più regioni.

Prima di iniziare:

Creare un bilanciatore del carico
Prendi nota del BACKEND_NAME scelto.

Per aggiungere altre regioni al deployment:

Sostituisci REGION con la regione in cui è dipiegato il 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) Disattiva il logging

Log delle richieste

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

Per disattivare il logging delle richieste:

Nella piattaforma Google Cloud, apri Logs Router. Assicurati di trovarti nel progetto corrispondente all'ID contenitore:
Per la riga Tipo: Bucket Cloud Logging, Nome: _Predefinito, seleziona il menu di overflow, quindi 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 anche il logging dal bilanciatore del carico, aggiungi una nuova riga e inserisci la seguente regola nel filtro di inclusione esistente:
```
NOT LOG_ID("requests")
```
Nota: in questo modo verrà disattivato tutto il logging dal 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 dal logging.
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 addebiti per i log. Per ridurre o eliminare gli addebiti per i log, puoi disattivare i messaggi di log della console indesiderati.

Identifica i log della console indesiderati:

In Google Cloud, 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 textPayload campo:

Per disattivare il messaggio del log della console:

Nella piattaforma Google Cloud, apri Logs Router. Assicurati di trovarti nel progetto corrispondente all'ID contenitore:
Per la riga Tipo: Bucket Cloud Logging, Nome: _Predefinito, seleziona il menu di overflow, quindi 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 delle 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 al tuo dominio personalizzato

Per configurare un dominio personalizzato, utilizza un bilanciatore del carico delle applicazioni esterno globale.

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 a cui vuoi indirizzare il 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 alla tua area di lavoro.

4. Convalida

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

Anteprima di più URL

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

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

Funziona	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, accanto al pulsante Anteprima viene visualizzata un'icona che 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à di sicurezza e nuove funzionalità. Ti consigliamo di aggiornare almeno il server di tagging per ogni release della versione principale (ad es. l'upgrade dalla versione 1.x.x alla 2.x.x) quando Tag Manager ti comunica che è necessario eseguire l'aggiornamento.

Per aggiornare il server di tagging, esegui il deployment di 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 del server, fai clic sul pulsante Anteprima per avviare una nuova sessione di debug e inviare una richiesta in una scheda separata.
In Riepilogo, seleziona la scheda Console e assicurati che non ci siano messaggi che ti chiedono di aggiornare il server di tagging.

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