デマンド ジェネレーション キャンペーンのレポート属性とパフォーマンス指標は、キャンペーン、広告、アセットの各レベルで取得できます。
キャンペーン単位のレポート
他のキャンペーン タイプと同様に、GoogleAdsService.SearchStream を使用して、デマンド ジェネレーション キャンペーンの属性とパフォーマンス指標を取得できます。
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
デマンド ジェネレーション キャンペーンのレポートでクリック数をクリックタイプ別に分類するには、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
デマンド ジェネレーションのパフォーマンスをチャネル(YOUTUBE、DISCOVER、GMAIL、MAPS、CONTENT など)と YouTube のサーフェス(YOUTUBE_INSTREAM、YOUTUBE_INFEED、YOUTUBE_SHORTS、UNSEGMENTED)別に分析するには、segments.ad_network_type と segments.ad_sub_network_type の両方を選択します(segments.ad_sub_network_type は常に 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
広告レベルのレポート
Google Ads API は、デマンド ジェネレーションのマルチアセット広告、カルーセル広告、動画レスポンシブ広告、商品広告(DemandGenMultiAssetAdInfo、DemandGenCarouselAdInfo、DemandGenVideoResponsiveAdInfo、DemandGenProductAdInfo)をサポートしています。これらのクエリを GoogleAdsService.SearchStream とともに使用して、属性と指標を取得します。
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
また、1 つのリクエストでデマンド ジェネレーション広告のすべての広告タイプをまとめてクエリすることもできます。
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
)
アセット単位のレポート
デマンド ジェネレーション キャンペーンには、カルーセル カード(DEMAND_GEN_CAROUSEL_CARD)専用のアセットタイプがあります。これらのアセットを取得するには、GoogleAdsService.SearchStream を使用します。
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
ad_group_ad_asset_view を使用して DEMAND_GEN_CAROUSEL_CARD アセットのパフォーマンス指標を取得することもできます。
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
サポートされていないエンティティ
標準のデマンド ジェネレーション動画レスポンシブ広告(DEMAND_GEN_VIDEO_RESPONSIVE_AD)はサポートされていますが、Google 広告の UI で広告タイプが「デマンド ジェネレーション動画広告(以前のバージョン)」と表示される非推奨の以前のバージョンのファインド動画広告は、Google Ads API では対象外となり、GoogleAdsService.SearchStream または GoogleAdsService.Search から返されません。