Cómo configurar la ruta de publicación propia

La función de ruta de publicación propia te permite recuperar la dirección IP sin enmascarar del usuario enrutando una solicitud a través de tu red de distribución de contenidos (CDN) o infraestructura web a los servidores de anuncios de Google.

En las solicitudes de terceros, las funciones del navegador y del SO, y las configuraciones de red pueden enmascarar las direcciones IP. Este enmascaramiento puede afectar tus ingresos publicitarios, la segmentación geográfica y la detección de tráfico no válido (IVT).

Tu CDN recibe la IP del cliente sin enmascarar de un usuario en todas las solicitudes entrantes a tu dominio. Esta función ofrece los siguientes beneficios:

  • No se realizan cambios en el código del cliente: No editas JavaScript ni pasas parámetros de forma manual. La etiqueta de Google Publisher Tag (GPT) lee la ruta de acceso configurada en tu configuración de Google Ad Manager y ejecuta la solicitud de recuperación de forma asíncrona.
  • Menos sobrecarga: La solicitud es liviana, se almacena en caché de forma local por sesión de vista de página y se ejecuta de forma asíncrona junto con las definiciones de los espacios publicitarios.
  • Carga útil encriptada: De forma predeterminada, esta función devuelve la dirección IP del usuario como una carga útil encriptada.

En esta página, se explica cómo configurar la ruta de publicación propia en tu CDN preferida.

Requisitos previos

Antes de configurar tu CDN, haz lo siguiente:

  • Especifica una ruta de publicación en tu cuenta de Ad Manager, por ejemplo, /adserver/. Para especificar la ruta de acceso, sigue los pasos que se indican en el Método 1: Ruta de acceso de publicación propia.
    • Asegúrate de que la ruta de entrega sea única y de que no haya tráfico que envíes que use esta ruta.
  • Ten o configura los siguientes elementos:
    • Host o destino de origen: securepubads.g.doubleclick.net
    • Ruta de destino: /pagead/fpm
    • Protocolo: HTTPS con el puerto predeterminado 443.
    • Encabezados: Establece el encabezado como Host: securepubads.g.doubleclick.net.
    • Almacenamiento en caché: Configura tu CDN para omitir el almacenamiento en caché de una ruta, por ejemplo, establece las políticas de almacenamiento en caché para omitir la caché o el encabezado Cache-Control: no-store.
  • Si tu CDN es Cloudflare, debes tener un nivel Enterprise de Cloudflare para crear una regla de origen.

Configura tu CDN

Configura tu CDN o proxy inverso para reenviar las solicitudes que coincidan con la ruta de acceso configurada a los servidores de anuncios de Google. Selecciona la CDN que prefieras:

Cloudflare

  1. Crea una regla en el panel con los siguientes valores:

    • Expresión de filtro personalizada: Agrega lo siguiente:
      • Campo: URI Path
      • Operador: starts with
      • Valor: Tu ruta, por ejemplo, /adserver/.
    • Anulación del encabezado del host: Selecciona Reescribir en y agrega el host de destino securepubads.g.doubleclick.net.
    • Anulación de DNS: Selecciona Anular a y agrega el host de destino securepubads.g.doubleclick.net.

  2. Crea una reescritura de regla de URL en el panel con los siguientes valores:

    • Expresión de filtro personalizada: Agrega lo siguiente:
      • Campo: URI Path
      • Operador: starts with
      • Valor: Tu ruta, por ejemplo, /adserver/.
    • Ruta de acceso: Selecciona Reescribir en > Estática > y agrega la ruta de acceso de destino de /pagead/fpm.
    • Consulta: Selecciona Conservar.

Amazon CloudFront

  1. Sigue los pasos que se indican en Configuración de origen con los siguientes valores:

    • Dominio de origen: securepubads.g.doubleclick.net
    • Protocolo: HTTPS

  2. Sigue las instrucciones para crear funciones y agrega el siguiente ejemplo:

    function handler(event) {
    var request = event.request;
    request.uri = '/pagead/fpm';
    return request;
}

    En este ejemplo, se toma el evento de solicitud entrante, se asigna el URI a la ruta de acceso de destino y se devuelve la solicitud.

    Haz clic en Guardar cambios, navega a la pestaña Publicar y haz clic en Publicar función.

  3. Sigue los pasos que se indican en Actualiza una distribución en la consola con los siguientes valores:

    • Patrón de ruta de acceso: Es tu ruta de acceso, por ejemplo, /adserver/*.
    • Origen y grupos de origen: el host de destino, securepubads.g.doubleclick.net.
    • Política de caché: Selecciona CachingDisabled.
    • Política de solicitud de origen: Selecciona AllViewerExceptHostHeader.
    • Asociaciones de funciones:
      • Solicitud del visualizador: Selecciona Función de CloudFront y agrega el nombre de tu función.

Fastly

  1. Sigue las instrucciones para agregar un host con los siguientes valores:

    • Address: el host de destino, securepubads.g.doubleclick.net
    • Puerto: el puerto predeterminado, 443.
    • ¿Quieres habilitar TLS?: Sí
      • Nombre de host del certificado: securepubads.g.doubleclick.net
        • Selecciona Hacer coincidir el nombre de host de SNI con el nombre del certificado.
      • Nombre de host de SNI: securepubads.g.doubleclick.net
      • Anular host: securepubads.g.doubleclick.net

  2. Sigue las instrucciones para crear fragmentos de VCL con el siguiente ejemplo:

    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);
}

    Reemplaza lo siguiente:

    • NAME: Es el nombre del host, por ejemplo, Google_GAM_FPM_Backend.
    • PATH: tu ruta de acceso, por ejemplo, /adserver/.

Google Cloud

  1. Sigue los pasos que se indican en Crea el NEG y el extremo de Internet con los valores que se indican a continuación:

    • Tipo de grupo de extremos de red: Selecciona NEG de Internet (global)
    • Puerto predeterminado: 443
    • Nuevo extremo de red: Selecciona Nombre de dominio completamente calificado (FQDN) y puerto.
    • FQDN: Agrega el host de destino, securepubads.g.doubleclick.net.

  2. Crea tu servicio de backend global y configura encabezados de la solicitud personalizados con los siguientes valores:

    • Tipo de backend: Selecciona Grupo de extremos de red de Internet.
    • Protocolo: Selecciona HTTPS.
      • Nombre del encabezado: Host
      • Valor del encabezado: Agrega el host de destino, securepubads.g.doubleclick.net.

  3. Sigue los pasos que se indican en Configura mapas de URL.

  4. En Reglas de enrutamiento, busca la regla de host de producción que coincida con tu subdominio.

    Actualiza los comparadores de rutas con la configuración de 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

    Reemplaza lo siguiente:

    • BACKEND_NAME: el nombre del servicio de backend que creaste en el paso 2, por ejemplo, gam-fpm-backend-service.
    • DEFAULT_BACKEND: Es el servicio de backend predeterminado que aloja tu sitio web.
      • Si alojas tu sitio web en Cloud Storage, reemplaza backendServices por el parámetro backendBuckets en la ruta de acceso del recurso del campo defaultService.
    • NAME: el nombre del comparador de rutas de acceso, por ejemplo, gam-fpm-matcher.
    • PATH: tu ruta de acceso, por ejemplo, /adserver/.
    • PROJECT_ID: Es el ID del proyecto.

Cómo probar tu implementación

Para verificar que tu CDN use un proxy para la solicitud y pase la dirección IP, ejecuta una prueba con el comando curl:

curl -i https://example.comPATH

Reemplaza PATH por tu ruta de acceso, por ejemplo, /adserver/.

Si se ejecuta de forma correcta, obtendrás el siguiente resultado:

  • Estado HTTP: 200 OK
  • Contenido de la respuesta: Es una carga útil de los servidores de backend de Google que, de forma predeterminada, contiene un token de IP encriptado.

Soluciona problemas de implementación

En esta sección, se describen los flujos de trabajo para solucionar problemas de tu implementación de la ruta de publicación propia en tu CDN.

En la siguiente tabla, se detallan los problemas, las causas y las soluciones para solucionar problemas:

Problema Causa Solución
Recibes el estado HTTP 404 o 502 de tu CDN La reescritura de ruta de acceso no está activa o falta el encabezado Host. Verifica que tu reescritura se asigne a la ruta de destino /pagead/fpm y que el encabezado Host se anule al host de destino, securepubads.g.doubleclick.net.
La dirección IP no se actualiza en las solicitudes de anuncios. Almacenamiento en caché habilitado en el proxy de CDN Asegúrate de establecer la política de caché en la ruta a la política CachingDisabled o al encabezado Cache-Control: no-store. Cada cliente debe llegar al servicio de backend para evaluar su dirección IP específica.
Falla en el protocolo de enlace SSL o TLS No coincidencia de SNI en la conexión de origen del backend Asegúrate de haber configurado tu CDN para que envíe el host de destino securepubads.g.doubleclick.net en la extensión de SNI de TLS.
Falta el parámetro ips en la solicitud de anuncio. La ruta de acceso de Ad Manager no coincide con la de la CDN Verifica que la ruta ingresada en la página Configuración global de la IU de Ad Manager coincida con la ruta configurada en tu CDN. Para obtener más detalles, consulta Pasar la IP proporcionada por el publicador sin enmascarar (beta).