تسهّل حِزم تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية دمج إعلانات الوسائط المتعددة في مواقعك الإلكترونية وتطبيقاتك. يمكن لحِزم تطوير البرامج لإعلانات الوسائط التفاعلية طلب الإعلانات من أي خادم إعلانات متوافق مع VAST وإدارة تشغيل الإعلانات في تطبيقاتك. باستخدام حِزم تطوير البرامج لإدراج الإعلانات الديناميكي في "إعلانات الوسائط التفاعلية"، تقدّم التطبيقات طلب بث لإعلان وفيديو محتوى، سواء كان فيديو عند الطلب أو محتوى مباشر. بعد ذلك، تعرض حزمة SDK بث فيديو مدمجًا، ما يغنيك عن إدارة التبديل بين الفيديو الإعلاني وفيديو المحتوى داخل تطبيقك.
اختيار حلّ "إدخال الإعلانات الديناميكي" الذي يهمّك
إدراج إعلان ديناميكي شامل
يتناول هذا الدليل عملية دمج حزمة تطوير البرامج (SDK) الخاصة بـ "الإعلانات الديناميكية أثناء عرض الفيديو" في تطبيق مشغّل فيديو. إذا أردت الاطّلاع على نموذج تكامل مكتمل أو اتّباعه، يمكنك تنزيل BasicExample من GitHub.
نظرة عامة على IMA DAI
يتضمّن تنفيذ ميزة "الإعلانات الديناميكية أثناء عرض الفيديو" في "إعلانات الوسائط التفاعلية" أربعة مكوّنات رئيسية في حزمة SDK، كما يوضّح هذا الدليل:
-
IMAAdDisplayContainer: عنصر حاوية يظهر فوق عنصر تشغيل الفيديو ويحتوي على عناصر واجهة مستخدم الإعلان. IMAAdsLoader– كائن يطلب عمليات بث ويتعامل مع الأحداث التي يتم تشغيلها بواسطة كائنات استجابة طلب البث. يجب إنشاء مثيل واحد فقط لأداة تحميل الإعلانات، ويمكن إعادة استخدامه طوال مدة تشغيل التطبيق.-
IMAStreamRequest– إماIMAVODStreamRequestأوIMALiveStreamRequestكائن يحدّد طلب بث. يمكن أن تكون طلبات البث المباشر لفيديوهات عند الطلب أو أحداث بث مباشر. تحدّد طلبات البث المباشر مفتاح مادة عرض، بينما تحدّد طلبات الفيديو عند الطلب معرّفًا في "نظام إدارة المحتوى" ومعرّف فيديو. يمكن أن يتضمّن كلا نوعَي الطلبات اختياريًا مفتاح واجهة برمجة التطبيقات اللازم للوصول إلى عمليات البث المحدّدة، ورمز شبكة "مدير إعلانات Google" لكي تتعامل أداة تطوير البرامج لإعلانات الوسائط التفاعلية من Google مع معرّفات الإعلانات على النحو المحدّد في إعدادات "مدير إعلانات Google". IMAStreamManager– عنصر يعالج عمليات بث "إدراج الإعلان الديناميكي" والتفاعلات مع الخلفية البرمجية لهذه الميزة. يتولّى مدير البث أيضًا معالجة طلبات تتبُّع ping وإعادة توجيه أحداث البث والإعلانات إلى الناشر.
المتطلبات الأساسية
قبل البدء، يجب أن يتوفّر لديك ما يلي:
- الإصدار 13 أو الإصدارات الأحدث من Xcode
- طريقة تثبيت "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية":
- Swift Package Manager (الخيار المفضّل)
- CocoaPods
- نسخة قابلة للتنزيل من حزمة تطوير البرامج للإعلانات التفاعلية على iOS
تحتاج أيضًا إلى المَعلمات لطلب البث من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية". للاطّلاع على أمثلة على مَعلمات الطلب، راجِع نماذج البث.
| مَعلمات البث المباشر | |
|---|---|
| مفتاح مادة العرض |
مفتاح مادة العرض
الذي يحدّد بثك المباشر في "مدير إعلانات Google" مثال: c-rArva4ShKVIAkNfy6HUQ
|
| مَعلمات بث الفيديو عند الطلب | |
| معرّف مصدر المحتوى |
معرّف
مصدر المحتوى
من "مدير إعلانات Google". مثال: 2548831
|
| معرّف الفيديو |
معرّف الفيديو من "إدارة إعلانات Google" مثال: tears-of-steel
|
| المَعلمات الشائعة (الفيديوهات عند الطلب والبث المباشر) | |
| رمز الشبكة |
رمز شبكة "مدير إعلانات Google" مثال: 21775744923
|
إنشاء مشروع Xcode جديد
في Xcode، أنشئ مشروعًا جديدًا على iOS باستخدام Objective-C باسم "BasicExample".
إضافة حزمة تطوير البرامج (SDK) لخدمة "الإعلانات الديناميكية أثناء البث" من "إعلانات الوسائط التفاعلية" إلى مشروع Xcode
لتثبيت "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية"، اختَر الطريقة المفضّلة.
يُنصح بتثبيت حزمة تطوير البرامج (SDK) باستخدام Swift Package Manager
تتوافق حزمة Interactive Media Ads SDK مع Swift Package Manager بدءًا من الإصدار 3.18.4. اتّبِع الخطوات التالية لاستيراد حزمة Swift.
في Xcode، ثبِّت حزمة IMA DAI SDK Swift Package من خلال الانتقال إلى ملف > إضافة حِزم.
في الطلب الذي يظهر، ابحث عن مستودع IMA DAI SDK Swift Package GitHub:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-iosاختَر إصدار حزمة IMA DAI SDK Swift Package الذي تريد استخدامه. بالنسبة إلى المشاريع الجديدة، استخدِم حتى الإصدار الرئيسي التالي.
بعد الانتهاء، يحلّ Xcode التبعيات المرتبطة بحِزمك وينزّلها في الخلفية. لمزيد من التفاصيل حول كيفية إضافة تبعيات الحِزم، يُرجى الاطّلاع على مقالة Apple.
تثبيت حزمة تطوير البرامج (SDK) لـ "الإعلانات الديناميكية أثناء البث" من "إعلانات الوسائط التفاعلية" باستخدام CocoaPods
CocoaPods هو نظام لإدارة التبعيات في مشاريع Xcode لتثبيت حزمة تطوير البرامج للإعلانات الديناميكية أثناء البث في "إعلانات الوسائط التفاعلية". لمزيد من المعلومات حول تثبيت CocoaPods أو استخدامه، يُرجى الاطّلاع على مستندات CocoaPods. بعد تثبيت CocoaPods، اتّبِع التعليمات التالية لتثبيت حزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات الوسائط التفاعلية" (IMA) في "البث المباشر" (DAI):
في الدليل نفسه الذي يحتوي على ملف BasicExample.xcodeproj، أنشئ ملفًا نصيًا باسم Podfile وأضِف الإعداد التالي:
من الدليل الذي يحتوي على Podfile، نفِّذ ما يلي:
pod install --repo-update
تنزيل حزمة تطوير البرامج (SDK) وتثبيتها يدويًا
إذا كنت لا تريد استخدام Swift Package Manager، يمكنك تنزيل حزمة تطوير البرامج (SDK) الخاصة بـ IMA وإضافتها يدويًا إلى مشروعك.
إنشاء مشغّل فيديو بسيط
نفِّذ مشغّل فيديو في وحدة التحكّم الرئيسية في العرض، واجمع مشغّل AV في عرض واجهة المستخدم. تستخدم حزمة تطوير البرامج لإعلانات الوسائط التفاعلية عرض واجهة المستخدم لعرض عناصر واجهة مستخدم الإعلان.
Objective-C
Swift
إعداد أداة تحميل الإعلانات
استورِد حزمة IMA SDK إلى وحدة التحكّم في العرض واعتمد البروتوكولَين
IMAAdsLoaderDelegate
و
IMAStreamManagerDelegate
للتعامل مع أحداث أداة تحميل الإعلانات وأداة إدارة البث.
أضِف هذه السمات الخاصة لتخزين المكوّنات الرئيسية في "أداة تطوير البرامج لإعلانات الوسائط التفاعلية":
IMAAdsLoader: تُستخدَم لإدارة طلبات البث على مدار فترة استخدام تطبيقك.IMAAdDisplayContainer- تتعامل مع إدراج عناصر واجهة مستخدم الإعلانات وإدارتها.IMAAVPlayerVideoDisplay: تتواصل هذه الحزمة بين "حزمة تطوير البرامج للإعلانات التفاعلية" ومشغّل الوسائط، وتتعامل مع البيانات الوصفية المحدّدة بوقت.IMAStreamManager- تُستخدَم لإدارة تشغيل البث المباشر وتفعيل الأحداث المرتبطة بالإعلانات.
يجب تهيئة أداة تحميل الإعلانات وحاوية عرض الإعلانات وعرض الفيديو بعد تحميل العرض.
Objective-C
Swift
تقديم طلب بث
عندما يضغط المستخدم على زر التشغيل، أرسِل طلبًا جديدًا للبث.
استخدِم فئة
IMALiveStreamRequest
للبث المباشر. بالنسبة إلى بث المحتوى عند الطلب، استخدِم الفئة
IMAVODStreamRequest.
يتطلّب طلب البث مَعلمات البث، بالإضافة إلى مرجع إلى حاوية عرض الإعلان وعرض الفيديو.
Objective-C
Swift
الاستماع إلى أحداث تحميل البث
يستدعي الصف IMAAdsLoader الطريقتَين IMAAdsLoaderDelegate عند نجاح عملية الإعداد أو تعذُّر إرسال طلب البث.
في طريقة التفويض adsLoadedWithData، اضبط IMAStreamManagerDelegate.
تهيئة مدير البث عند بدء التشغيل، يبدأ مدير البث تشغيل الفيديو.
في طريقة التفويض
failedWithErrorData، سجِّل الخطأ. يمكنك تشغيل البث الاحتياطي. اطّلِع على أفضل الممارسات المتعلّقة بميزة "الإعلانات الديناميكية أثناء عرض الفيديو".
Objective-C
Swift
الاستماع إلى أحداث الإعلانات
تستدعي IMAStreamManager
طُرق
IMAStreamManagerDelegate
لتمرير أحداث البث والأخطاء إلى تطبيقك.
في هذا المثال، سجِّل أحداث الإعلان الأساسية في وحدة التحكّم:
Objective-C
Swift
شغِّل تطبيقك. وفي حال نجاح ذلك، اطلب بث Google DAI وشغِّله باستخدام حزمة تطوير البرامج لإعلانات الوسائط التفاعلية. لمزيد من المعلومات حول ميزات حزمة تطوير البرامج (SDK) المتقدّمة، يُرجى الاطّلاع على الأدلة الأخرى المدرَجة في الشريط الجانبي الأيمن أو الأمثلة على GitHub.