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

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

إعلانات قابلة للتخطي أثناء البث عند الطلب

يشرح هذا الدليل كيفية استخدام DAI API لطلب بث فيديو عند الطلب باستخدام للإعلانات القابلة للتخطي، يجب عرض زر التخطي وفقًا متطلبات "إعلانات Google" وإرسال أحداث التتبُّع المرتبطة بها

المتطلبات الأساسية

تطبيق ينفّذ طلبات البيانات من واجهة برمجة التطبيقات DAI لبثّ الفيديوهات عند الطلب يمكنك الاطّلاع على دليل بث الفيديوهات عند الطلب في DAI API لمزيد من المعلومات.

تقديم طلب بشأن الإعلانات القابلة للتخطّي

لطلب بث فيديو عند الطلب يتضمّن إعلانات قابلة للتخطّي، يجب أن تجتاز dai-sas. في طلب بث مباشر

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

POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded

مَعلمات المسار

`{CMS_ID}`	رقم تعريف نظام إدارة المحتوى الخاص بالبث.
`{VIDEO_ID}`	معرّف الفيديو للبث.

معلمات النص الأساسي

dai-sas يجب ضبط dai-sas=1 لتفعيل الإعلانات القابلة للتخطّي.

مثال على الطلب (cURL)

لطلبات البث عبر بروتوكول HLS:

curl -X POST \
     -d 'dai-sas=1' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream

استبدال 'dash' في عنوان URL لمصادر بيانات DASH:

https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream

استخدِم التنسيق التالي لتضمين معلَمات بث متعددة في إعدادات طلبك. body:

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

التعامل مع تخطّي الإعلانات

للتعامل مع تخطي الإعلانات، استخدم المعلومات في Ad في إنشاء AdBreak اعتمادًا على ما إذا كنت تتخطّى الإعلان الحالي أم الفاصل الإعلاني بالكامل. خذ قيمة start وأضف القيمة duration، ثم انتقل إلى تلك النقطة في ساحة المشاركات. تشير رسالة الأشكال البيانية SkipMetadata تحتوي الرسالة الفرعية أيضًا على القيمة offset، وهي قيمة في ثوانٍ من الوقت قبل أن يمكن تخطّي الإعلان الرسالة الفرعية "SkipMetadata" سيتم تضمينه فقط في الإعلانات القابلة للتخطي.

ad_breaks

قائمة الفواصل الإعلانية.

start (الرقم) الموضع بالثواني في ساحة المشاركات الذي يبدأ فيه الفاصل.

duration (number) مدة الفاصل الإعلاني بالثواني.

ads

(object(Ad)) هي قائمة بالإعلانات في ساحة المشاركات

start (عدد) الموضع الذي يبدأ فيه الإعلان في ساحة المشاركات ثوانٍ.

duration (number) مدة الإعلان بالثواني.

skip_metadata

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

`offset`	(عدد) تشير قيمة الإزاحة إلى مقدار الوقت في ثانية بعد بدء الإعلان، يجب أن ينتظر المشغّل لعرض زر التخطّي ويتم حذفها إذا لم يتم توفيرها في نموذج عرض إعلانات فيديو (VAST).
`tracking_url`	(سلسلة) عنوان URL يجب إرسال فحص له عند التخطّي فعالية.

مثال على إجابة

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

بعد تخطّي الإعلان، يمكنك إشعار عنوان URL لحدث التخطّي المضمّن في استجابة البث. تم تضمينها في الرسالة الفرعية "SkipMetadata".

متطلبات زر التخطّي

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

مؤقت العد التنازلي

يجب ألا يكون الإعلان قابلاً للتخطي حتى وقت skipoffset المحدد في نموذج عرض إعلانات الفيديو (VAST). خلال هذه الفترة غير القابلة للتخطّي، عليك عرض إشعار للمستخدم لإعلامه بذلك. يمكن تخطّي الإعلان في غضون X ثانية. يجب ترجمة الإشعار إلى اللغة لغة المستخدم.

تخطي موضع الزر

بالنسبة إلى لغة من اليسار إلى اليمين، ضع زر التخطي في الجانب السفلي الأيمن من مشغّل الفيديو. بالنسبة إلى اللغة التي تبدأ من اليمين إلى اليسار، ضع زر التخطي على الجانب السفلي الأيمن من مشغّل الفيديو.

حجم زر التخطي

يجب أن يكون الزر والنص كبيرَين بما يكفي ليكونا مقروءَين بوضوح بنمط مريح المستخدم.

النص والرمز

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

تسهيل الاستخدام

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

التدويل

ننصح بترجمة نص التخطّي إلى لغة المستخدم.

مجموعات الإعلانات المتسلسلة

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

"تخطّي الإعلان" الترجمات

استخدام ملف skipAdTranslations.json لترجمة عبارة "تخطي الإعلان" نص يستند إلى لغة المستخدم.