製作報表及提高成效
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
與其他廣告活動類型類似,您可以從不同層級擷取需求開發廣告活動的報表資訊。
廣告活動層級報表
與其他廣告活動類型一樣,您可以使用
GoogleAdsService.SearchStream
擷取需求開發廣告活動的屬性和成效指標。
SELECT
campaign.id,
campaign.status,
campaign.bidding_strategy_type
FROM campaign
WHERE campaign.advertising_channel_type = DEMAND_GEN
如要在需求開發廣告活動的報表中擷取點擊次數,請依 click_type
of 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
不會傳回這類廣告。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-26 (世界標準時間)。
[null,null,["上次更新時間: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)."]]