Los datos de los informes de las campañas de generación de demanda se pueden recuperar en diferentes de manera similar a otros tipos de campañas.
Informes a nivel de la campaña
Al igual que con otros tipos de campañas, puedes utilizar
GoogleAdsService.SearchStream
para recuperar los atributos y las métricas de rendimiento de las campañas de generación de demanda.
Con la versión 17 de la API de Google Ads o una posterior, ocurrirá lo siguiente:
SELECT
campaign.id,
campaign.status,
campaign.bidding_strategy_type
FROM campaign
WHERE campaign.advertising_channel_type = DEMAND_GEN
Con la API de Google Ads V16 y versiones anteriores:
SELECT
campaign.id,
campaign.status,
campaign.bidding_strategy_type
FROM campaign
WHERE campaign.advertising_channel_type = DISCOVERY
Para recuperar los clics en los informes de las campañas de generación de demanda, filtra por click_type
de CROSS_NETWORK
.
Informes a nivel del anuncio
Existen tres tipos de anuncios de generación de demanda compatibles con la API de Google Ads. Usar estas opciones
consultas con GoogleAdsService.SearchStream
para recuperarlos.
Con la versión 17 de la API de Google Ads o una posterior, ocurrirá lo siguiente:
SELECT
ad_group_ad.ad.id,
ad_group_ad.ad.type,
ad_group_ad.ad.demand_gen_multi_asset_ad.marketing_images,
ad_group_ad.ad.demand_gen_multi_asset_ad.square_marketing_images,
ad_group_ad.ad.demand_gen_multi_asset_ad.portrait_marketing_images,
ad_group_ad.ad.demand_gen_multi_asset_ad.logo_images,
ad_group_ad.ad.demand_gen_multi_asset_ad.headlines,
ad_group_ad.ad.demand_gen_multi_asset_ad.descriptions,
ad_group_ad.ad.demand_gen_multi_asset_ad.business_name,
ad_group_ad.ad.demand_gen_multi_asset_ad.call_to_action_text,
ad_group_ad.ad.demand_gen_multi_asset_ad.lead_form_only
FROM ad_group_ad
WHERE ad_group_ad.ad.type = DEMAND_GEN_MULTI_ASSET_AD
SELECT
ad_group_ad.ad.id,
ad_group_ad.ad.type,
ad_group_ad.ad.demand_gen_carousel_ad.business_name,
ad_group_ad.ad.demand_gen_carousel_ad.logo_image,
ad_group_ad.ad.demand_gen_carousel_ad.headline,
ad_group_ad.ad.demand_gen_carousel_ad.description,
ad_group_ad.ad.demand_gen_carousel_ad.call_to_action_text,
ad_group_ad.ad.demand_gen_carousel_ad.carousel_cards
FROM ad_group_ad
WHERE ad_group_ad.ad.type = DEMAND_GEN_CAROUSEL_AD
SELECT
ad_group_ad.ad.id,
ad_group_ad.ad.type,
ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb1,
ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb2,
ad_group_ad.ad.demand_gen_video_responsive_ad.business_name,
ad_group_ad.ad.demand_gen_video_responsive_ad.call_to_actions,
ad_group_ad.ad.demand_gen_video_responsive_ad.descriptions,
ad_group_ad.ad.demand_gen_video_responsive_ad.headlines,
ad_group_ad.ad.demand_gen_video_responsive_ad.logo_images,
ad_group_ad.ad.demand_gen_video_responsive_ad.long_headlines,
ad_group_ad.ad.demand_gen_video_responsive_ad.videos,
FROM ad_group_ad
WHERE ad_group_ad.ad.type = DEMAND_GEN_VIDEO_RESPONSIVE_AD
Con la API de Google Ads V16 y versiones anteriores:
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
Informes a nivel de los recursos
Las campañas de generación de demanda tienen un tipo de recurso especializado para los anuncios de carrusel.
Usa
GoogleAdsService.SearchStream
para recuperar estos recursos.
Con la versión 17 de la API de Google Ads o una posterior, ocurrirá lo siguiente:
SELECT
asset.id,
asset.demand_gen_carousel_card_asset.marketing_image_asset,
asset.demand_gen_carousel_card_asset.square_marketing_image_asset,
asset.demand_gen_carousel_card_asset.portrait_marketing_image_asset,
asset.demand_gen_carousel_card_asset.headline,
asset.demand_gen_carousel_card_asset.call_to_action_text
FROM asset
WHERE asset.type = DEMAND_GEN_CAROUSEL_CARD
Con la API de Google Ads V16 y versiones anteriores:
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
También puedes recuperar las métricas de DEMAND_GEN_CAROUSEL_CARD
de recursos.
Con la versión 17 de la API de Google Ads o una posterior, ocurrirá lo siguiente:
SELECT
asset.id,
asset.name,
asset.type,
metrics.impressions
FROM ad_group_ad_asset_view
WHERE ad_group_ad_asset_view.field_type = DEMAND_GEN_CAROUSEL_CARD
Con la API de Google Ads V16 y versiones anteriores:
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
## Unsupported entities
Ads that show up in the Google Ads frontend with ad type "Demand Gen
video ad (legacy)" are not supported by the Google Ads API and won't be returned by
[`GoogleAdsService.SearchStream`](/google-ads/api/reference/rpc/v17/GoogleAdsService#searchstream)