Segmentação

A segmentação, disponível na interface do Google Ads como um menu separado, pode ser implementada na API Google Ads adicionando o campo adequado a uma consulta. Por exemplo, adicionar segments.device a uma consulta resulta em um relatório com uma linha para cada combinação de dispositivo e o recurso especificado na cláusula FROM e os valores estatísticos (impressões, cliques, conversões etc.) divididos entre eles.

Na interface do Google Ads, só é possível usar um segmento por vez, mas com a API, é possível especificar vários segmentos na mesma consulta.

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

Os resultados do envio dessa consulta para GoogleAdsService.SearchStream seriam semelhantes 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"
      }
    },
    ...
  ]
}

No exemplo acima, os atributos do primeiro e do segundo objetos, incluindo o nome do recurso, são os mesmos. As impressões são segmentadas por dispositivo. Portanto, dois ou mais objetos podem ser retornados para a mesma campanha.

Segmentação implícita

Cada relatório é inicialmente segmentado pelo recurso especificado na cláusula FROM. O campo resource_name do recurso na cláusula FROM é retornado e as métricas são segmentadas por ele, mesmo quando o campo resource_name não é explicitamente incluído na consulta. Por exemplo, quando você especifica ad_group como o recurso na cláusula FROM, ad_group.resource_name é retornado automaticamente, e as métricas são segmentadas implicitamente no nível ad_group.

Para esta consulta,

SELECT metrics.impressions
FROM ad_group

Você vai receber uma string 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"
      }
    }
  ]
}

O campo resource_name de adGroup é sempre retornado porque ad_group foi especificado como um recurso na cláusula FROM.

Campos de segmento selecionáveis

Nem todos os campos de segmento podem ser selecionados para um determinado recurso na cláusula FROM. Como exemplo, vamos continuar a consulta no recurso ad_group. Para que um campo de segmento seja selecionável no recurso ad_group, ele precisa existir na lista Segments para ad_group. A lista Segments é a parte amarela da tabela de campos disponíveis na página de metadados do recurso ad_group.

Segmentar recursos

Ao selecionar alguns recursos, você pode ter a opção de unir implicitamente recursos relacionados selecionando os campos deles junto aos campos do recurso na cláusula FROM. Esses recursos relacionados podem ser encontrados na lista Attributed Resources do recurso na página de metadados da cláusula FROM. No caso do recurso ad_group, você também pode selecionar campos do recurso campaign. O campo resource_name de qualquer Attributed Resources com pelo menos um campo na cláusula SELECT será retornado automaticamente, mesmo que o campo resource_name não seja incluído explicitamente na consulta.

Assim como os campos Attributed Resource, você também pode selecionar campos Segmenting Resource. Se um determinado recurso tiver uma lista Segmenting Resources na página de metadados, a seleção de campos de um desses recursos listados fará com que a consulta seja segmentada pelo resource_name retornado desse Segmenting Resource. Por exemplo, o recurso campaign é listado como Segmenting Resource para o recurso campaign_budget. Selecionar qualquer campo de campanha, como campaign.name, do recurso "campaign_budget" faz com que o campo campaign.name seja retornado e segmentado, além de fazer com que o campo campaign.resource_name seja retornado.

Selecionabilidade entre segmentos e métricas

Um determinado campo de segmento pode não ser compatível com alguns dos outros campos de segmento ou com alguns dos campos de métricas. Para identificar quais campos de segmento são compatíveis entre si, consulte a lista selectable_with dos segmentos na cláusula SELECT.

No caso do recurso ad_group, há mais de 50 segmentos disponíveis que podem ser selecionados. No entanto, a lista de selectable_with para segments.hotel_check_in_date é um conjunto muito menor de segmentos compatíveis. Isso significa que, se você adicionar o campo segments.hotel_check_in_date à cláusula SELECT, vai limitar os segmentos disponíveis que ainda não foram selecionados à interseção dessas duas listas.

Ao adicionar alguns segmentos, as métricas na linha de resumo podem diminuir

Quando segments.keyword.info.match_type é adicionado a uma consulta com FROM ad_group_ad, esse segmento informa à consulta para somente buscar as linhas de dados que têm palavras-chave e remover qualquer linha que não esteja associada a uma palavra-chave. Nesse caso, as métricas seriam menores porque excluiriam todas as métricas que não são de palavras-chave.

Regras para segmentos na cláusula WHERE

Quando um segmento está na cláusula WHERE, ele também precisa estar na cláusula SELECT. A exceção a essa regra são os seguintes segmentos de data, que são chamados de segmentos de data principais:

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

Regras para campos do segmento de data principal

Os segmentos segments.date, segments.week, segments.month, segments.quarter e segments.year funcionam da seguinte maneira:

• Esses segmentos podem ser filtrados na cláusula WHERE sem aparecer na cláusula SELECT.

• Se algum desses segmentos estiver na cláusula SELECT, um intervalo de datas finito composto de segmentos de data principais precisa ser especificado na cláusula WHERE. Os segmentos de data não precisam ser os mesmos especificados na SELECT.

Exemplos

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign

SELECT
  campaign.name,
  metrics.clicks
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'

SELECT
  campaign.name,
  metrics.clicks,
  segments.month
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'

SELECT
  campaign.name,
  metrics.clicks,
  segments.quarter,
  segments.month
FROM campaign
WHERE segments.year > 2015
  AND segments.year < 2020

search_term_view

Para o recurso search_term_view, ele também é segmentado implicitamente por grupo de anúncios, não apenas por um termo de pesquisa, como é refletido pela estrutura do nome do recurso, que também inclui o grupo de anúncios. Portanto, você vai receber algumas linhas aparentemente duplicadas com os mesmos termos de pesquisa nos resultados, quando, na verdade, as linhas pertencem a um grupo de anúncios 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"
      }
    }
  ]
}

Embora os dois objetos retornados neste exemplo pareçam ser duplicados, os nomes dos recursos são diferentes, principalmente na parte "grupo de anúncios". Isso significa que o termo de pesquisa "google photos" é atribuído aos dois grupos de anúncios (ID 2222222222 e 33333333333) na mesma data (15-06-2015). Portanto, podemos concluir que a API funcionou conforme o esperado e não retornou objetos duplicados nesse caso.