إعداد التقارير

يمكنك استرداد سمات إعداد التقارير ومقاييس الأداء لـ "الحملات لزيادة الطلب" على مستوى الحملة والإعلان ومادة العرض.

إعداد التقارير على مستوى الحملات

كما هو الحال مع أنواع الحملات الأخرى، يمكنك استخدام 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" بنوع الإعلان "إعلان فيديو لزيادة الطلب (قديم)" غير متاحة في Google Ads API ولن يتم عرضها من خلال GoogleAdsService.SearchStream أو GoogleAdsService.Search.