Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Configurer le chemin de diffusion propriétaire

La fonctionnalité de chemin de diffusion first party vous permet de récupérer l'adresse IP non masquée de l'utilisateur en acheminant une requête vers les ad servers Google via votre réseau de diffusion de contenu (CDN) ou votre infrastructure Web.

Sur les requêtes tierces, les fonctionnalités du navigateur et de l'OS, ainsi que les configurations réseau, peuvent masquer les adresses IP. Ce masquage peut avoir un impact sur vos revenus publicitaires, votre ciblage géographique et la détection du trafic non valide.

Votre CDN reçoit l'adresse IP client non masquée d'un utilisateur pour toutes les requêtes entrantes vers votre domaine. Cette fonctionnalité présente les avantages suivants :

Aucune modification du code côté client : vous ne modifiez pas le code JavaScript ni ne transmettez de paramètres manuellement. Google Publisher Tag (GPT) lit le chemin configuré dans vos paramètres Google Ad Manager et exécute la demande de récupération de manière asynchrone.
Moins de frais généraux : la requête est légère, mise en cache localement par session de page vue et s'exécute de manière asynchrone avec les définitions d'espaces publicitaires.
Charge utile chiffrée : par défaut, cette fonctionnalité renvoie l'adresse IP de l'utilisateur sous la forme d'une charge utile chiffrée.

Cette page explique comment configurer le chemin de diffusion first party vers votre CDN préféré.

Prérequis

Avant de configurer votre CDN, procédez comme suit :

Spécifiez un chemin de diffusion dans votre compte Ad Manager, par exemple /adserver/. Pour spécifier le chemin d'accès, suivez la procédure décrite dans Méthode 1 : Chemin de diffusion first party.
- Assurez-vous que votre chemin de diffusion est unique et qu'aucun trafic que vous envoyez n'utilise ce chemin.
Disposer des éléments suivants ou les définir :
- Hôte ou origine cible : securepubads.g.doubleclick.net
- Chemin cible : /pagead/fpm
- Protocole : HTTPS avec le port par défaut 443.
- En-têtes : définissez l'en-tête sur Host: securepubads.g.doubleclick.net.
- Mise en cache : configurez votre CDN pour contourner la mise en cache d'une route. Par exemple, définissez les règles de cache pour contourner le cache ou l'en-tête Cache-Control: no-store.
Si votre CDN est Cloudflare, vous devez disposer d'un niveau Cloudflare Enterprise pour créer une règle d'origine.

Configurer votre CDN

Configurez votre CDN ou votre proxy inverse pour qu'il transfère les requêtes correspondant au chemin d'accès configuré vers les ad servers Google. Sélectionnez le CDN de votre choix :

Cloudflare

Créez une règle dans le tableau de bord avec les valeurs suivantes :
- Expression de filtre personnalisée : ajoutez ce qui suit :
  - Champ : URI Path
  - Opérateur : starts with
  - Valeur : votre chemin d'accès, par exemple /adserver/.
- Remplacement de l'en-tête d'hôte : sélectionnez Réécrire vers et ajoutez l'hôte cible securepubads.g.doubleclick.net.
- Remplacement DNS : sélectionnez Remplacer par et ajoutez l'hôte cible securepubads.g.doubleclick.net.
Créez une règle de réécriture d'URL dans le tableau de bord avec les valeurs suivantes :
- Expression de filtre personnalisée : ajoutez ce qui suit :
  - Champ : URI Path
  - Opérateur : starts with
  - Valeur : votre chemin d'accès, par exemple /adserver/.
- Chemin d'accès : sélectionnez Réécrire vers > Statique > et ajoutez le chemin d'accès cible /pagead/fpm.
- Requête : sélectionnez Conserver.

Amazon CloudFront

Suivez la procédure décrite dans Paramètres d'origine avec les valeurs suivantes :
- Domaine d'origine : securepubads.g.doubleclick.net
- Protocole : HTTPS
Suivez les instructions de la section Créer des fonctions et ajoutez l'exemple suivant :
```
function handler(event) {
    var request = event.request;
    request.uri = '/pagead/fpm';
    return request;
}
```
Cet exemple prend l'événement de requête entrant, attribue l'URI au chemin d'accès cible et renvoie la requête.

Cliquez sur Enregistrer les modifications, accédez à l'onglet Publier, puis cliquez sur Publier la fonction.
Suivez la procédure Mettre à jour une distribution dans la console avec les valeurs suivantes :
- Format de chemin d'accès : votre chemin d'accès, par exemple /adserver/*.
- Origine et groupes d'origines : l'hôte cible, securepubads.g.doubleclick.net.
- Stratégie de cache : sélectionnez CachingDisabled.
- Stratégie de requête d'origine : sélectionnez AllViewerExceptHostHeader.
- Associations de fonctions :
  - Requête du lecteur : sélectionnez Fonction CloudFront, puis ajoutez le nom de votre fonction.

Fastly

Suivez la procédure Ajouter un hôte avec les valeurs suivantes :
- Adresse : l'hôte cible, securepubads.g.doubleclick.net
- Port : port par défaut, 443.
- Activer TLS ? : Oui
  - Nom d'hôte du certificat : securepubads.g.doubleclick.net
    - Sélectionnez Faire correspondre le nom d'hôte SNI au nom du certificat.
  - Nom d'hôte SNI : securepubads.g.doubleclick.net
  - Hôte de remplacement : securepubads.g.doubleclick.net
Suivez la procédure Créer des extraits VCL avec l'exemple suivant :
```
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);
}
```
Remplacez les éléments suivants :
- NAME : nom de l'hôte, par exemple Google_GAM_FPM_Backend.
- PATH : votre chemin d'accès, par exemple /adserver/.

Google Cloud

Suivez la procédure Créer le NEG et le point de terminaison Internet avec les valeurs suivantes :
- Type de groupe de points de terminaison du réseau : sélectionnez NEG Internet (global).
- Port par défaut : 443
- Nouveau point de terminaison du réseau : sélectionnez Nom de domaine complet (FQDN) et port.
- FQDN : ajoutez l'hôte cible, securepubads.g.doubleclick.net.
Créez votre service de backend global et configurez des en-têtes de requête personnalisés avec les valeurs suivantes :
- Type de backend : sélectionnez Groupe de points de terminaison du réseau Internet.
- Protocole : sélectionnez HTTPS.
  - Nom de l'en-tête : Host
  - Valeur d'en-tête : ajoutez l'hôte cible, securepubads.g.doubleclick.net.
Suivez la procédure décrite dans Configurer des mappages d'URL.
Dans Règles de routage, recherchez la règle d'hôte de production qui correspond à votre sous-domaine.

Mettez à jour les outils de mise en correspondance des chemins d'accès avec la configuration 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
```
Remplacez les éléments suivants :
- BACKEND_NAME : nom du service de backend que vous avez créé à l'étape 2, par exemple gam-fpm-backend-service.
- DEFAULT_BACKEND : service de backend par défaut qui héberge votre site Web.
  - Si vous hébergez votre site Web sur Cloud Storage, remplacez backendServices par le paramètre backendBuckets dans le chemin d'accès à la ressource du champ defaultService.
- NAME : nom de l'outil de mise en correspondance des chemins d'accès, par exemple gam-fpm-matcher.
- PATH : votre chemin d'accès, par exemple /adserver/.
- PROJECT_ID : ID de votre projet.

Tester la mise en œuvre

Pour vérifier que votre CDN transmet la requête par proxy et transmet l'adresse IP, exécutez un test à l'aide de la commande curl :

curl -i https://example.comPATH

Remplacez PATH par votre chemin d'accès, par exemple /adserver/.

Si l'opération réussit, vous obtenez le résultat suivant :

État HTTP : 200 OK
Contenu de la réponse : charge utile des serveurs backend Google contenant un jeton d'adresse IP chiffré par défaut.

Résoudre les problèmes d'implémentation

Cette section décrit les workflows permettant de résoudre les problèmes liés à l'implémentation du chemin de diffusion first party dans votre CDN.

Le tableau suivant détaille les problèmes, les causes et les solutions pour résoudre les problèmes :

Problème	Cause	Solution
Vous recevez l'état HTTP 404 ou 502 de votre CDN	La réécriture du chemin d'accès n'est pas active ou l'en-tête `Host` est manquant.	Vérifiez que vos mappages de réécriture vers le chemin cible `/pagead/fpm` et l'en-tête `Host` sont remplacés par l'hôte cible, `securepubads.g.doubleclick.net`.
L'adresse IP n'est pas mise à jour dans les demandes d'annonces.	Mise en cache activée sur le proxy CDN	Assurez-vous de définir la règle de cache sur la route vers la règle `CachingDisabled` ou l'en-tête `Cache-Control: no-store`. Chaque client doit accéder au service de backend pour évaluer son adresse IP spécifique.
Échec du handshake SSL ou TLS	Incohérence SNI sur la connexion à l'origine du backend	Assurez-vous d'avoir configuré votre CDN pour qu'il envoie l'hôte cible `securepubads.g.doubleclick.net` dans l'extension TLS SNI.
Le paramètre `ips` est manquant dans la demande d'annonce.	Le chemin d'accès Ad Manager ne correspond pas au chemin d'accès CDN	Vérifiez que le chemin d'accès saisi sur la page Paramètres généraux de l'interface utilisateur d'Ad Manager correspond à celui configuré sur votre CDN. Pour en savoir plus, consultez Transmettre l'adresse IP non masquée fournie par l'éditeur (bêta).