Puoi recuperare gli attributi dei report e le metriche sul rendimento per le campagne Demand Gen a livello di campagna, annuncio e asset.
Report a livello di campagna
Come per altri tipi di campagne, puoi utilizzare
GoogleAdsService.SearchStream
per recuperare gli attributi e le metriche sul rendimento delle campagne Demand Gen:
SELECT
campaign.id,
campaign.status,
campaign.bidding_strategy_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM campaign
WHERE campaign.advertising_channel_type = DEMAND_GEN
Per segmentare i clic nei report per le campagne Demand Gen in base al tipo di clic, filtra per
segments.click_type = CROSS_NETWORK:
SELECT
campaign.id,
segments.click_type,
metrics.clicks
FROM campaign
WHERE campaign.advertising_channel_type = DEMAND_GEN
AND segments.click_type = CROSS_NETWORK
Per suddividere il rendimento di Demand Gen per canale (ad esempio YOUTUBE, DISCOVER,
GMAIL, MAPS o CONTENT) e per piattaforma di YouTube (YOUTUBE_INSTREAM,
YOUTUBE_INFEED, YOUTUBE_SHORTS o UNSEGMENTED), seleziona sia
segments.ad_network_type sia segments.ad_sub_network_type (tieni presente che
segments.ad_sub_network_type deve essere sempre selezionato insieme a
segments.ad_network_type):
SELECT
campaign.id,
segments.ad_network_type,
segments.ad_sub_network_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.video_trueview_views
FROM campaign
WHERE campaign.advertising_channel_type = DEMAND_GEN
Report a livello di annuncio
L'API Google Ads supporta gli annunci Demand Gen multi-asset, carosello, video adattabili e annunci di prodotto (DemandGenMultiAssetAdInfo, DemandGenCarouselAdInfo, DemandGenVideoResponsiveAdInfo e DemandGenProductAdInfo). Utilizza queste query con GoogleAdsService.SearchStream per recuperare i relativi attributi e metriche:
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.tall_portrait_marketing_images,
ad_group_ad.ad.demand_gen_multi_asset_ad.classic_display_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,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
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,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
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.companion_banners,
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,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.video_trueview_views
FROM ad_group_ad
WHERE ad_group_ad.ad.type = DEMAND_GEN_VIDEO_RESPONSIVE_AD
SELECT
ad_group_ad.ad.id,
ad_group_ad.ad.type,
ad_group_ad.ad.demand_gen_product_ad.headline,
ad_group_ad.ad.demand_gen_product_ad.description,
ad_group_ad.ad.demand_gen_product_ad.logo_image,
ad_group_ad.ad.demand_gen_product_ad.breadcrumb1,
ad_group_ad.ad.demand_gen_product_ad.breadcrumb2,
ad_group_ad.ad.demand_gen_product_ad.business_name,
ad_group_ad.ad.demand_gen_product_ad.call_to_action,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM ad_group_ad
WHERE ad_group_ad.ad.type = DEMAND_GEN_PRODUCT_AD
Puoi anche eseguire query su tutti i tipi di annunci Demand Gen contemporaneamente in un'unica richiesta:
SELECT
ad_group_ad.ad.id,
ad_group_ad.ad.type,
ad_group_ad.ad.demand_gen_multi_asset_ad.headlines,
ad_group_ad.ad.demand_gen_carousel_ad.headline,
ad_group_ad.ad.demand_gen_video_responsive_ad.headlines,
ad_group_ad.ad.demand_gen_product_ad.headline,
ad_group_ad.ad.demand_gen_product_ad.description,
ad_group_ad.ad.demand_gen_product_ad.business_name,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM ad_group_ad
WHERE ad_group_ad.ad.type IN (
DEMAND_GEN_MULTI_ASSET_AD,
DEMAND_GEN_CAROUSEL_AD,
DEMAND_GEN_VIDEO_RESPONSIVE_AD,
DEMAND_GEN_PRODUCT_AD
)
Report a livello di asset
Le campagne Demand Gen hanno un tipo di asset specializzato per le schede carosello (DEMAND_GEN_CAROUSEL_CARD). Utilizza GoogleAdsService.SearchStream per recuperare questi asset:
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
Puoi anche recuperare le metriche sul rendimento degli asset DEMAND_GEN_CAROUSEL_CARD utilizzando ad_group_ad_asset_view:
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
Entità non supportate
Sebbene gli annunci adattabili video Demand Gen standard (DEMAND_GEN_VIDEO_RESPONSIVE_AD) siano supportati, gli annunci video discovery legacy ritirati che vengono visualizzati nell'interfaccia utente di Google Ads con il tipo di annuncio "Annuncio video Demand Gen (legacy)" non sono supportati dall'API Google Ads e non verranno restituiti da GoogleAdsService.SearchStream o GoogleAdsService.Search.