דיווח

אתם יכולים לאחזר מאפייני דיווח ומדדי ביצועים של קמפיינים ליצירת ביקוש ברמת הקמפיין, המודעה והנכס.

דיווח ברמת הקמפיין

כמו בסוגי קמפיינים אחרים, אפשר להשתמש ב-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.