التعرّف على بنية حزمة تطوير البرامج (SDK)
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يقدِّم هذا الدليل نظرة عامة على مراحل نشاط حزمة تطوير البرامج (SDK) والتفاعلات.
بين مشغّل الفيديو وحزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية وخادم الإعلانات.
التفاعلات الأساسية
يوضح الرسم التخطيطي التالي التفاعلات بين
مشغّل الفيديو وحزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية و"مدير الإعلانات 360"
تحمّل صفحة الويب أو التطبيق حزمة تطوير البرامج لميزة "إدراج الإعلان الديناميكي" في إعلانات الوسائط التفاعلية من خلال:
- علامة نص برمجي مضمّنة لـ HTML5
- تطبيق أصلي لنظام التشغيل Android أو Google Cast أو iOS أو tvOS أو Roku
تطلب حزمة تطوير البرامج لتكنولوجيا "إدراج الإعلان الديناميكي" في إعلانات الوسائط التفاعلية إما بثًا لفيديو عند الطلب أو بثًا مباشرًا من "مدير إعلانات Google"
360.
يستجيب "مدير الإعلانات 360" من خلال فيديو مضمّن يتضمّن إعلانًا تم إدراجه.
ينكسر.
تُحلِّل حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA DAI SDK) الاستجابة وتحدِّد نوع الوسائط الصحيح استنادًا
إلى البيئة، وتُرسِل بث الفيديو (و
الإعلانات المصاحبة إذا لزم الأمر) إلى صفحة الويب أو التطبيق.
يتفاوض مشغّل الفيديو على تفاصيل التشغيل باستخدام حزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية
لتشغيل الإعلانات.
تعمل حزمة تطوير البرامج لإعلانات الوسائط التفاعلية على تنشيط إشعار مرات الظهور وتتبُّع الأحداث حسب الحاجة.
دورة الحياة
يوضِّح هذا المخطّط البياني مراحل النشاط الكاملة لحزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية. يتم تمييز طلبات الإنشاء والطريقة
باللون الأزرق، ويتم تمييز الأحداث باللون الأحمر، ويتم عرض شروط
الخطأ باستخدام أدوات ربط باللون الأحمر ونص أحمر.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe IMA DAI SDK facilitates communication between your video player and an ad server (like Google Ad Manager 360) to seamlessly integrate ads into video content.\u003c/p\u003e\n"],["\u003cp\u003eThe SDK handles requesting the video stream, parsing ad breaks, and delivering the content to the player for playback, including companion ads.\u003c/p\u003e\n"],["\u003cp\u003eThroughout the process, the IMA SDK manages playback details, tracks ad impressions, and sends necessary event updates for monitoring and analysis.\u003c/p\u003e\n"],["\u003cp\u003eThe lifecycle of the SDK involves initialization, stream requests, ad playback, and event handling, with potential error scenarios addressed.\u003c/p\u003e\n"]]],[],null,["# Learn the SDK architecture\n\nThis guide provides an overview of the SDK lifecycle and the interactions\nbetween your video stream player, the IMA DAI SDK, and an ad server.\n\nBasic interactions\n------------------\n\nThe following diagram illustrates and annotates the interactions between\nyour video player, the IMA DAI SDK, and Ad Manager 360.\n\n1. The web page or app loads the IMA DAI SDK via:\n\n - an embedded script tag for HTML5\n - a native app for Android, Google Cast, iOS, tvOS, or Roku\n2. The IMA DAI SDK requests either a VOD stream or live stream from Google Ad\n Manager 360.\n\n3. Ad Manager 360 responds with the video stream that includes inserted ad\n breaks.\n\n4. The IMA DAI SDK parses the response, determines the correct media type based\n on environment, and delivers the video stream (and\n companion ads if needed) to the web page or app.\n\n5. The video player negotiates the playback details with the IMA DAI SDK and\n plays the ads.\n\n6. The IMA SDK fires an impression ping and tracking events, as needed.\n\nLifecycle\n---------\n\nThis diagram shows the full lifecycle of the IMA DAI SDK. Constructor and method\ncalls are highlighted in blue, events are highlighted in red, and error\nconditions are shown with red connectors and red text."]]
