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.
Eseguire 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 Google Tag Manager.
Mantieni aggiornata la versione del server di tagging dopo aver eseguito il provisioning del server.

Prerequisiti

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

Eseguire 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 per il quale devi modificare.
Fai clic su Modifica ed esegui il deployment di 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 utilizzando il modello di prezzi della CPU sempre allocato.

Ti consigliamo di eseguire almeno 2 istanze per ridurre il rischio di perdita di dati in caso di interruzione del server. Tuttavia, puoi scegliere di eseguire un numero minore (o più) di server. Prevediamo che la scalabilità automatica da 2 a 10 server gestirà 35-350 richieste al secondo, anche se le prestazioni variano in base al numero di tag e alle funzioni di questi tag.

Cloud Run scala in modo dinamico con il carico. L'impostazione max-instances è lo scenario peggiore per quanto dovrai pagare per le risorse. Cloud Run non esegue il provisioning di un numero così elevato di istanze, a meno che non sia necessario.

Calcolatrice Cloud Run

(Facoltativo) Migrazione da App Engine

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

(Facoltativo) Deployment in più regioni

Se il tuo sito web è presente in tutto il mondo o se vuoi creare ridondanza nel servizio, esegui il deployment dei server di tagging in più regioni.

Prima di iniziare:

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

Per aggiungere altre regioni al deployment:

Sostituisci REGION con la regione in cui viene 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 di 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 che hai scelto durante il provisioning del bilanciatore del carico.
(Facoltativo) Per aggiungere un'altra regione, sostituisci la variabile NEW_REGION ed esegui nuovamente 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 logging

Richiedi logging

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

Per disabilitare il logging delle richieste:

Nella piattaforma Google Cloud, apri il router dei log. Assicurati di far parte del progetto corrispondente al tuo ID contenitore:
Per la riga Tipo: Bucket Cloud Logging, Nome: _Default, seleziona il menu extra, quindi fai clic su Modifica sink.
In Destinazione sink, seleziona il bucket dei 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 disabilitare anche il logging dal bilanciatore del carico, aggiungi una nuova riga e inserisci la seguente regola al filtro di inclusione esistente:
```
NOT LOG_ID("requests")
```
Nota: in questo modo verranno disabilitati tutti i log 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 saranno 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 costi di registrazione. Per ridurre o eliminare gli addebiti di logging, puoi disabilitare i messaggi di log della console indesiderati.

Identifica i log indesiderati della console:

In Google Cloud, apri Esplora log.
Cerca eventuali messaggi di log indesiderati provenienti dai 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 disabilitare il messaggio di log della console:

Nella piattaforma Google Cloud, apri il router dei log. Assicurati di far parte del progetto corrispondente al tuo ID contenitore:
Per la riga Tipo: Bucket Cloud Logging, Nome: _Default, seleziona il menu extra, quindi fai clic su Modifica sink.
In Destinazione sink, seleziona il bucket dei 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 disabilitare. 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 dal logging.
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 Application Load Balancer 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 utilizzare il tuo server.

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 container.
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. Nell'area di lavoro di Tag Manager, fai clic sul pulsante Anteprima. Se la pagina dell'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 venga 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, vedrai un'icona accanto al pulsante Anteprima che ti consente di selezionare l'URL da visualizzare in anteprima.

Aggiorna la versione del server di tagging

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

Per aggiornare il server di tagging, esegui il deployment di una nuova revisione utilizzando le stesse impostazioni utilizzate in precedenza.

Apri Cloud Run.
Seleziona il servizio che vuoi aggiornare.
Fai clic su Modifica ed esegui il deployment di 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 siano presenti messaggi che ti chiedono di aggiornare il server di tagging.

Tag Manager può mostrare messaggi in cui ti viene chiesto di aggiornare il server di tagging fino a un giorno dopo il corretto aggiornamento del server. Tuttavia, la pagina di anteprima mostrerà un messaggio aggiornato sulla versione del server di tagging.