يمكنك استخدام أداة YouTube VAST QA بهدف التحقق مما إذا كانت علامات إعلانات VAST تتوافق مع المواصفات المطلوبة لعرض إعلانات الجهات الخارجية. ويمكنك أيضًا استخدام هذه الأداة لتعاين بسهولة طريقة عرض إعلان الجهة الخارجية على مشغّل YouTube.
المورّدون الخارجيون المعتمدون
يجب أن يعرض أحد مورّدي VAST المعتمدين على YouTube إعلانات الجهات الخارجية المضمّنة في البث وإعلانات البانر المصاحبة لها باستخدام علامة VAST خطية. ويمكن أن نقيّد الإعلانات أو نعلّقها إذا كانت معروضة من قِبل جهة خارجية وتخالف سياساتنا الإعلانية. يُرجى الاطّلاع على ملخّص XML المُفصَّل أدناه.
ملخّص XML الخاص باستجابة خادم إعلانات VAST للإعلانات المضمّنة في البث المباشر
العنصر | السمات | القيم | مطلوب | متاح | ملاحظات |
---|---|---|---|---|---|
VAST | Root node | نعم | نعم | ||
version | String (3.0) | نعم | نعم | يجب أن يدعم الإصدار 2* أو 3.0 من VAST. | |
Ad | رقم تعريف | سلسلة | نعم | نعم | يغطي عنصر المستوى الأعلى كل إعلان في الاستجابة. |
InLine | غير متاح | غير متاح | نعم | نعم | عنصر من الدرجة الثانية يحيط ببيانات الإعلانات الكاملة لإعلان واحد |
AdSystem | غير متاح | سلسلة | نعم | نعم | يُشير إلى خادم إعلانات المصدر |
الإصدار | سلسلة | مفضّل | نعم | إصدار داخلي يستخدمه نظام الإعلانات | |
AdTitle | غير متاح | سلسلة | لا | نعم | الاسم الشائع للإعلان |
Description | غير متاح | سلسلة | لا | نعم | وصف أطول للإعلان |
Survey | غير متاح | URI | لا | لا | معرّف الموارد المنتظم (URI) للطلب المرسَل إلى مورّد الاستطلاع (في YouTube، يتمّ دعم بكسلات تتبّع الأبحاث من مورّدي أبحاث معتمدين في هذه العقدة فقط. ولا يُسمح حاليًا بعرض استطلاعات أو دعوات إلى استطلاعات أو كليهما باستخدام XML الخاص بنموذج VAST). |
Error | غير متاح | URI | لا | نعم | معرّف URI الذي يجب طلبه في حال عدم عرض الإعلان نتيجة حدوث خطأ. في YouTube، يتمّ تنفيذ طلب URI في حال حدوث خطأ فقط، ولكن لن يتمّ عرض معلومات إضافية عن هذا الخطأ. |
Impression | غير متاح | URI | نعم | نعم | يتتبّع معرّف URI مرّات الظهور. |
Creatives | غير متاح | غير متاح | نعم | نعم | حاوية لعنصر Creative واحد أو أكثر |
Creative | نعم | نعم | يغطي كل عنصر من عناصر المادة الإبداعية. | ||
رقم تعريف | سلسلة | لا | نعم | معرّف اختياري | |
sequence | عدد صحيح | لا | نعم | الترتيب المفضّل الذي يجب اعتماده لعرض تصميمات الإعلانات المتعددة | |
AdID | سلسلة | لا | نعم | الرقم التعريفي لتصميم الإعلان (يُعرف في السابق باسم ISCI) | |
Linear | نعم | نعم | |||
skipoffset | 00:00:05 | لا | نعم | الإصدار 3.0 من VAST فقط | |
Duration | غير متاح | الوقت | نعم | نعم | |
TrackingEvents | لا | نعم | |||
Tracking | URI | لا | نعم | يتتبّع معرّف URI الأحداث المختلفة أثناء التشغيل. | |
event | creativeView، start، firstQuartile، midpoint، thirdQuartile، complete، mute، unmute، pause، rewind، resume، fullscreen، expand، collapse، acceptInvitation، close acceptInvitationLinear closeLinear progress skip |
لا |
نعم (start وfirstQuartile وmidpoint وthirdQuartile وcomplete فقط) علامات 3.0 VAST وحدها تدعم العنصر Skip. |
اسم حدث التتبّع للعنصر Linear. يجب طلب creativeView دائمًا عند توفره. | |
AdParameters | سلسلة | لا | لا | يتم نقل البيانات إلى إعلان الفيديو. | |
VideoClicks | نعم | نعم | |||
ClickThrough | غير متاح | URI | نعم | نعم | يفتح معرّف URI كصفحة مقصودة عندما ينقر المشاهد على الإعلان. |
ClickTracking | URI | لا | نعم | معرّف URI الذي يجب طلبه لأغراض التتبّع عندما ينقر المشاهد على الفيديو | |
CustomClick | URI | لا | نعم | أرقام تعريف URI التي يجب طلبها في الأحداث المخصّصة، مثل الفيديو الفعّال | |
رقم تعريف | سلسلة | لا | لا | معرّف اختياري | |
MediaFiles | نعم | نعم | |||
MediaFile | URI |
نعم (يجب أن تتوفّر عقدتي MediaFile منفصلتين على الأقل، عقدة لتنسيق فيديو MP4 وعقدة لتنسيق فيديو WebM) |
نعم | موقع الملف الخطي | |
delivery | قيد التقدم | نعم | نعم | طريقة عرض الإعلان (من غير المستحسن في YouTube تضمين الإعلان في البث) | |
type | سلسلة | نعم (تنسيق MP4 وWebM) | نعم | نوع بروتوكول MIME (على سبيل المثال لا الحصر، نذكر من ضمن أنواع بروتوكول MIME "video/x-ms-wmv" لـ Windows Media) | |
bitrate | عدد صحيح | نعم | نعم | معدّل نقل البيانات للفيديو المرمّز بالكيلوبت ثانية | |
width | عدد صحيح (480) | نعم | نعم | مكونات البكسل للفيديو | |
height | عدد صحيح (360) | نعم | نعم | مكونات البكسل للفيديو | |
scalable | Boolean | لا | لا | إمكانية تغيير حجم الصورة (يتمّ ذلك تلقائيًا في YouTube) | |
maintainAspectRatio | منطقي | لا | نعم | ||
apiFramework | سلسلة | لا | لا | إذا كان العنصر MediaFile تفاعليًا، يحدّد apiFramework طريقة التواصل التي يجب استخدامها. | |
CompanionAds | لا | نعم | |||
Companion | لا | نعم | أي عدد من العناصر المصاحبة في أي أبعاد بكسل مطلوبة | ||
رقم تعريف | سلسلة | لا | نعم | معرّف اختياري | |
width | عدد صحيح (300) | نعم (إذا كان الإعلان يعرض إعلانًا مصاحبًا) | نعم | أبعاد البكسل للعنصر المصاحب | |
height | عدد صحيح (60) | نعم (إذا كان الإعلان يعرض إعلانًا مصاحبًا) | نعم | أبعاد البكسل للعنصر المصاحب | |
expandedWidth | عدد صحيح | لا | لا | أبعاد البكسل لتكبير الإعلان المصاحب في حالة التوسيع (لا يُسمح بالإصدارات القابلة للتوسيع مع الإعلانات المضمنة في البث المباشر في YouTube) | |
expandedHeight | عدد صحيح | لا | لا | أبعاد البكسل لتكبير الإعلان المصاحب في حالة التوسيع (لا يُسمح بالإصدارات القابلة للتوسيع مع الإعلانات المضمنة في البث المباشر في YouTube) | |
apiFramework | سلسلة | لا | لا | يحدد apiFramework طريقة التواصل التي يجب استخدامها في الإعلان المصاحب. | |
StaticResource | URI | لا | نعم | معرّف URI لملف ثابت، مثل صورة | |
creativeType | سلسلة | نعم (في حال عرض إعلان مصاحب باستخدام StaticResource) | نعم | نوع بروتوكول MIME من المورد الثابت، ويسمح فقط بأنواع الصور | |
IFrameResource | غير متاح | URI | لا | نعم | مصدر URI الذي يتيح لـ IFrame عرض العنصر المصاحب |
HTMLResource | غير متاح | CDATA | لا | لا | HTML لعرض العنصر المصاحب |
JavaScriptResource | غير متاح | CDATA | لا | لا | لغة البرمجة "جافا سكريبت" لعرض العنصر المصاحب |
TrackingEvents | لا | لا | |||
Tracking | URI | لا | لا | معرّف موارد منتظم (URI) لعرض العنصر المصاحب | |
event | creativeView | نعم (إذا كان الإعلان يعرض إعلانًا مصاحبًا) | لا | يجب طلب creativeView دائمًا عند توفره. بالنسبة إلى الإعلانات المصاحبة، يتم فقط دعم حدث creativeView. | |
CompanionClickThrough | غير متاح | URI | نعم (إذا كان يعرض صورة ثابتة بدون بيانات غير قابلة للتغيير في البرنامج للنقر إلى الظهور) |
نعم | يفتح معرّف URI كصفحة مقصودة عندما ينقر المشاهد على الإعلان المصاحب. |
AltText | غير متاح | سلسلة | لا | نعم | يتم عرض اختبار Alt عند تقديم العنصر المصاحب في بيئة HTML. |
AdParameters | سلسلة | لا | لا | يتم تمرير البيانات إلى الإعلانات المصاحبة. | |
NonLinearAds | لا | لا | غير متوفر في الوقت الحالي (البث الخطي فقط) | ||
Extensions | لا | لا | |||
Extension | type | أي قيمة | لا | لا | يمكن تضمين أيّ ملف XML صالح في عقدة الإضافات ولكن سيتم تجاهله. |
Wrapper | غير متاح | غير متاح | لا | لا | عنصر من الدرجة الثانية يحيط بإعلان استجابة يشير إلى خادم إعلانات ثانوي |