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

تتيح لك حملات الفيديو عرض إعلانات الفيديو على 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، ستتوفّر experiment.video_experiment لضبط تجارب YOUTUBE_CUSTOM التي تتألف من "حملات الفيديو".

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

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

• نصوص "إعلانات 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 لمقاييس مشاهدات إعلانات TrueView. اعتبارًا من 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

إعداد تقارير عن مدى الوصول وعدد مرات الظهور في الحملات

بالنسبة إلى "حملات الفيديو"، يمكنك الاستعلام عن مقاييس Unique Reach في المورد campaign لقياس عدد الأفراد الفريدين الذين تم عرض إعلاناتك لهم بمعدّلات ظهور معيّنة.

تقيس مقاييس المستخدمين الفرديين التالية نسبة الوصول إلى الجمهور على مستوى مجموعات التكرار:

• metrics.unique_users: عدد المستخدمين الفرديين الذين شاهدوا إعلانك مرة واحدة على الأقل خلال النطاق الزمني المحدّد (ما يصل إلى 92 يومًا). ولا يمكن تجميعها على مستوى الصفوف.
• من metrics.unique_users_two_plus إلى metrics.unique_users_ten_plus: عدد المستخدمين الفرديين الذين شاهدوا إعلانك من مرّتَين إلى 10 مرّات على الأقل، على التوالي، للنطاقات الزمنية التي تصل إلى 31 يومًا (مع metrics.unique_users_six_plus إلى metrics.unique_users_nine_plus لإكمال المجموعة من مرّتَين أو أكثر إلى 10 مرّات أو أكثر في الإصدار 26 والإصدارات الأحدث).
• metrics.average_impression_frequency_per_user: متوسط عدد المرات التي شاهد فيها مستخدم فردي إعلانك خلال الفترة المطلوبة (ما يصل إلى 92 يومًا). ولا يمكن تجميعها في جميع الصفوف، كما أنّها لا تحتوي على حقل _info مصاحب.

في الإصدار 26 والإصدارات الأحدث، يتضمّن كل مقياس لمدى الوصول حقل بيانات وصفية مصاحبًا من النوع ReachMetricInfo: metrics.unique_users_info و metrics.unique_users_two_plus_info إلى metrics.unique_users_ten_plus_info.

في لغة طلب البحث في "إعلانات Google"‏ (GAQL)، تكون حقول مدى الوصول المصاحب هي MESSAGE المقاييس المحدّدة مباشرةً في عبارة SELECT (على سبيل المثال، metrics.unique_users_info). لا تُلحِق .reach_metric_states في عبارة SELECT، لأنّ اختيار حقول الرسائل المدمجة في GAQL يتعذّر باستخدام UNRECOGNIZED_FIELD. بدلاً من ذلك، يؤدي اختيار metrics.unique_users_info إلى عرض رسالة ReachMetricInfo تحتوي على حقل التعداد المتكرر reach_metric_states من النوع ReachMetricState، والذي يوضّح ما إذا تم حجب المقياس أو ما إذا كان مكتملاً.

عندما يتم حجب مقياس مدى الوصول أو عندما يكون خارج فترة الاحتفاظ بالبيانات (PRIVACY_SUPPRESSION أو QUALITY_SUPPRESSION أو DATE_RANGE_BEYOND_RETENTION)، لا يتم ضبط حقل optional int64 في Metrics (يتم تقييمه على أنّه 0 إذا لم يتم التحقّق من توفّر الحقل)، في حين يستمر LOW_QUALITY في تعبئة المقياس الرقمي.

تشير قيم التعداد ReachMetricState إلى حالة بيانات مدى الوصول:

• ‫COMPLETE: مقياس مدى الوصول مكتمل ولم يخضع لأي حجب لأسباب تتعلق بالخصوصية أو الجودة أو غير ذلك.
• ‫PRIVACY_SUPPRESSION: تم حجب بيانات مدى الوصول لحماية خصوصية المستخدمين (على سبيل المثال، عندما لا يستوفي حجم الجمهور الحد الأدنى لعدد المستخدمين الذين لا يمكن تحديد هويتهم).
• ‫QUALITY_SUPPRESSION: تم حجب بيانات مدى الوصول بسبب متطلبات جودة البيانات.
• ‫LOW_QUALITY: تم احتساب مقياس مدى الوصول، ولكن تم تصنيفه على أنّه منخفض الجودة.
• ‫DATE_RANGE_BEYOND_RETENTION: لا تتوفّر مقاييس مدى الوصول لأنّ النطاق الزمني المحدّد يتجاوز فترة الاحتفاظ ببيانات مدى الوصول التي تبلغ 3 سنوات.

يستردّ طلب البحث التالي مقاييس مدى الوصول وحالات الإيقاف لحملة فيديو:

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  segments.device,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.average_impression_frequency_per_user,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_three_plus,
  metrics.unique_users_three_plus_info,
  metrics.unique_users_four_plus,
  metrics.unique_users_four_plus_info,
  metrics.unique_users_five_plus,
  metrics.unique_users_five_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_seven_plus,
  metrics.unique_users_seven_plus_info,
  metrics.unique_users_eight_plus,
  metrics.unique_users_eight_plus_info,
  metrics.unique_users_nine_plus,
  metrics.unique_users_nine_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date BETWEEN '2026-01-01' AND '2026-01-31'

ملاحظة: لا يمكن تجميع مقاييس مدى الوصول وعدد مرات الظهور على مستوى الصفوف. في حين أنّ metrics.unique_users وmetrics.average_impression_frequency_per_user يتيحان استخدام نطاقات زمنية تصل إلى 92 يومًا ويمكن تقسيمهما حسب segments.date وsegments.device وsegments.adjusted_age_range وsegments.adjusted_gender، فإنّ مقاييس مجموعة معدّل تكرار الظهور في unique_users_*_plus (التي تصل إلى 31 يومًا) وجميع حقول metrics.unique_users*_info المصاحبة تتيح فقط استخدام segments.date وsegments.device. بالإضافة إلى ذلك، حقول metrics.unique_users*_info المصاحبة هي مقاييس MESSAGE مع filterable: false وsortable: false، لذا لا يمكن استخدامها في عبارات WHERE أو ORDER BY. يمكنك الاطّلاع على إخفاء مقاييس مدى الوصول والقيم الصفرية لمزيد من التفاصيل حول التعامل مع مقاييس مدى الوصول المخفية في التقارير.