生成报表和优化
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
与其他广告系列类型类似，您可以从不同层级检索需求开发广告系列的报告信息。
广告系列级报告
与其他广告系列类型一样，您可以使用 GoogleAdsService.SearchStream 检索需求开发广告系列的属性和效果指标。
SELECT
campaign.id,
campaign.status,
campaign.bidding_strategy_type
FROM campaign
WHERE campaign.advertising_channel_type = DEMAND_GEN
如需在需求开发广告系列的报告中检索点击次数，请按 click_type
（即 CROSS_NETWORK）进行过滤。
广告级报告
Google Ads API 支持三种类型的需求开发广告。将这些查询与 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.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
素材资源级报告
需求开发广告系列具有专门用于轮播式广告的素材资源类型。
使用 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
您还可以检索 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
不受支持的实体
Google Ads 前端中显示且广告类型为“需求开发视频广告（旧版）”的广告不受 Google Ads API 支持，也不会由 GoogleAdsService.SearchStream 返回。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-26。
[null,null,["最后更新时间 (UTC)：2025-08-26。"],[[["\u003cp\u003eDemand Gen campaign reporting data can be accessed through the Google Ads API, with campaign and ad-level details available via \u003ccode\u003eGoogleAdsService.SearchStream\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDemand Gen entities were renamed from \u003ccode\u003ediscovery\u003c/code\u003e to \u003ccode\u003edemand_gen\u003c/code\u003e in Google Ads API v17, affecting campaign and ad type queries.\u003c/p\u003e\n"],["\u003cp\u003eThree Demand Gen ad types are supported: \u003ccode\u003eDEMAND_GEN_MULTI_ASSET_AD\u003c/code\u003e, \u003ccode\u003eDEMAND_GEN_CAROUSEL_AD\u003c/code\u003e, and \u003ccode\u003eDEMAND_GEN_VIDEO_RESPONSIVE_AD\u003c/code\u003e, each with specific attributes retrievable through the API.\u003c/p\u003e\n"],["\u003cp\u003eDemand Gen carousel ads utilize a dedicated asset type, \u003ccode\u003eDEMAND_GEN_CAROUSEL_CARD\u003c/code\u003e, for which asset-level reporting and metrics can be accessed.\u003c/p\u003e\n"],["\u003cp\u003e"Demand Gen video ad (legacy)" ads visible in the Google Ads interface are not supported by the Google Ads API.\u003c/p\u003e\n"]]],[],null,["# Report and optimize\n\nReporting information for Demand Gen campaigns can be retrieved at different\nlevels, similar to other campaign types.\n\nCampaign-level reporting\n------------------------\n\nAs with other campaign types, you can use\n[`GoogleAdsService.SearchStream`](/google-ads/api/reference/rpc/v21/GoogleAdsService/SearchStream)\nto retrieve attributes and performance metrics for Demand Gen campaigns. \n\n SELECT\n campaign.id,\n campaign.status,\n campaign.bidding_strategy_type\n FROM campaign\n WHERE campaign.advertising_channel_type = DEMAND_GEN\n\nTo retrieve clicks in reporting for Demand Gen campaigns, filter by `click_type`\nof `CROSS_NETWORK`.\n\nAd-level reporting\n------------------\n\nThe Google Ads API supports three types of Demand Gen ads. Use these queries with\n[`GoogleAdsService.SearchStream`](/google-ads/api/reference/rpc/v21/GoogleAdsService/SearchStream)\nto retrieve them. \n\n SELECT\n ad_group_ad.ad.id,\n ad_group_ad.ad.type,\n ad_group_ad.ad.demand_gen_multi_asset_ad.marketing_images,\n ad_group_ad.ad.demand_gen_multi_asset_ad.square_marketing_images,\n ad_group_ad.ad.demand_gen_multi_asset_ad.portrait_marketing_images,\n ad_group_ad.ad.demand_gen_multi_asset_ad.logo_images,\n ad_group_ad.ad.demand_gen_multi_asset_ad.headlines,\n ad_group_ad.ad.demand_gen_multi_asset_ad.descriptions,\n ad_group_ad.ad.demand_gen_multi_asset_ad.business_name,\n ad_group_ad.ad.demand_gen_multi_asset_ad.call_to_action_text,\n ad_group_ad.ad.demand_gen_multi_asset_ad.lead_form_only\n FROM ad_group_ad\n WHERE ad_group_ad.ad.type = DEMAND_GEN_MULTI_ASSET_AD\n\n SELECT\n ad_group_ad.ad.id,\n ad_group_ad.ad.type,\n ad_group_ad.ad.demand_gen_carousel_ad.business_name,\n ad_group_ad.ad.demand_gen_carousel_ad.logo_image,\n ad_group_ad.ad.demand_gen_carousel_ad.headline,\n ad_group_ad.ad.demand_gen_carousel_ad.description,\n ad_group_ad.ad.demand_gen_carousel_ad.call_to_action_text,\n ad_group_ad.ad.demand_gen_carousel_ad.carousel_cards\n FROM ad_group_ad\n WHERE ad_group_ad.ad.type = DEMAND_GEN_CAROUSEL_AD\n\n SELECT\n ad_group_ad.ad.id,\n ad_group_ad.ad.type,\n ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb1,\n ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb2,\n ad_group_ad.ad.demand_gen_video_responsive_ad.business_name,\n ad_group_ad.ad.demand_gen_video_responsive_ad.call_to_actions,\n ad_group_ad.ad.demand_gen_video_responsive_ad.descriptions,\n ad_group_ad.ad.demand_gen_video_responsive_ad.headlines,\n ad_group_ad.ad.demand_gen_video_responsive_ad.logo_images,\n ad_group_ad.ad.demand_gen_video_responsive_ad.long_headlines,\n ad_group_ad.ad.demand_gen_video_responsive_ad.videos\n FROM ad_group_ad\n WHERE ad_group_ad.ad.type = DEMAND_GEN_VIDEO_RESPONSIVE_AD\n\nAsset-level reporting\n---------------------\n\nDemand Gen campaigns have a specialized asset type for carousel ads.\nUse\n[`GoogleAdsService.SearchStream`](/google-ads/api/reference/rpc/v21/GoogleAdsService/SearchStream)\nto retrieve these assets. \n\n SELECT\n asset.id,\n asset.demand_gen_carousel_card_asset.marketing_image_asset,\n asset.demand_gen_carousel_card_asset.square_marketing_image_asset,\n asset.demand_gen_carousel_card_asset.portrait_marketing_image_asset,\n asset.demand_gen_carousel_card_asset.headline,\n asset.demand_gen_carousel_card_asset.call_to_action_text\n FROM asset\n WHERE asset.type = DEMAND_GEN_CAROUSEL_CARD\n\nYou can also retrieve metrics for `DEMAND_GEN_CAROUSEL_CARD` assets. \n\n SELECT\n asset.id,\n asset.name,\n asset.type,\n metrics.impressions\n FROM ad_group_ad_asset_view\n WHERE ad_group_ad_asset_view.field_type = DEMAND_GEN_CAROUSEL_CARD\n\nUnsupported entities\n--------------------\n\nAds that show up in the Google Ads frontend with ad type \"Demand Gen\nvideo ad (legacy)\" are not supported by the Google Ads API and won't be returned by\n[`GoogleAdsService.SearchStream`](/google-ads/api/reference/rpc/v21/GoogleAdsService/SearchStream)."]]
