보고 및 최적화
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
디맨드젠 캠페인의 보고 정보는 다른 캠페인 유형과 마찬가지로 다양한 수준에서 가져올 수 있습니다.
캠페인 수준 보고
다른 캠페인 유형과 마찬가지로 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 API에서 지원되지 않으며 GoogleAdsService.SearchStream
에서 반환되지 않습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-26(UTC)
[null,null,["최종 업데이트: 2025-08-26(UTC)"],[[["\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)."]]