حملات الفيديو

تتيح لك حملات الفيديو عرض إعلانات الفيديو على YouTube وعلى المواقع الإلكترونية والتطبيقات التي يتم عرضها على شركاء Google لإعلانات الفيديو.

قيود واجهة برمجة التطبيقات

تتيح Google Ads API بشكل أساسي استرداد البيانات وإعداد التقارير عن "حملات الفيديو" والمجموعات الإعلانية والإعلانات والمعايير الحالية. لا يمكن إنشاء "حملات الفيديو" أو تعديلها باستخدام Google Ads API، مع الاستثناءات والسلوكيات التالية الخاصة بالإصدار:

• قابلية تغيير VideoResponsiveAdInfo: اعتبارًا من الإصدار v24، تكون عناصر VideoResponsiveAdInfo قابلة للتغيير (في الإصدارات السابقة، تكون غير قابلة للتغيير). عند إنشاء VideoResponsiveAdInfo أو تعديله، تكون الحقول videos وbusiness_name وlogo_images مطلوبة.
• ملاءمة أمان العلامة التجارية: اعتبارًا من v24، ستتم إزالة campaign.video_brand_safety_suitability على مستوى الحملة. يمكنك الاستعلام عن مدى ملاءمة العلامة التجارية على مستوى الحساب باستخدام customer.video_brand_safety_suitability.
• تجارب "حملات الفيديو": بدءًا من v24، ستتوفّر إمكانية إعداد تجارب YOUTUBE_CUSTOM التي تتضمّن "حملات فيديو" في experiment.video_experiment.

بدائل لإدارة الحملات

إذا كنت بحاجة إلى إنشاء "حملات فيديو" أو إدارتها آليًا، يمكنك اتّباع الخيارات التالية:

• نصوص "إعلانات Google" البرمجية: يمكنك إدارة "حملات الفيديو" باستخدام نصوص "إعلانات Google" البرمجية. يتيح ذلك إدارة مبرمَجة ضِمن واجهة "إعلانات Google".
• "حملات زيادة الطلب": إذا كان هدفك عرض إعلانات فيديو على مستوى جميع خدمات Google، بما في ذلك YouTube، تتوافق حملات زيادة الطلب تمامًا مع Google Ads API من أجل إنشاء الحملات وإدارتها.

الحصول على بيانات الأداء

يمكنك استرداد بيانات الأداء الخاصة بـ "حملات الفيديو" والمجموعات الإعلانية والمعايير باستخدام GoogleAdsService.SearchStream من خلال الفلترة حسب campaign.advertising_channel_type = 'VIDEO'.

ملاحظة: استخدِم metrics.video_trueview_views وmetrics.video_trueview_view_rate وmetrics.trueview_average_cpv (تمت إعادة تسمية الحقول القديمة metrics.video_views وmetrics.video_view_rate وmetrics.average_cpv في v22). اعتبارًا من v25، يمكنك أيضًا اختيار segments.ad_sub_format_type (إلى جانب segments.ad_format_type) لتقسيم "الإعلانات غير القابلة للتخطي أثناء عرض الفيديو" حسب المدة، بالإضافة إلى مقاييس المشاركة الاجتماعية للفيديو (metrics.youtube_comments وmetrics.youtube_likes وmetrics.youtube_shares).

أداء المجموعة الإعلانية

يستردّ طلب البحث التالي مقاييس "حملات الفيديو" والمجموعات الإعلانية، بما في ذلك مشاهدات الفيديو على TrueView ومعدّلات إكمال الأرباع، من المورد ad_group:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  ad_group.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.video_trueview_views,
  metrics.video_quartile_p100_rate
FROM ad_group
WHERE campaign.advertising_channel_type = 'VIDEO'

إعداد التقارير عن مواضع الفيديوهات ومعاييرها

بما أنّ ad_group_criterion لا يتيح المقاييس أو الشرائح مباشرةً، استخدِم موارد عرض المعايير، مثل managed_placement_view، لاسترداد مقاييس الأداء لمقاطع فيديو YouTube أو قنوات YouTube أو مواضع الإعلانات المُدارة الأخرى المستهدَفة:

SELECT
  campaign.id,
  ad_group.id,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.youtube_channel.channel_id,
  metrics.impressions,
  metrics.video_trueview_views
FROM managed_placement_view
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND ad_group_criterion.type IN ('YOUTUBE_VIDEO', 'YOUTUBE_CHANNEL')
  AND segments.date DURING LAST_30_DAYS