Les informations des rapports sur les campagnes de génération de la demande peuvent être récupérées à différents niveaux, comme pour les autres types de campagnes.
Création de rapports au niveau de la campagne
Comme pour les autres types de campagnes, vous pouvez utiliser GoogleAdsService.SearchStream
pour récupérer les attributs et les métriques de performances des campagnes de génération de la demande.
SELECT
campaign.id,
campaign.status,
campaign.bidding_strategy_type
FROM campaign
WHERE campaign.advertising_channel_type = DISCOVERY
Pour récupérer les clics dans les rapports sur les campagnes de génération de la demande, filtrez par click_type
sur CROSS_NETWORK
.
Création de rapports au niveau des annonces
L'API Google Ads prend en charge trois types d'annonces de génération de la demande. Utilisez ces requêtes avec GoogleAdsService.SearchStream
pour les récupérer.
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
Rapports au niveau des composants
Les campagnes de génération de la demande utilisent un type de composant spécialisé pour les annonces carrousel.
Utilisez GoogleAdsService.SearchStream
pour récupérer ces éléments.
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
Vous pouvez également récupérer les métriques pour DISCOVERY_CAROUSEL_CARD
composants.
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
Entités incompatibles
Les annonces de type "Annonce vidéo de génération de la demande (ancienne)" diffusées dans l'interface Google Ads ne sont pas compatibles avec l'API Google Ads et ne seront pas renvoyées par GoogleAdsService.SearchStream
.