Gerar relatórios e otimizar

As informações dos relatórios de campanhas Geração de demanda podem ser recuperadas em diferentes níveis, da mesma forma que acontece com outros tipos de campanhas.

Relatórios no nível da campanha

Assim como em outros tipos de campanhas, é possível usar GoogleAdsService.SearchStream para recuperar atributos e métricas de performance das campanhas Geração de demanda.

SELECT
  campaign.id,
  campaign.status,
  campaign.bidding_strategy_type
FROM campaign
WHERE campaign.advertising_channel_type = DISCOVERY

Para recuperar os cliques nos relatórios de campanhas Geração de demanda, filtre por click_type de CROSS_NETWORK.

Relatórios no nível do anúncio

Há três tipos de anúncios da Geração de demanda compatíveis com a API Google Ads. Use essas consultas com GoogleAdsService.SearchStream para recuperá-las.

SELECT
  ad_group_ad.ad.id,
  ad_group_ad.ad.type,
  ad_group_ad.ad.discovery_multi_asset_ad.marketing_images,
  ad_group_ad.ad.discovery_multi_asset_ad.square_marketing_images,
  ad_group_ad.ad.discovery_multi_asset_ad.portrait_marketing_images,
  ad_group_ad.ad.discovery_multi_asset_ad.logo_images,
  ad_group_ad.ad.discovery_multi_asset_ad.headlines,
  ad_group_ad.ad.discovery_multi_asset_ad.descriptions,
  ad_group_ad.ad.discovery_multi_asset_ad.business_name,
  ad_group_ad.ad.discovery_multi_asset_ad.call_to_action_text,
  ad_group_ad.ad.discovery_multi_asset_ad.lead_form_only
FROM ad_group_ad
WHERE ad_group_ad.ad.type = DISCOVERY_MULTI_ASSET_AD

SELECT
  ad_group_ad.ad.id,
  ad_group_ad.ad.type,
  ad_group_ad.ad.discovery_carousel_ad.business_name,
  ad_group_ad.ad.discovery_carousel_ad.logo_image,
  ad_group_ad.ad.discovery_carousel_ad.headline,
  ad_group_ad.ad.discovery_carousel_ad.description,
  ad_group_ad.ad.discovery_carousel_ad.call_to_action_text,
  ad_group_ad.ad.discovery_carousel_ad.carousel_cards
FROM ad_group_ad
WHERE ad_group_ad.ad.type = DISCOVERY_CAROUSEL_AD

SELECT
  ad_group_ad.ad.id,
  ad_group_ad.ad.type,
  ad_group_ad.ad.discovery_video_responsive_ad.breadcrumb1,
  ad_group_ad.ad.discovery_video_responsive_ad.breadcrumb2,
  ad_group_ad.ad.discovery_video_responsive_ad.business_name,
  ad_group_ad.ad.discovery_video_responsive_ad.call_to_actions,
  ad_group_ad.ad.discovery_video_responsive_ad.descriptions,
  ad_group_ad.ad.discovery_video_responsive_ad.headlines,
  ad_group_ad.ad.discovery_video_responsive_ad.logo_images,
  ad_group_ad.ad.discovery_video_responsive_ad.long_headlines,
  ad_group_ad.ad.discovery_video_responsive_ad.videos,
FROM ad_group_ad
WHERE ad_group_ad.ad.type = DISCOVERY_VIDEO_RESPONSIVE_AD

Relatórios no nível do recurso

As campanhas Geração de demanda têm um tipo de recurso especializado para anúncios de carrossel. Use GoogleAdsService.SearchStream para extrair esses recursos.

SELECT
  asset.id,
  asset.discovery_carousel_card_asset.marketing_image_asset,
  asset.discovery_carousel_card_asset.square_marketing_image_asset,
  asset.discovery_carousel_card_asset.portrait_marketing_image_asset,
  asset.discovery_carousel_card_asset.headline,
  asset.discovery_carousel_card_asset.call_to_action_text
FROM asset
WHERE asset.type = DISCOVERY_CAROUSEL_CARD

Você também pode recuperar métricas para DISCOVERY_CAROUSEL_CARD recursos.

SELECT
  asset.id,
  asset.name,
  asset.type,
  metrics.impressions
FROM ad_group_ad_asset_view
WHERE ad_group_ad_asset_view.field_type = DISCOVERY_CAROUSEL_CARD

Entidades incompatíveis

Os anúncios exibidos no front-end do Google Ads com o tipo "Anúncio em vídeo da Geração de demanda (legado)" não são compatíveis com a API Google Ads e não serão retornados por GoogleAdsService.SearchStream.