Extrae datos geográficos para experimentos

En el caso de las extracciones de datos automatizadas o a gran escala para los experimentos de GeoX, debes usar la API de Google Ads para extraer los datos de costos y de inversión. Luego, combinas estos datos con datos de conversiones o ingresos sin procesar, sin filtrar y sin atribución de tu CRM interno, un punto de venta (PdV) o bases de datos de ventas internas.

Arquitectura recomendada del flujo de trabajo de la API

Para extraer con precisión los datos de costos y campañas por segmentos geográficos, sigue esta arquitectura:

• Servicio: Usa GoogleAdsService, específicamente los métodos Search o SearchStream.

• Recurso: Consulta geographic_view para ver dónde se encontraba físicamente el usuario o en qué ubicación estaba interesado, lo que suele ser el estándar para los experimentos de GeoX. Como alternativa, consulta location_view para ver el rendimiento en función de las ubicaciones de segmentación específicas de la campaña.

  Nota: No uses campaign_location_target_report, ya que este informe heredado de la API de AdWords se retiró.

• Campos para incluir:

  • campaign.id
  • segments.date
  • segments.geo_target_city (o región o país, según el nivel de detalle de GeoX)
  • metrics.cost_micros

• Consulta de GAQL de ejemplo: Para GeoX, los anunciantes extraen las métricas de costos con la API de Google Ads en lugar de las conversiones atribuidas (que deberían provenir de sistemas de CRM internos o de terceros). Puedes usar la siguiente consulta:

  SELECT
    campaign.id,
    segments.date,
    segments.geo_target_city,
    metrics.cost_micros
  FROM geographic_view
  WHERE segments.date DURING LAST_30_DAYS
  

  Nota: geographic_view solo devuelve filas para los segmentos geográficos que registraron impresiones o inversión en una fecha determinada. Para incluir los días y las regiones sin inversión en tu serie temporal de GeoX, realiza una unión externa izquierda en tu canalización de datos con el producto cartesiano completo de las fechas y las regiones de segmentación.

Nota: Si extraes métricas de conversiones de Google Ads, extraerás conversiones atribuidas, lo que significa que solo verás las ventas por las que el algoritmo de Google ya se atribuyó el crédito. No se recomienda usar datos atribuidos en GeoX, ya que la lógica de atribución sesga la medición causal.

Posprocesamiento y extracción de datos

• Asignación de segmentos geográficos: La API no devuelve nombres de texto sin formato (como "Nueva York") ni códigos cortos (como "501" o "ES") en las vistas de informes. Los campos como segments.geo_target_city o segments.geo_target_country devuelven una cadena de nombre de recurso que apunta a un GeoTargetConstant (por ejemplo, geoTargetConstants/1023191). Extrae el ID numérico (1023191) y consulta el recurso geo_target_constant:

  SELECT
    geo_target_constant.id,
    geo_target_constant.name,
    geo_target_constant.canonical_name
  FROM geo_target_constant
  WHERE geo_target_constant.id = 1023191
  

  Como alternativa, para realizar la unión de forma local en el código, descarga el archivo CSV de las regiones geográficas de segmentación estáticas en Ubicaciones geográficas de segmentación.

• Conversión de costos: La API devuelve los valores de costo en microunidades. Debes dividir metrics.cost_micros por 1,000,000 para obtener el valor de moneda estándar que se requiere en tu archivo de carga.

IDs de ubicación geográfica para mutaciones de segmentación

Cuando se ejecutan mutaciones de segmentación geográfica de campañas o grupos de anuncios, los anunciantes deben buscar y pasar el ID de GeoTargetConstant (geoTargetConstants/ID) exacto para las regiones seleccionadas. No puedes pasar códigos ISO o Nielsen sin procesar.

Tipo de región	ID de la API requerida (GeoTargetConstant)	Formato heredado (no usar)
Región de DMA	ID 200501 (para Nueva York)	Código de Nielsen (por ejemplo, 501 para Nueva York)
País	ID 2724 (para España)	Código ISO (por ejemplo, "ES" para España)

Prácticas recomendadas y errores de formato comunes

• Formato de fecha: El campo segments.date devuelve cadenas de fecha ISO-8601 en el formato YYYY-MM-DD. En tu canalización de ETL, serializa los campos de fecha de forma explícita como cadenas YYYY-MM-DD y evita abrir archivos CSV exportados en aplicaciones de hojas de cálculo que vuelven a dar formato automáticamente a las columnas de fecha.
• Ceros a la izquierda en los códigos postales: Trata los códigos postales (por ejemplo, 01234) como tipos de cadena (VARCHAR o STRING) en toda la canalización de datos, en lugar de números enteros, para que nunca se quiten los ceros a la izquierda.
• Agregación: Si ejecutas un estudio de varias celdas, debes proporcionar métricas de inversión separadas para cada grupo de tratamiento.
• Une los datos de conversiones: Cuando unas los datos de conversiones de un sistema de CRM interno o de bases de datos de ventas internas, asegúrate de que los datos de conversiones tengan las siguientes propiedades para garantizar un procesamiento de datos sin problemas con los datos de la API de Google Ads y GeoX:
  • Series temporales diarias: Los datos deben agregarse por día.
  • Nivel geográfico: Cada conversión se debe asignar a las unidades geográficas exactas que estás probando (por ejemplo, hacer coincidir el código postal de envío del cliente con el DMA o el clúster postal que se usa en el diseño).
  • Valores brutos: Los datos deben ser valores absolutos no negativos, como los ingresos brutos o los recuentos de conversiones brutos. Si tu CRM hace un seguimiento de los ingresos netos con valores negativos para los reembolsos, debes usar las cifras brutas para el experimento y aplicar un porcentaje de reembolso más adelante.