Segmentación

La segmentación, disponible en la IU de Google Ads como un menú independiente, se puede implementar en la API de Google Ads con solo agregar el campo adecuado a una consulta. Por ejemplo, si agregas segments.device a una consulta, se generará 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.) se dividirán entre ellos.

Mientras que en la IU de Google Ads solo se puede usar un segmento a la vez, 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 verían similares a esta string 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"
      }
    },
    ...
  ]
}

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

Segmentación implícita

Inicialmente, cada informe está segmentado por el recurso especificado en la cláusula FROM. El campo resource_name del recurso en la cláusula FROM se muestra y se segmentan las métricas, incluso cuando el campo resource_name no se incluye de forma explícita en la consulta. Por ejemplo, cuando especificas ad_group como recurso en la cláusula FROM, se mostrará de forma automática ad_group.resource_name y las métricas se segmentarán implícitamente en el nivel del grupo de anuncios.

Para esta consulta,

SELECT metrics.impressions
FROM ad_group

obtendría una string JSON como la siguiente:

{
  "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"
      }
    }
  ]
}

Ten en cuenta que el campo resource_name de adGroup siempre se muestra porque se especificó ad_group como recurso en la cláusula FROM.

Campos de segmento seleccionables

No todos los campos de segmento se pueden seleccionar para un recurso determinado en la cláusula FROM. A modo de ejemplo, continuaremos consultando desde el recurso ad_group. Para que un campo de segmento pueda seleccionarse 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.

Segmentar recursos

Cuando seleccionas algunos recursos, puedes tener la opción de unir implícitamente recursos relacionados si seleccionas 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 1 campo en la cláusula SELECT se mostrará de forma automática, incluso cuando el campo resource_name no se incluya de forma explícita en la consulta.

Al igual que con los campos Attributed Resource, también puedes seleccionar Segmenting Resource. Si un recurso determinado tiene una lista Segmenting Resources en su página de metadatos, seleccionar los campos de uno de esos recursos enumerados hará que la consulta se segmente aún más por el resource_name mostrado de ese Segmenting Resource. Por ejemplo, verás que el recurso campaign aparece como Segmenting Resource para el recurso campaign_budget. Si seleccionas cualquier campo de la campaña, como campaign.name, del recurso campaign_budget, no solo se mostrará el campo campaign.name, sino que también se mostrará y se 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 segmentos son compatibles entre sí, puedes revisar la lista selectable_with de los segmentos en la cláusula SELECT.

En el caso del recurso ad_group, puedes seleccionar más de 50 segmentos disponibles. Sin embargo, la lista selectable_with de 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.

Cuando se agregan algunos segmentos, las métricas de la fila de resumen pueden disminuir
Cuando se agrega segments.keyword.info.match_type a una consulta con FROM ad_group_ad, ese segmento le indica a la consulta que solo obtenga las filas de datos que tienen palabras clave y quite cualquier fila que no esté asociada con una palabra clave. En este caso, las métricas serían más bajas porque excluía cualquier métrica que no fuera de palabras clave.

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 de los campos del segmento de fecha principal

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

  • Estos segmentos se pueden filtrar en la cláusula WHERE sin aparecer en la cláusula SELECT.

  • Si alguno de estos segmentos está 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: Dado que segments.date está en la cláusula SELECT, debes especificar un período 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 muestra nombres de campañas y clics acumulados durante el período. Ten en cuenta que segments.date no necesita aparecer en la cláusula SELECT.
SELECT
  campaign.name,
  metrics.clicks
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'
Válida: Esta consulta muestra nombres de campañas y clics segmentados por fecha para todos los días del período.
SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'
Válida: Esta consulta muestra nombres de campañas y clics segmentados por mes para todos los días del período.
SELECT
  campaign.name,
  metrics.clicks,
  segments.month
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'
Válida: Esta consulta muestra nombres de campañas y clics segmentados por trimestre y, luego, por mes para todos los meses del rango.
SELECT
  campaign.name,
  metrics.clicks,
  segments.quarter,
  segments.month
FROM campaign
WHERE segments.year > 2015
  AND segments.year < 2020

vista_término_búsqueda

Ten en cuenta que para el recurso search_term_view, también está segmentado de forma implícita por grupo de anuncios, no solo un término de búsqueda, como lo refleja la estructura de su nombre del recurso, que también incluye el grupo de anuncios. Por lo tanto, obtendrás algunas filas aparentemente duplicadas con los mismos términos de búsqueda que aparecen en tus resultados cuando, en realidad, las filas pertenecerían a un grupo de anuncios diferente:

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

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