Relatório sobre as metas da campanha e do grupo de anúncios

A nova API Search Ads 360 Reporting já está disponível. Ela oferece mais flexibilidade para criar relatórios personalizados e integrar os dados aos seus aplicativos e processos relacionados à geração de relatórios. Saiba mais sobre como migrar e usar a nova API Search Ads 360 Reporting.

As segmentações são critérios para exibir anúncios com base no local, nas informações demográficas e em outras características de uma consulta de pesquisa. Por exemplo, um anunciante pode segmentar os anúncios de uma campanha para que apareçam somente em Nova York, Boston e Chicago. Ou um anunciante pode aumentar os lances para pesquisas de membros de um público-alvo de publicidade específico, aumentando assim a probabilidade de exibição do anúncio para esse público.

Alguns tipos de segmentação só podem ser aplicados a campanhas, enquanto outros podem ser aplicados somente a grupos de anúncios. Para ver quais destinos estão disponíveis em cada nível, consulte a documentação dos relatórios campaignTarget e adGroupTarget.

É possível solicitar relatórios com métricas de desempenho para tipos específicos de segmentações. Por exemplo, se um anunciante segmentar uma campanha por localizações geográficas, inclua a coluna locationTargetName em uma solicitação campaignTarget. Ao recuperar o relatório gerado, é possível conferir o desempenho da campanha em cada região de segmentação.

Segmentações negativas

As segmentações negativas impedem que os anúncios sejam exibidos quando as pesquisas correspondem a critérios específicos. Assim como as segmentações, alguns tipos de segmentação negativa podem ser aplicados somente a campanhas, enquanto outros só podem ser aplicados a grupos de anúncios. Consulte negativeCampaignTarget e negativeAdGroupTarget para mais detalhes.

É possível solicitar relatórios para ver os critérios que as segmentações negativas usam para excluir anúncios. Por exemplo, se um anunciante usar segmentações negativas para impedir que uma campanha exiba anúncios em localizações geográficas específicas, inclua a coluna locationTargetName em uma solicitação negativeCampaignTarget. Ao recuperar o relatório gerado, é possível ver a lista de locais que foram excluídos da campanha.

Exemplos de solicitação

Veja exemplos de solicitações para diferentes tipos de destinos:

Gerar relatórios sobre locais de segmentação em uma campanha

O exemplo de solicitação assíncrona a seguir retorna o número de cliques, impressões e outros dados para locais de segmentação. Os relatórios sobre locais de segmentação estão disponíveis somente para campanhas do Google Ads. O Search Ads 360 é compatível com alguns tipos de segmentação por local, como áreas de segmentação por localização geográfica, áreas de segmentação por proximidade e segmentações por raio para extensões de local do Google Ads. Além disso, os relatórios de segmentações por local contêm dados de todos os tipos de segmentação por local aplicados no escopo do relatório.

Exemplo de solicitação

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Exemplo de relatório

Confira um exemplo de relatório campaignTarget. O relatório mostra o desempenho para uma segmentação por localização geográfica que especifica "US", uma área de segmentação por proximidade que especifica "100,0 milhas ao redor de (37.4220041,-122.0862462)" e outra segmentação por localização geográfica que especifica um CEP dos EUA (90210):

account,campaign,locationTargetName,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,US,10895,12895,1255.07000000,1157
Hooper's - Google,Accessories,"100.0 miles around (37.4220041,-122.0862462)",10816,12816,1285.07000000,1145
Hooper's - Google,Accessories,90210,12790,12790,1124.06000000,1147
    

Segmentações de remarketing de todos os grupos de anúncios em uma conta

O exemplo de solicitação assíncrona a seguir retorna o número de cliques, impressões e outros dados para todas as segmentações de remarketing definidas para grupos de anúncios em uma campanha específica do Google Ads.

Exemplo de solicitação

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201", // Replace with your IDs
    "campaignId": "700000000058578" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "engineRemarketingList" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Exemplo de relatório

Confira um exemplo de relatório adGroupTarget. O relatório mostra que três grupos de anúncios na campanha "Acessórios" definem segmentações de remarketing. As métricas de desempenho para cada segmentação de remarketing também estão incluídas:

account,campaign,adGroup,engineRemarketingList,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,Summer 2016,Weekend Warriors,7707,26333,1255.07000000,3
Hooper's - Google,Accessories,$30 and Under,Email Subscribers,6992,29630,3170.18000000,8
Hooper's - Google,Accessories,Tote Bags,Repeat Buyers,4535,20504,1524.88000000,2
    

Segmentações dinâmicas de anúncios para todos os grupos de anúncios em uma conta

Uma segmentação dinâmica de anúncios define as páginas do seu site que você quer divulgar com anúncios dinâmicos de pesquisa. As segmentações dinâmicas de anúncios estão disponíveis somente em contas de mecanismo do Google Ads e sempre são criadas em grupos de anúncios específicos. O Google usa o índice de pesquisa para determinar quando a pesquisa de um cliente é relevante para qualquer página que corresponda às suas segmentações dinâmicas de anúncios. Se uma pesquisa for relevante, o Google exibirá um anúncio dinâmico de pesquisa que você tiver definido no mesmo grupo de anúncios das segmentações.

O exemplo de solicitação assíncrona a seguir retorna o número de cliques, impressões e outros dados de todas as segmentações dinâmicas de anúncios definidas para grupos de anúncios em uma conta de mecanismo.

Exemplo de solicitação

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "dynamicSearchAdsTargetConditions" },
    { "columnName": "dynamicSearchAdsTargetCoverage" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Exemplo de relatório

Confira um exemplo de relatório adGroupTarget. O relatório mostra que um grupo de anúncios na campanha "Google Stores" define uma segmentação dinâmica de anúncios. As métricas de desempenho para a meta também estão incluídas:

account,campaign,adGroup,dynamicSearchAdsTargetConditions,dynamicSearchAdsTargetCoverage,clicks,impr,cost,dfaActions
Hooper's - Google,Google Stores,Chargers,"AND(CATEGORY = ""Electronics"",CATEGORY = ""Accessories"")",4535,20504,1524.88000000,2
    

Gerar relatórios sobre locais de segmentação negativos para campanhas

O exemplo de solicitação assíncrona a seguir retorna os locais que foram excluídos das campanhas em uma conta de mecanismo. Os relatórios sobre locais de segmentação negativos estão disponíveis somente para campanhas do Google Ads. As segmentações por local negativas usam apenas segmentações por localização geográfica como critérios. Elas não podem especificar áreas de segmentação por proximidade nem segmentações por raio. Portanto, os relatórios de segmentações por local negativas contêm somente a lista dos locais geográficos excluídos das campanhas no escopo do relatório.

Uma solicitação de relatório de segmentação negativa não precisa especificar um período. Os relatórios negativos sempre retornam as configurações atuais. Por exemplo, não é possível solicitar um relatório que mostre as metas negativas em uso no último trimestre.

Exemplo de solicitação

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "negativeCampaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" }
  ],
  "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Exemplo de relatório

Confira um exemplo de relatório negativeCampaignTarget. O relatório mostra que a campanha "Grandes inaugurações - NE" exclui o estado do Maine, e a campanha "Grand Openings - West" exclui o estado da Califórnia:

account,campaign,locationTargetName
Hooper's - Google,Grand openings - NE,US-ME
Hooper's - Google,Grand openings - West,US-CA