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

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

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

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

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

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

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

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

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

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

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

يستردّ طلب البحث التالي مقاييس "حملات الفيديو" والمجموعات الإعلانية، بما في ذلك عدد مشاهدات فيديوهات 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 وcustomer (بدءًا من الإصدار 26) لقياس عدد الأفراد الفريدين الذين ظهرت لهم إعلاناتك بمعدّلات ظهور معيّنة.

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

• 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 يومًا). يتوفّر هذا المقياس فقط في المورد campaign، ولا يمكن تجميعه على مستوى الصفوف، ولا يتضمّن حقل _info مصاحبًا.

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

في لغة طلب البحث في "إعلانات Google"‏ (GAQL)، تكون حقول metrics.unique_users*_info المصاحبة عبارة عن مقاييس MESSAGE مع filterable: false وsortable: false، لذا لا يمكنك استخدامها في عبارات WHERE أو ORDER BY. اختَر هذه الحقول مباشرةً في عبارة 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 سنوات.

يستردّ طلب البحث التالي مقاييس مدى الوصول الموحّد إلى الجمهور خلال 30 يومًا وحالات الإيقاف المؤقت لـ "حملات الفيديو"، مقسّمة حسب الجهاز وشكل الإعلان. احذف شريحة segments.date من عبارة SELECT لكي تتم إزالة تكرار مقاييس مدى الوصول وعدد مرات الظهور N+ على مستوى الفترة الزمنية الكاملة بدلاً من كل يوم:

SELECT
  campaign.id,
  campaign.name,
  segments.device,
  segments.ad_format_type,
  segments.ad_sub_format_type,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

الموارد والنوافذ الزمنية والشرائح المتوافقة

تتطلّب طلبات البحث عن مدى الوصول وعدد مرات الظهور فلتر segments.date محدودًا ضمن الحد الأقصى للنطاق الزمني للمقياس. طلبات البحث التي لا تتضمّن فلترًا حسب التاريخ أو التي تتجاوز النافذة الزمنية تعرض حقول مدى وصول غير محدّدة:

عند تقسيم طلبات البحث المتعلقة بمدى الوصول، يجب تطبيق قيود التقسيم المشترك التالية:

• أقسام شكل الإعلان مقابل أقسام شبكة الإعلانات: يمكنك التقسيم حسب شكل الإعلان (segments.ad_format_type، اختياريًا مع segments.ad_sub_format_type) أو حسب شبكة الإعلانات (segments.ad_network_type، اختياريًا مع segments.ad_sub_network_type)، ولكن لا يمكنك الجمع بين أقسام شكل الإعلان وشبكة الإعلانات في طلب البحث نفسه. يجب دائمًا اختيار الشريحة الرئيسية (segments.ad_format_type أو segments.ad_network_type) عند اختيار شريحتها الفرعية. تقسّم الشريحة segments.ad_sub_format_type "الإعلانات غير القابلة للتخطّي أثناء عرض الفيديو" حسب المدة وتعرض القيمة UNSEGMENTED لأشكال الإعلانات الأخرى، في حين تقسّم الشريحة segments.ad_sub_network_type مساحات العرض على YouTube (YOUTUBE_INSTREAM وYOUTUBE_INFEED وYOUTUBE_SHORTS) لـ "الحملات لزيادة الطلب" فقط وتعرض القيمة UNSEGMENTED لـ "حملات الفيديو".
• الشرائح الديموغرافية المعدَّلة: لا تتوفّر شريحتَي segments.adjusted_age_range وsegments.adjusted_gender إلا للحسابات المُدرَجة في القائمة المسموح بها، ويجب اختيارهما معًا، ولا يمكن دمجهما مع مقاييس metrics.unique_users_*_plus أو حقول metrics.unique_users*_info أو شرائح شبكة الإعلانات.