Segmentación

La segmentación está disponible en la IU de Google Ads como un menú independiente. Puedes implementar la segmentación en la API de Google Ads agregando el campo adecuado a una consulta. Por ejemplo, supongamos que agregas segments.device a una consulta. Esto genera un informe con una fila para cada combinación de dispositivo y el recurso especificado en la cláusula FROM, y los valores estadísticos (impresiones, clics, conversiones, etc.) divididos entre ellos.

En la IU de Google Ads, solo se puede usar un segmento a la vez, pero con la API puedes especificar varios segmentos en la misma consulta.

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions
FROM campaign

Los resultados de enviar esta consulta a GoogleAdsService.SearchStream se parecen a esta cadena JSON:

{
  "results":[
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"10922"
      },
      "segments":{
        "device":"MOBILE"
      }
    },
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"28297"
      },
      "segments":{
        "device":"DESKTOP"
      }
    }
  ]
}

En este resultado de muestra, los atributos del primer y segundo objeto, incluido el nombre del recurso, son los mismos. Las impresiones se segmentan por dispositivo y, por lo tanto, se pueden devolver dos o más objetos para la misma campaña.

Precaución: Por cada campo de segmento adicional que se incluya en la consulta de tu informe, la cantidad de filas puede aumentar de forma exponencial.

Segmentación implícita

Cada informe se segmenta inicialmente por el recurso especificado en la cláusula FROM. Se devuelve el campo resource_name del recurso en la cláusula FROM y las métricas se segmentan según este, incluso cuando el campo resource_name no se incluye explícitamente en la consulta. Por ejemplo, cuando especificas ad_group como el recurso en la cláusula FROM, ad_group.resource_name se devuelve automáticamente y las métricas se segmentan de forma implícita en función de él en el nivel de ad_group.

Por lo tanto, para esta consulta:

SELECT metrics.impressions
FROM ad_group

Obtendrás una cadena JSON como esta:

{
  "results":[
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/2222222222"
      },
      "metrics":{
        "impressions":"237"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/33333333333"
      },
      "metrics":{
        "impressions":"15"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/44444444444"
      },
      "metrics":{
        "impressions":"0"
      }
    }
  ]
}

Siempre se devuelve el campo resource_name de adGroup porque ad_group se especifica como un recurso en la cláusula FROM.

search_term_view

El recurso search_term_view también se segmenta de forma implícita por grupo de anuncios, no solo por término de búsqueda, como se refleja en la estructura de su nombre de recurso, que también incluye el grupo de anuncios. Por lo tanto, es posible que recibas filas aparentemente duplicadas con los mismos términos de búsqueda en tus resultados cuando esas filas pertenezcan a diferentes grupos de anuncios:

{
  "results":[
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"3"
      },
      "segments":{
        "date":"2024-06-15"
      }
    },
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"2"
      },
      "segments":{
        "date":"2024-06-15"
      }
    }
  ]
}

Aunque los dos objetos que se muestran en este ejemplo parecen duplicados, sus nombres de recursos son diferentes, en especial en la parte del ID del grupo de anuncios. Esto significa que el término de búsqueda "google photos" se atribuye a dos grupos de anuncios (ID 2222222222 y 33333333333) en la misma fecha (2024-06-15). Por lo tanto, la API funcionó según lo previsto y no devolvió objetos duplicados en este caso.

Punto clave: Técnicamente, el recurso search_term_view también se segmenta de forma implícita por una campaña. Sin embargo, un grupo de anuncios siempre debe pertenecer a una campaña, por lo que usar solo el grupo de anuncios para anular la duplicación de filas de datos es suficiente, ya que un grupo de anuncios es la unidad más detallada.

Campos de segmento seleccionables

No todos los campos de segmento se pueden seleccionar para un recurso determinado en la cláusula FROM. Por ejemplo, supongamos que sigues consultando desde el recurso ad_group. Para que se pueda seleccionar un campo de segmento del recurso ad_group, ese campo debe existir en la lista Segments de ad_group. La lista Segments es la parte amarilla de la tabla de campos disponibles en la página de metadatos del recurso ad_group.

Nota: La disponibilidad de los segmentos en recursos específicos puede variar según la versión de la API. Usa el selector de versión en la referencia de FieldService de Google Ads para verificar la compatibilidad de tu versión de destino (v23, v24, v25 o v26). Por ejemplo, en la versión 24 y posteriores, no se puede seleccionar segments.click_type con ad_group_asset, campaign_asset ni customer_asset, y no se puede seleccionar segments.ad_sub_network_type con campaign_budget (estas combinaciones solo se admiten en la versión 23).

Recursos de segmentos

Cuando seleccionas algunos recursos, puedes unirte de forma implícita a los recursos relacionados seleccionando sus campos junto con los campos del recurso en la cláusula FROM. Estos recursos relacionados se pueden encontrar en la lista Attributed Resources del recurso en la página de metadatos de la cláusula FROM. En el caso del recurso ad_group, verás que también puedes seleccionar campos del recurso campaign. El campo resource_name de cualquier Attributed Resources con al menos un campo en la cláusula SELECT se devuelve automáticamente, incluso cuando el campo resource_name no se incluye de forma explícita en la consulta.

Al igual que cuando seleccionas campos Attributed Resource, también puedes seleccionar campos Segmenting Resource. Si un recurso determinado tiene una lista de Segmenting Resources en su página de metadatos, seleccionar campos de uno de esos recursos de la lista hace que la consulta se segmente aún más por el resource_name devuelto de ese Segmenting Resource. Por ejemplo, verás que el recurso campaign aparece como un Segmenting Resource para el recurso campaign_budget. Si seleccionas cualquier campo de campaña, como campaign.name, del recurso campaign_budget, no solo se devolverá el campo campaign.name, sino que también se devolverá y segmentará el campo campaign.resource_name.

Selección entre segmentos y métricas

Es posible que un campo de segmento determinado no sea compatible con algunos de los otros campos de segmento o con algunos de los campos de métricas. Para identificar qué campos de segmento son compatibles entre sí, revisa la lista selectable_with de los segmentos en la cláusula SELECT.

En el caso del recurso ad_group, hay más de 50 segmentos disponibles que puedes seleccionar. Sin embargo, la lista selectable_with para segments.hotel_check_in_date es un conjunto mucho más pequeño de segmentos compatibles. Esto significa que, si agregas el campo segments.hotel_check_in_date a la cláusula SELECT, limitarás los segmentos disponibles que te quedan para seleccionar a la intersección de estas dos listas.

Restricciones de segmentos conjuntos

Algunos campos de segmento tienen restricciones de selección explícitas que requieren que se soliciten junto con un segmento superior en la cláusula SELECT:

• Si seleccionas segments.ad_sub_network_type (que desglosa las subredes de anuncios de YouTube, como in-stream, in-feed y Shorts), también debes seleccionar segments.ad_network_type.
• En la versión 25 y posteriores, si seleccionas segments.ad_sub_format_type (que desglosa los anuncios in-stream que no se pueden omitir de YouTube por duración), también debes seleccionar segments.ad_format_type.

Filtrado implícito por selección de segmento

Cuando seleccionas ciertos campos de segmento en tu consulta, la API de Google Ads puede filtrar implícitamente los resultados para incluir solo las filas en las que ese segmento sea aplicable y tenga un valor.

Impacto de segments.keyword.*

Un ejemplo común e importante de este comportamiento ocurre cuando se selecciona cualquier campo en segments.keyword (como segments.keyword.info.text y segments.keyword.ad_group_criterion):

• Exclusión del tráfico que no es de palabras clave: Si incluyes algún campo segments.keyword.* en tu cláusula SELECT, se restringen los resultados solo a las filas asociadas directamente con un criterio de grupo de anuncios de palabras clave de la Red de Búsqueda.
• Tipos de campañas afectadas: En consecuencia, los datos de los tipos de campañas o grupos de anuncios que no dependen de las palabras clave de la Búsqueda se excluyen de los resultados. Esto incluye, entre otros ejemplos:
  • Anuncios dinámicos de búsqueda (DSA): Esto se debe a que las segmentaciones de los DSA se basan en el contenido del sitio web, no en las palabras clave.
  • Campañas de Shopping: Utilizan grupos de productos en lugar de palabras clave.
  • Campañas de máximo rendimiento: Si bien las campañas de máximo rendimiento pueden publicarse en la Búsqueda, sus informes no suelen segmentarse según los mismos criterios de palabras clave.
• Red de Display: Los campos segments.keyword.* pertenecen a las palabras clave que se utilizan en la Red de Búsqueda. No segmentan por palabras clave de la Red de Display ni por otros métodos de segmentación por Display.

Sugerencia: Si tu análisis necesita incluir datos de rendimiento de DSA, Shopping o otras fuentes que no sean palabras clave de la Búsqueda, no incluyas campos de segments.keyword.* en tu consulta. Analiza primero los datos de todos los tipos de campañas y aplica la segmentación por palabras clave solo cuando te enfoques en el rendimiento de las palabras clave de la Búsqueda.

Reglas para segmentos en la cláusula WHERE

Cuando un segmento está en la cláusula WHERE, también debe estar en la cláusula SELECT. La excepción a esta regla son los siguientes segmentos de fecha, que se denominan segmentos de fecha principales:

• segments.date
• segments.week
• segments.month
• segments.quarter
• segments.year

Reglas para los campos de segmentos de fecha principales

Los segmentos segments.date, segments.week, segments.month, segments.quarter y segments.year funcionan de la siguiente manera:

Punto clave: Los segmentos de fecha detallados (segments.date, segments.week y segments.hour) admiten una ventana de visualización de hasta 37 meses. Las consultas que exceden este rango devuelven DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED en la versión 24 y posteriores (o DateRangeError.UNKNOWN en la versión 23). Usa segments.month, segments.quarter o segments.year para los datos históricos más antiguos.

• Estos segmentos se pueden filtrar en la cláusula WHERE sin que aparezcan en la cláusula SELECT.
• Si alguno de estos segmentos se encuentra en la cláusula SELECT, se debe especificar un período finito compuesto por segmentos de fecha principales en la cláusula WHERE. No es necesario que los segmentos de fecha sean los mismos que se especifican en SELECT.

Ejemplos

No válido: Como segments.date está en la cláusula SELECT, debes especificar un rango de fechas finito en la cláusula WHERE para un segments.date, segments.week, segments.month, segments.quarter o segments.year.	SELECT campaign.name, metrics.clicks, segments.date FROM campaign
Válida: Esta consulta devuelve los nombres de las campañas y los clics acumulados durante el período inclusivo. Ten en cuenta que segments.date no necesita aparecer en la cláusula SELECT.	SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date >= '2024-01-01' AND segments.date <= '2024-01-31'
Válida: Esta consulta devuelve los nombres de las campañas y los clics segmentados por fecha para todos los días del período inclusivo.	SELECT campaign.name, metrics.clicks, segments.date FROM campaign WHERE segments.date >= '2024-01-01' AND segments.date <= '2024-01-31'
Válida: Esta consulta devuelve los nombres de las campañas y los clics segmentados por mes para todos los días del período inclusivo.	SELECT campaign.name, metrics.clicks, segments.month FROM campaign WHERE segments.date >= '2024-01-01' AND segments.date <= '2024-01-31'
Válida: Esta consulta devuelve los nombres de las campañas y los clics segmentados por trimestre y, luego, por mes para todos los meses del rango de años inclusivo.	SELECT campaign.name, metrics.clicks, segments.quarter, segments.month FROM campaign WHERE segments.year >= 2020 AND segments.year <= 2024