Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Configura il percorso di pubblicazione proprietario

La funzionalità Percorso di pubblicazione proprietario ti consente di recuperare l'indirizzo IP utente in chiaro instradando una richiesta tramite la rete CDN (Content Delivery Network) o l'infrastruttura web agli ad server di Google.

Nelle richieste di terze parti, le funzionalità del browser e del sistema operativo e le configurazioni di rete potrebbero mascherare gli indirizzi IP. Questo mascheramento potrebbe influire sulle entrate pubblicitarie, sul targeting geografico e sul rilevamento del traffico non valido (IVT).

La tua CDN riceve l'IP client in chiaro di un utente su tutte le richieste in entrata al tuo dominio. Questa funzionalità offre i seguenti vantaggi:

Nessuna modifica al codice lato client: non devi modificare JavaScript o passare i parametri manualmente. Il Tag publisher di Google (GPT) legge il percorso configurato dalle impostazioni di Google Ad Manager ed esegue la richiesta di recupero in modo asincrono.
Meno overhead: la richiesta è leggera, memorizzata nella cache localmente per sessione di visualizzazione di pagina ed eseguita in modo asincrono insieme alle definizioni delle aree annuncio.
Payload criptato: per impostazione predefinita, questa funzionalità restituisce l'indirizzo IP dell'utente come payload criptato.

Questa pagina illustra come configurare il percorso di pubblicazione proprietario per la CDN che preferisci.

Prerequisiti

Prima di configurare la CDN, segui questi passaggi:

Specifica un percorso di pubblicazione nel tuo account Ad Manager, ad esempio /adserver/. Per specificare il percorso, segui i passaggi descritti in Metodo 1: percorso di pubblicazione proprietario.
- Assicurati che il percorso di pubblicazione sia univoco e che il traffico che invii non utilizzi questo percorso.
Disporre o impostare i seguenti elementi:
- Host o origine di destinazione: securepubads.g.doubleclick.net
- Percorso di destinazione: /pagead/fpm
- Protocollo: HTTPS con la porta predefinita 443.
- Intestazioni: imposta l'intestazione su Host: securepubads.g.doubleclick.net.
- Memorizzazione nella cache: configura la CDN in modo da bypassare la memorizzazione nella cache per una route, ad esempio imposta le policy della cache su Ignora cache o sull'intestazione Cache-Control: no-store.
Se la tua CDN è Cloudflare, devi disporre di un livello Cloudflare Enterprise per creare una regola di origine.

Configura la tua CDN

Configura la tua CDN o il tuo reverse proxy in modo che inoltri le richieste corrispondenti al percorso configurato agli ad server di Google. Seleziona la CDN che preferisci:

Cloudflare

Crea una regola nella dashboard con i seguenti valori:
- Espressione di filtro personalizzata: aggiungi quanto segue:
  - Campo: URI Path
  - Operatore: starts with
  - Valore: il tuo percorso, ad esempio /adserver/.
- Override dell'intestazione host: seleziona Riscrivi in e aggiungi l'host di destinazione securepubads.g.doubleclick.net.
- Override DNS: seleziona Esegui l'override a e aggiungi l'host di destinazione securepubads.g.doubleclick.net.
Crea una riscrittura della regola URL nella dashboard con i seguenti valori:
- Espressione di filtro personalizzata: aggiungi quanto segue:
  - Campo: URI Path
  - Operatore: starts with
  - Valore: il tuo percorso, ad esempio /adserver/.
- Percorso: seleziona Riscrivi in > Statico > e aggiungi il percorso di destinazione /pagead/fpm.
- Query: seleziona Conserva.

Amazon Cloudfront

Segui i passaggi descritti in Impostazioni origine con i seguenti valori:
- Dominio di origine: securepubads.g.doubleclick.net
- Protocollo: HTTPS
Segui i passaggi per creare funzioni e aggiungi il seguente esempio:
```
function handler(event) {
    var request = event.request;
    request.uri = '/pagead/fpm';
    return request;
}
```
Questo esempio prende l'evento della richiesta in entrata, assegna l'URI al percorso di destinazione e restituisce la richiesta.

Fai clic su Salva modifiche, vai alla scheda Pubblica e fai clic su Pubblica funzione.
Segui i passaggi descritti in Aggiorna una distribuzione nella console con i seguenti valori:
- Pattern del percorso: il tuo percorso, ad esempio /adserver/*.
- Origine e gruppi di origini: l'host di destinazione, securepubads.g.doubleclick.net.
- Policy della cache: seleziona CachingDisabled.
- Policy delle richieste di origine: seleziona AllViewerExceptHostHeader.
- Associazioni di funzioni:
  - Richiesta visualizzatore: seleziona Funzione CloudFront e aggiungi il nome della funzione.

Fastly

Segui la procedura per aggiungere un host con i seguenti valori:
- Indirizzo: l'host di destinazione, securepubads.g.doubleclick.net
- Porta: la porta predefinita, 443.
- Abilitare TLS?: Sì
  - Nome host del certificato: securepubads.g.doubleclick.net
    - Seleziona Abbina il nome host SNI al nome del certificato.
  - Nome host SNI: securepubads.g.doubleclick.net
  - Override host: securepubads.g.doubleclick.net
Segui la procedura per la creazione di snippet VCL con il seguente esempio:
```
if (req.url ~ "^PATH") {
    set req.backend = F_NAME;
    set req.http.Host = "securepubads.g.doubleclick.net";
    set req.url = regsub(req.url, "^PATH", "/pagead/fpm");
    return(pass);
}
```
Sostituisci quanto segue:
- NAME: il nome dell'host, ad esempio Google_GAM_FPM_Backend.
- PATH: il tuo percorso, ad esempio /adserver/.

Google Cloud

Segui la procedura descritta in Crea il NEG e l'endpoint internet con i seguenti valori:
- Tipo di gruppo di endpoint di rete: seleziona NEG internet (globale)
- Porta predefinita: 443
- Nuovo endpoint di rete: seleziona Nome di dominio completo (FQDN) e porta.
- FQDN: aggiungi l'host di destinazione, securepubads.g.doubleclick.net.
Crea il servizio di backend globale e configura le intestazioni della richiesta personalizzate con i seguenti valori:
- Tipo di backend: seleziona Gruppo di endpoint di rete internet.
- Protocollo: seleziona HTTPS.
  - Nome intestazione: Host
  - Valore intestazione: aggiungi l'host di destinazione, securepubads.g.doubleclick.net.
Segui i passaggi descritti in Configura le mappe URL.
In Regole di routing, individua la regola host di produzione corrispondente al tuo sottodominio.

Aggiorna i matcher percorso con la configurazione routeRules:
```
name: NAME
defaultService: projects/PROJECT_ID/global/backendServices/DEFAULT_BACKEND
routeRules:
  - priority: 1
    matchRules:
      - prefixMatch: PATH
    service: projects/PROJECT_ID/global/backendServices/BACKEND_NAME
    routeAction:
      urlRewrite:
        pathPrefixRewrite: /pagead/fpm
```
Sostituisci quanto segue:
- BACKEND_NAME: il nome del servizio di backend che hai creato nel passaggio 2, ad esempio gam-fpm-backend-service.
- DEFAULT_BACKEND: il servizio di backend predefinito che ospita il tuo sito web.
  - Se ospiti il tuo sito web su Cloud Storage, sostituisci backendServices con il parametro backendBuckets nel percorso della risorsa del campo defaultService.
- NAME: il nome del matcher di percorso, ad esempio gam-fpm-matcher.
- PATH: il tuo percorso, ad esempio /adserver/.
- PROJECT_ID: il tuo ID progetto.

Verificare la tua implementazione

Per verificare che la CDN funga da proxy per la richiesta e trasmetta l'indirizzo IP, esegui un test utilizzando il comando curl:

curl -i https://example.comPATH

Sostituisci PATH con il tuo percorso, ad esempio /adserver/.

Se l'operazione riesce, ricevi il seguente output:

Stato HTTP: 200 OK
Contenuto della risposta: un payload dai server di backend di Google che contiene un token IP criptato per impostazione predefinita.

Risolvi i problemi relativi all'implementazione

Questa sezione illustra i workflow per risolvere i problemi relativi all'implementazione del percorso di pubblicazione proprietario nella CDN.

La tabella seguente descrive i problemi, le cause e le soluzioni per la risoluzione dei problemi:

Problema	Causa	Soluzione
Ricevi lo stato HTTP 404 o 502 dalla tua CDN	La riscrittura del percorso non è attiva o l'intestazione `Host` non è presente.	Verifica che le mappe di riscrittura corrispondano al percorso di destinazione `/pagead/fpm` e che l'intestazione `Host` venga sostituita con l'host di destinazione `securepubads.g.doubleclick.net`.
L'indirizzo IP non viene aggiornato nelle richieste di annunci.	Memorizzazione nella cache abilitata sul proxy CDN	Assicurati di impostare la policy della cache sulla route in base alla policy `CachingDisabled` o all'intestazione `Cache-Control: no-store`. Ogni client deve raggiungere il servizio di backend per valutare il proprio indirizzo IP specifico.
Errore di TLS handshake o SSL handshake	Mancata corrispondenza SNI sulla connessione di origine del backend	Assicurati di aver configurato la CDN in modo che invii l'host di destinazione `securepubads.g.doubleclick.net` nell'estensione TLS SNI.
Parametro `ips` mancante nella richiesta di annuncio.	Il percorso di Ad Manager non corrisponde al percorso della CDN	Verifica che il percorso inserito nella pagina Impostazioni globali della UI di Ad Manager corrisponda al percorso configurato sulla CDN. Per maggiori dettagli, consulta Passa l'IP fornito dal publisher in chiaro (beta).