报告

您可以检索需求开发广告系列的报告属性和效果指标，检索范围可限定为广告系列、广告和素材资源一级。

广告系列级报告

与其他广告系列类型一样，您可以使用 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

您还可以在单个请求中同时查询所有需求开发广告类型：

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 Ads API 不支持已弃用的旧版 Discovery 视频广告（在 Google Ads 界面中显示为“需求开发视频广告 [旧版]”，广告类型为“需求开发视频广告 [旧版]”），并且 GoogleAdsService.SearchStream 或 GoogleAdsService.Search 不会返回此类广告。

上一页
渠道控制选项