إعلانات الفيديو

يوضّح هذا الدليل متطلبات الدمج والإعداد والحقول ذات الصلة التي يمكنك استخدامها عند تقديم عروض أسعار على المساحات الإعلانية المتاحة للفيديو.

تتيح Google "إعلانات الفيديو أثناء عرض الفيديو" و"إعلانات الفيديو المدمجة مع المحتوى" و"إعلانات الفيديو البينية" التي يتم تمثيلها كفرص إعلانية فردية أو مجموعات إعلانات فيديو متسلسلة ديناميكية. تصف المجموعات الديناميكية مجموعة من إعلانات الفيديو التي يتم عرضها بشكل متسلسل، حيث يتم تقسيم الحد الأقصى لمدة المجموعة إلى فيديو واحد أو أكثر يختلف في الطول. يمكنك الاطّلاع على أدلة الإعلانات المدمجة مع المحتوى والإعلانات البينية لمزيد من التفاصيل حول هذين الشكلَين.

متطلبات المشترين

بروتوكول عرض الأسعار في الوقت الفعلي (RTB)

سيشير هذا الدليل بشكل عام إلى تنسيق Protobuf، ولكن أسماء الحقول والمسارات متكافئة بينه وبين تنسيق JSON ما لم يُذكر خلاف ذلك.

يمكنك العثور على نموذج OpenRTB وإضافات OpenRTB الخاصة بـ Google في صفحة النماذج والبيانات المرجعية. لمزيد من المعلومات حول تطوير مقدِّم عرض سعر، يُرجى الاطّلاع على معالجة الطلب وإنشاء الردّ.

مراجعة تصميم الإعلان

تنصح Google بإرسال تصاميم الإعلانات للموافقة عليها قبل تقديم عروض أسعار باستخدامها. يمكنك استخدام مورد تصميمات الإعلانات في Real-time Bidding API لبدء عملية المراجعة.

إعدادات الاستهداف المُسبَق

لتلقّي المساحات المتاحة لإعلانات الفيديو، يجب أن ينشئ حسابك على "الشراة المعتمَدون" إعدادات استهداف مسبق تتضمّن المساحات المتاحة لإعلانات الفيديو.

وحدات ماكرو

يمكنك تحديد وحدات ماكرو في رابط عنوان URL للفيديو أو في ملف VAST XML المحدّد في BidResponse.seatbid.bid.adm. بالإضافة إلى ذلك، إذا حدّدت عنوان URL لفيديو، يمكنك أيضًا وضع وحدات ماكرو ضمن مستند VAST XML المرتبط. تتوفّر وحدات الماكرو التالية لتصاميم إعلانات الفيديو:

• %%CACHEBUSTER%%
• %%WINNING_PRICE%%
• %%SITE%%

لا تتوفّر وحدات ماكرو لتتبُّع النقرات، مثل CLICK_URL_ESC، لأنّ "الشراة المعتمَدون" يتضمّن خدمات تتبُّع النقرات في استجابة VAST. لمزيد من المعلومات حول وحدات الماكرو المتوافقة، يُرجى الاطّلاع على تحديد وحدات الماكرو.

تفاصيل وسيلة الشرح

يمكنك استخدام حقل BidRequest.imp.video في OpenRTB لتحديد ما إذا كان طلب عرض السعر الوارد مخصّصًا لمساحة إعلانية متاحة لإعلانات الفيديو أثناء عرض الفيديو أو الإعلانات البينية، والعثور على معلومات إضافية خاصة بالفيديو حول الطلب. بالإضافة إلى ذلك، بالنسبة إلى المساحات الإعلانية المتاحة للإعلانات المدمجة مع المحتوى، يمكنك استخدام BidRequest.imp.native.{request/request_native}.assets.video للحصول على معلومات مشابهة خاصة بالفيديو.

BidRequest.{app/site}.content.producer.domain

عنوان URL للصفحة التي تصف محتوى الفيديو، مع إزالة المَعلمات يرسل الناشر عنوان URL هذا إلى Google. على سبيل المثال:

http://www.publisher.com/watchpagelink

banner.vcm

في حال ضبط هذه السمة على true، يمكن اختيار الإعلان المصاحب ليتم عرضه كبطاقة معلومات في خانة الفيديو بعد انتهاء تشغيل إعلان الفيديو. وإلا، لن يتم عرض الإعلان المصاحب كإعلان يظهر في نهاية الفيديو.

BidRequest.imp.rwdd

إذا تم ضبطها على true، يشير ذلك إلى أنّ المستخدم يحصل على مكافأة مقابل مشاهدة إعلان الفيديو. وقد تشمل المكافآت المعتادة قراءة مقالة إضافية مجانًا أو الحصول على حياة إضافية في لعبة أو الحصول على جلسة موسيقية برعاية جهة معيّنة وبلا إعلانات.

BidRequest.imp.video.maxduration

الحدّ الأقصى المسموح به للمدّة بالثواني لكلّ إعلان فردي مضمّن في الاستجابة لعرض السعر في حال عدم ضبط هذه السياسة، لن يكون هناك حدّ أقصى للمدة. عندما تكون قيمة السمة BidRequest.imp.video.skip هي true، قد يختلف سلوك هذه السمة. يمكنك الاطّلاع على الحد الأقصى لمدة الفيديو القابل للتخطي لمزيد من التفاصيل.

BidRequest.imp.video.maxseq

الحدّ الأقصى لعدد الإعلانات التي يمكن عرضها في مجموعة إعلانات فيديو متسلسلة ديناميكية. إذا تم ضبط poddur، ولكن لم يتم ضبط maxseq أو تم ضبطه على 0، لن يكون لديك قيد على عدد الإعلانات التي يمكن عرضها في مجموعة إعلانات متسلسلة. لا تتيح Google سوى مجموعات الإعلانات الديناميكية.

يمكن أن يكون العدد الفعلي لإعلانات الفيديو المعروضة أقل من هذه القيمة أو مساويًا لها، ولكن لا يمكن أن يتجاوزها.

BidRequest.imp.video.minduration

الحدّ الأدنى للمدّة بالثواني لكلّ إعلان فردي مضمّن في الاستجابة لعرض السعر. في حال عدم ضبط هذه السمة، لن يكون هناك حدّ أدنى للمدة.

BidRequest.imp.video.plcmt

تصف هذه السمة مكان تشغيل الفيديو.

PLCMT_UNKNOWN	الموضع غير معروف أو لا يمكن تحديده.
PLCMT_INSTREAM	"الإعلانات ما قبل التشغيل" و"الإعلانات أثناء التشغيل" و"الإعلانات ما بعد التشغيل" التي يتم تشغيلها قبل محتوى الفيديو الذي طلبه المستهلك أو أثناء بثّه أو بعده. يجب ضبط إعدادات "إعلانات الفيديو أثناء عرض الفيديو" على "تفعيل الصوت" تلقائيًا عند بدء تشغيل المشغّل، أو أن تكون نية المستخدم واضحة وصريحة لمشاهدة محتوى الفيديو. قد يكون هناك محتوى آخر يحيط بالمشغّل، ولكن يجب أن يكون محتوى الفيديو هو السبب الرئيسي لزيارة المستخدم. ويجب أن يبقى المحتوى الأساسي على الصفحة ومشغّل الفيديو الوحيد الذي يظهر على الشاشة ويمكنه تشغيل الصوت. إذا تم تحويل المشغّل إلى مشغّل عائم/ثابت، يجب أن تنقل طلبات عرض الإعلانات اللاحقة حجم المشغّل المعدَّل بدقة.
PLCMT_ACCOMPANYING_CONTENT	"إعلانات ما قبل التشغيل" و"إعلانات أثناء التشغيل" و"إعلانات ما بعد التشغيل" التي يتم تشغيلها قبل بث محتوى الفيديو أو أثناء بثه أو بعده يتم تحميل مشغّل الفيديو وتشغيله قبل فقرات المحتوى النصي أو الرسومي أو بينها أو بعدها، ويبدأ تشغيله فقط عندما يدخل إلى إطار العرض. يجب ألا يبدأ تشغيل المحتوى المصاحب إلا عند الدخول إلى إطار العرض. وقد يتحوّل إلى مشغّل عائم أو ثابت أثناء الانتقال إلى أسفل الصفحة.
PLCMT_INTERSTITIAL	إعلانات الفيديو التي يتم تشغيلها بدون محتوى فيديو أثناء التشغيل، يجب أن يكون الفيديو هو المحتوى الرئيسي للصفحة وأن يشغل معظم إطار العرض، ولا يمكن إخفاؤه من خلال الانتقال إلى أسفل الصفحة. ويمكن أن يكون ذلك في مواضع مثل الفيديو داخل التطبيق أو عروض الشرائح.
PLCMT_NO_CONTENT_STANDALONE	إعلانات الفيديو التي يتم تشغيلها بدون بث محتوى فيديو ويمكن أن تظهر في مواضع مثل عروض الشرائح أو الخلاصات المدمجة مع المحتوى أو ضمن المحتوى أو في مواضع ثابتة/عائمة.

BidRequest.imp.video.playbackmethod

تصف هذه السمة كيفية تشغيل إعلان الفيديو. يتم تحديد طريقة التشغيل على أنّها تشغيل تلقائي أو انقر للتشغيل استنادًا إلى أفضل قياس متاح.

AUTO_PLAY_SOUND_ON	يبدأ تشغيل الإعلان عند تحميل الصفحة مع تفعيل الصوت.
AUTO_PLAY_SOUND_OFF	يبدأ تشغيل الإعلان عند تحميل الصفحة ويكون الصوت مكتومًا.
CLICK_TO_PLAY	يبدأ التشغيل عند النقر مع تفعيل الصوت.
MOUSE_OVER	يبدأ التشغيل عند تمرير مؤشر الماوس مع تفعيل الصوت.
ENTER_SOUND_ON	يبدأ تشغيل الإعلان عند دخوله إلى إطار العرض مع تفعيل الصوت.
ENTER_SOUND_OFF	يبدأ تشغيل الإعلان عند دخوله إلى إطار العرض مع إيقاف الصوت تلقائيًا.

BidRequest.imp.video.skip

إذا كانت القيمة true، يشير ذلك إلى أنّ المشغّل سيسمح بتخطّي الفيديو أو أنّ الإعلانات القابلة للتخطّي مسموح بها. وإذا لم يتم ضبطها، يشير ذلك إلى أنّه لا يُسمح بعرض الإعلانات القابلة للتخطي.

BidRequest.imp.video.startdelay

تشير القيمة 0 إلى "إعلان ما قبل التشغيل"، وتشير القيمة ‎-1 إلى "إعلان أثناء التشغيل"، وتشير القيمة ‎-2 إلى "إعلان ما بعد التشغيل".

وأي قيمة موجبة أخرى هي الوقت بالثواني من بداية الفيديو إلى النقطة التي يتم فيها عرض الإعلان.

BidRequest.imp.video.durfloors وBidRequest.imp.audio.durfloors

مصفوفة من عناصر DurFloors تشير إلى الأسعار الدنيا المعنية لمواد إبداعية لإعلانات الفيديو أو مواد إبداعية صوتية بمُدد مختلفة قد يقدّم المشتري عروض أسعار لها.

في ما يلي مثال على الشكل الذي ستبدو عليه السمة durfloors التي تحدّدها Google:

1. ‫{"maxdur": 16, "bidfloor": 5} تمثّل (0, 16) ثانية في $5.
2. ‫{"mindur": 16, "maxdur": 31, "bidfloor": 10} تمثّل [16, 31) ثانية عند $10.
3. ‫{"mindur": 31, "bidfloor": 20} تمثّل [31, inf) ثانية في $20.

لا تقتصر هذه الإشارات على تصاميم إعلانات الفيديو، ولكنّها ذات قيمة خاصة لمقدّمي عروض الأسعار:

BidRequest.device.ifa

هذا الحقل هو معرّف فريد عالمي (UUID) مكوّن من 36 حرفًا يتم ضبطه فقط عند استخدام طبقة المقابس الآمنة (SSL)، ولا تتم تجزئته. وهو الإصدار غير المشفّر من BidRequest.device.dpidm5. بالنسبة إلى أجهزة iOS، يحتوي على معرّف المعلِنين (IDFA) بجميع الأحرف الكبيرة. بالنسبة إلى أجهزة Android، يحتوي على معرّف Android ‏(ADID) بجميع الأحرف الصغيرة. بالنسبة إلى أجهزة التلفزيون المتّصل، يحتوي على معرّفاتها الفريدة (مثل معرّف RIDA من Roku).

BidRequest.device.devicetype

تحدّد هذه السمة نوع الجهاز.

MOBILE	اسم بديل قديم لـ HIGHEND_PHONE أو TABLET
PERSONAL_COMPUTER	يشمل ذلك أجهزة الكمبيوتر المكتبي والمحمول.
CONNECTED_TV	يشمل ذلك كلاً من أجهزة التلفزيون المتصلة (أي أجهزة التلفزيون الذكية) والأجهزة المتصلة (مثل Roku وApple TV وما إلى ذلك).
HIGHEND_PHONE	تشمل هذه الفئة الهواتف المتطوّرة.
TABLET	تشمل الأجهزة اللوحية.
CONNECTED_DEVICE	تشمل هذه الفئة أجهزة الألعاب المخصّصة.
SET_TOP_BOX	يشمل ذلك أجهزة الاستقبال.
OOH_DEVICE	ويشمل ذلك أجهزة الإعلانات خارج المنزل، مثل اللوحات الإعلانية الرقمية.

BidRequest.device.make

تحدّد العلامة التجارية للجهاز (مثل Nokia أو Samsung).

BidRequest.device.model

تحدّد هذه السمة الطراز الدقيق للجهاز (مثل N70 أو Galaxy) إذا كان متاحًا، وإلا ستحتوي على طراز عام مثل "iphone" أو "ipad".

BidRequest.imp.metric

عند ضبط Metric.type على completion_rate، سيكون Metric.value كسرًا في النطاق [0.0, 1.0] يمثّل معدّل الإكمال السابق لإعلانات الفيديو التي يتم عرضها في الخانة الإعلانية. تشير القيمة التلقائية -1.0 إلى أنّ بيانات معدّل الإكمال السابقة غير متاحة.

BidRequest.imp.video.poddur

المدة بالثواني التي يمكنك ملؤها لمجموعة إعلانات فيديو ديناميكية متسلسلة. يشير هذا الحقل إلى مدة الفاصل الإعلاني بالكامل. في حال عدم ضبط هذه السمة، لن تكون الخانة الإعلانية جزءًا من مجموعة إعلانات.

يحتوي طلب عرض سعر الفيديو أيضًا على معلومات عن المساحة الإعلانية المتاحة، مثل المجال والجهات المسموح بها ومعلومات القناة. تنطبق أيضًا جميع الحقول الحالية الأخرى في طلب عرض السعر على الفيديو.

يتوافق حقلا العرض والارتفاع في رسالة AdSlot لطلب فيديو مع حجم مشغّل إعلانات الفيديو.

BidRequest.imp.ext.allowed_vendor_type

المورّدون المسموح بهم يمكنك الاطّلاع على ملف vendors.txt في المستندات الفنية للحصول على قائمة بأرقام التعريف. على سبيل المثال، 309 = وحدة فيديو DFA.

BidRequest.imp.video.mimes

قائمة مسموح بها تصف أنواع MIME للمحتوى المتوافقة مع الإعلانات التي يتم عرضها استجابةً لطلب عرض السعر، مثل "video/mp4". يجب أن تشير الاستجابة لعرض السعر إلى إتاحة واحد منها على الأقل.

BidRequest.imp.video.protocols

تصف إصدارات VAST المتوافقة مع الناشر لطلبات عرض إعلانات الفيديو. يحتوي على مصفوفة من قيم تعداد Protocol، بما في ذلك: VAST_2_0 وVAST_3_0 وVAST_2_0_WRAPPER وVAST_3_0_WRAPPER وVAST_4_0 وVAST_4_0_WRAPPER والمزيد.

BidRequest.imp.video.companionad

يتضمّن هذا الحقل مصفوفة من عناصر Banner التي تمثّل الإعلانات المصاحبة في حال توفّرها.

BidRequest.site.page

عنوان URL لصفحة مشاهدة الفيديو أو عنوان URL للصفحة التي تم تضمين الفيديو فيها على سبيل المثال:

http://www.publisher.com/watchpagelink

عند الردّ على طلب إعلان فيديو، على مقدّم عرض السعر عرض عنوان URL لإعادة توجيه VAST أو ملف XML لنموذج عرض إعلانات الفيديو (VAST) في الحقل BidResponse.seatbid.bid.adm. يجب أن تحتوي الاستجابة لعرض السعر أيضًا على البيان المناسب لإعلان الفيديو. في ما يلي مقتطف من استجابة صحيحة لعرض سعر إعلان فيديو:

id: "eW3q768m3k93fv93a80tGQ"
seatbid {
  bid {
    id: "0uMc95E6ClImM3p5FSe"
    impid: "1"
    price: 0.034745
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_168019"
    cat: "7"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 61170857882
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 30
}

في ما يلي الحقول المهمة في الاستجابة لعرض سعر فيديو:

BidResponse.seatbid.bid.ext.attribute

سمات الإعلانات التي قد تظهر من هذا المقتطف اطّلِع على ملف buyer-declarable-creative-attributes.txt للحصول على قائمة أرقام التعريف. نتحقّق من عدم تطابق أي من هذه السمات مع السمات التي لا يسمح بها الناشر في طلب عرض السعر. على سبيل المثال، إذا كان أيّ من الحقلَين يتضمّن 30، يشير ذلك إلى أنّ الإعلان يتطلّب توفُّر VPAID لعرضه.

BidResponse.seatbid.bid.adm

بالنسبة إلى إعلانات الفيديو، هذا هو عنوان URL لإعادة توجيه VAST لإعلان الفيديو. على سبيل المثال:

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

بدلاً من ذلك، قد يكون هذا رمز XML بسيطًا لنموذج عرض إعلانات الفيديو (VAST).

أمثلة على طلبات عروض الأسعار والاستجابات لها

• أمثلة على طلبات عروض أسعار الفيديو
• استجابات عروض أسعار الفيديو النموذجي

تصحيح الإعلانات القابلة للتخطي

تطبّق Google تلقائيًا ميزة "تصحيح الإعلانات القابلة للتخطي" على عروض الأسعار في الوقت الفعلي للمساحة الإعلانية المتاحة للفيديو، ما قد يمنع فلترة عروض أسعارك من المزاد بسبب الاختلافات بين إمكانية التخطي المطلوبة في طلب عرض السعر وإمكانية تخطي تصاميم الإعلانات التي تعرضها في الاستجابة لعرض السعر. لا يتم تطبيق تصحيح الإعلانات القابلة للتخطي في الحالات التالية:

• يتم تنفيذ تصميم الإعلان الذي تحدّده في الاستجابة لعرض السعر باستخدام VPAID. يمكنك تحديد تصاميم إعلانات الفيديو التي يتم تنفيذها باستخدام معيار دقّة واجهة عرض الإعلانات على مشغّل الفيديو (VPAID) من خلال حقل Creative.video.videoMetadata.isVpaid في عرض الأسعار في الوقت الفعلي API.
• سيُعرض تصميم الإعلان من قِبل الناشر. ويمكنك تحديد ذلك استنادًا إلى الحقل BidRequest.imp.displaymanager، والذي يكون 'PUBLISHER' إذا كان الناشر سيعرض تصميم الإعلان.

في ما يلي أمثلة توضّح كيفية تطبيق ميزة "تصحيح الإعلانات القابلة للتخطي":

• السيناريو 1:
• تتلقّى طلب عرض سعر مع ضبط الحقل BidRequest.imp.video.skip على 0 لتنسيق JSON أو false لتنسيق Protobuf.
• أنت تقدّم عرض سعر باستخدام تصميم إعلان قابل للتخطّي.
• النتيجة: يدخل عرض سعرك في المزاد. إذا فاز عرض السعر الذي قدّمته وتم عرض تصميم إعلان الفيديو، سيتم عرضه كإعلان غير قابل للتخطّي.
• السيناريو الثاني:
• تتلقّى طلب عرض سعر مع ضبط الحقل BidRequest.imp.video.skip على 1 لتنسيق JSON أو true لتنسيق Protobuf.
• إذا قدّمت عرض سعر يتضمّن تصميم إعلان غير قابل للتخطّي مدته أطول من المدة المحدّدة في الحقل BidRequest.imp.video.skipmin.
• النتيجة: يدخل عرض سعرك في المزاد. إذا فاز عرض السعر الذي قدّمته وتم عرض تصميم إعلان الفيديو، سيتم عرضه كإعلان قابل للتخطي.

تنسيقات الفيديو

• كيف يمكن للمشترين تضمين فيديو؟
• الإشارات المقترَحة في OpenRTB لجميع أشكال إعلانات الفيديو
• الإشارات المقترَحة لبروتوكول "الشراة المعتمَدون" لجميع أشكال إعلانات الفيديو
• كيف يمكن للناشرين السماح بالفيديو أو عدم السماح به؟
• الحالات القصوى

كيف يمكن للمشترين تضمين فيديو؟

توضّح الجداول التالية الطرق التي يمكن للمشترين من خلالها تضمين الفيديو في تصاميم إعلاناتهم ومواضع الإعلانات التي يمكن عرضها فيها على الويب وتطبيقات الأجهزة الجوّالة على التوالي.

الويب

التطبيق المتوافق مع الأجهزة الجوّالة

الإشارات المقترَحة في OpenRTB

توضّح الجداول التالية الإشارات المقترَحة من OpenRTB لجميع أشكال إعلانات الفيديو على أجهزة الكمبيوتر المكتبي والويب على الأجهزة الجوّالة والتطبيقات للأجهزة الجوّالة.

أجهزة الكمبيوتر المكتبية والويب على الأجهزة الجوّالة

تطبيق للأجهزة الجوّالة

كيف يمكن للناشرين السماح بالفيديو أو عدم السماح به؟

يوضّح الجدول التالي الطرق التي يمكن للناشرين من خلالها السماح بعرض الفيديو أو عدم السماح به في مواضع إعلاناتهم.

الحالات القصوى

مسرد المصطلحات

يُرجى الاطّلاع على مسرد مصطلحات الفيديو في "الشراة المعتمَدون".

الحقول ذات الصلة بأشكال "الإعلانات أثناء عرض الفيديو" و"الإعلانات خارج البث"

يُرجى الاطّلاع على OpenRTB 2.5 (بدءًا من الصفحة 47)

مصدر قيمة طلب عرض السعر