보고

캠페인, 광고, 확장 소재 수준에서 디맨드젠 캠페인의 보고 속성 및 실적 측정항목을 가져올 수 있습니다.

캠페인 수준 보고

다른 캠페인 유형과 마찬가지로 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 UI에 광고 유형 '디맨드젠 캠페인 동영상 광고(기존)'로 표시되는 지원 중단된 기존 디스커버리 동영상 광고는 Google Ads API에서 지원되지 않으며 GoogleAdsService.SearchStream 또는 GoogleAdsService.Search에서 반환되지 않습니다.

이전
채널 컨트롤