گزارش

می‌توانید مشخصه‌های گزارش‌دهی و سنجه‌های عملکرد را برای پویش‌های «تولید تقاضا» در سطح پویش، آگهی، و دارایی بازیابی کنید.

گزارش‌دهی سطح پویش

مانند انواع دیگر پویش، می‌توانید از 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

همچنین می‌توانید سنجه‌های عملکرد را برای DEMAND_GEN_CAROUSEL_CARD دارایی بااستفاده از ad_group_ad_asset_view بازیابی کنید:

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» با نوع آگهی «آگهی ویدیویی «تولید تقاضا» (قدیمی)» نشان داده می‌شوند توسط Google Ads API پشتیبانی نمی‌شوند و GoogleAdsService.SearchStream یا GoogleAdsService.Search برگردانده نخواهند شد.

قبلی
کنترل‌های کانال