کیتهای توسعه نرمافزار IMA ادغام آگهیهای چندرسانهای در وبسایتها و برنامههایتان را آسان میکنند. کیتهای توسعه نرمافزار IMA میتوانند از هر سرور آگهی سازگار با VAST درخواست آگهی کنند و بازپخش آگهی را در برنامههایتان مدیریت کنند. با کیتهای توسعه نرمافزار IMA DAI، برنامهها درخواست جاریسازی برای آگهی و ویدیو محتوا—چه VOD و چه محتوای زنده—ایجاد میکنند. سپس کیت توسعه نرمافزار یک جریان ویدیویی ترکیبی برمیگرداند، بنابراین لازم نیست جابهجایی بین ویدیو آگهی و محتوا را در برنامهتان مدیریت کنید.
راهحل DAI موردعلاقهتان را انتخاب کنید
«بازرسی پویای ARP» کامل
این راهنما یکپارچهسازی IMA DAI SDK در برنامه پخشکننده ویدیو را پوشش میدهد. اگر میخواهید یکپارچهسازی نمونه تکمیلشده را مشاهده کنید یا دنبال کنید، BasicExample را از GitHub بارگیری کنید.
نمای کلی IMA DAI
همانطور که این راهنما نشان میدهد، پیادهسازی IMA DAI شامل چهار مؤلفه اصلی کیت توسعه نرمافزار است:
IMAAdDisplayContainer– یک شیء ظرف که در بالای عنصر بازپخش ویدیو قرار میگیرد و عناصر میانای کاربر آگهی را در خود جای میدهد.IMAAdsLoader– شیئی که جاریسازیها را درخواست میکند و رویدادهای را که توسط اشیای پاسخ درخواست جاریسازی راهاندازی میشوند مدیریت میکند. فقط باید یک بارکننده آگهیها را نمونهسازی کنید که میتواند درطول عمر برنامه دوباره استفاده شود.IMAStreamRequest–IMAVODStreamRequestیاIMALiveStreamRequest. شیئی که درخواست جاریسازی را تعریف میکند. درخواستهای جاریسازی میتواند برای ویدیو بهدرخواست یا جاریسازی زنده باشد. درخواستهای جاریسازی زنده یک کلید دارایی را مشخص میکنند، درحالیکه درخواستهای VOD یک شناسه CMS و شناسه ویدیو را مشخص میکنند. هر دو نوع درخواست میتوانند بهصورت اختیاری شامل کلید API موردنیاز برای دسترسی به جاریسازیهای مشخصشده و کد شبکه Google Ad Manager برای IMA SDK باشند تا شناسههای آگهی را همانطور که در تنظیمات Google Ad Manager مشخص شده است مدیریت کند.-
IMAStreamManager– شیئی که جریانهای درج آگهی پویا و تعاملات با زیرینه DAI را مدیریت میکند. مدیر جاریسازی همچنین پینگهای ردیابی را مدیریت میکند و رویدادهای جاریسازی و آگهی را به ناشر بازارسال میکند.
پیشنیازها
قبلاز شروع، به موارد زیر نیاز دارید:
- Xcode 13 یا نسخههای جدیدتر
- روش نصب کیت توسعه نرمافزار آگهیهای رسانهای تعاملی:
- مدیر بسته Swift (ترجیحی)
- نسخه بارگیریشده کیت توسعه نرمافزار IMA برای iOS
همچنین به پارامترهایی برای درخواست جاریسازی از کیت توسعه نرمافزار IMA نیاز دارید. برای نمونههایی از پارامترهای درخواست، جاریسازیهای نمونه را ببینید.
| پارامترهای جاریسازی زنده | |
|---|---|
| کلید دارایی |
کلید دارایی
شناسایی جاریسازی زنده شما در Google Ad Manager. مثال: c-rArva4ShKVIAkNfy6HUQ
|
| پارامترهای جاریسازی VOD | |
| شناسه منبع محتوا |
شناسه
منبع محتوا
از Google Ad Manager. مثال: 2548831
|
| شناسه ویدیو |
شناسه ویدیو از Google Ad Manager. مثال: tears-of-steel
|
| پارامترهای مشترک (ویدیو بهدرخواست و جاریسازی زنده) | |
| کد شبکه |
کد شبکه Google Ad Manager شما. مثال: 21775744923
|
ایجاد پروژه Xcode جدید
در Xcode، پروژه iOS جدیدی بااستفاده از Objective-C با نام «BasicExample» ایجاد کنید.
افزودن IMA DAI SDK به پروژه Xcode
برای نصب «کیت توسعه نرمافزار IMA»، روش ترجیحیتان را انتخاب کنید.
توصیهشده: «کیت توسعه نرمافزار» را بااستفاده از «مدیر بسته Swift» نصب کنید
کیت توسعه نرمافزار آگهیهای رسانهای تعاملی از نسخه ۳.۱۸.۴ از مدیر بسته Swift پشتیبانی میکند. برای وارد کردن بسته Swift، این مراحل را دنبال کنید.
در Xcode، «بسته Swift کیت توسعه نرمافزار IMA DAI» را نصب کنید: به File > Add Packages (فایل > افزودن بستهها) بروید.
در پیاموارهای که ظاهر میشود، مخزن IMA DAI SDK Swift Package GitHub را جستجو کنید:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-iosنسخه بسته IMA DAI SDK Swift را که میخواهید استفاده کنید انتخاب کنید. برای پروژههای جدید، از تا نسخه اصلی بعدی استفاده کنید.
وقتی کارتان تمام شد، Xcode وابستگیهای بسته را حل میکند و آنها را در پسزمینه بارگیری میکند. برای جزئیات بیشتر درباره نحوه افزودن وابستگیهای بسته، به مقاله Apple مراجعه کنید.
بارگیری و نصب دستی کیت توسعه نرمافزار (SDK)
اگر نمیخواهید از «مدیر بسته Swift» استفاده کنید، «کیت توسعه نرمافزار IMA» را بارگیری کنید و بهصورت دستی به پروژهتان اضافه کنید.
ایجاد پخشکننده ویدیو
پخشکننده ویدیویی را در کنترلکننده نمای اصلیتان پیادهسازی کنید؛ پخشکننده AV را در نمای UI بپیچید. کیت توسعه نرمافزار IMA از نمای میانای کاربر برای نمایش عناصر میانای کاربر آگهی استفاده میکند.
آبجکتیو-سی
Swift
راهاندازی بارکننده آگهی
«کیت توسعه نرمافزار IMA» را به کنترلکننده نمای خود وارد کنید و از
IMAAdsLoaderDelegate
و
IMAStreamManagerDelegate
پروتکلها برای مدیریت رویدادهای مدیر جاریسازی و بارکننده آگهی استفاده کنید.
این داراییهای خصوصی را برای ذخیره کردن عناصر کلیدی «کیت توسعه نرمافزار IMA» اضافه کنید:
IMAAdsLoader- درخواستهای جاریسازی را در طول عمر برنامه شما مدیریت میکند.
IMAAdDisplayContainer- عناصر میانای کاربر آگهی را درج و مدیریت میکند.
IMAAVPlayerVideoDisplay- بین «کیت توسعه نرمافزار IMA» و پخشکننده رسانه شما ارتباط برقرار میکند و فراداده زماندار را مدیریت میکند.IMAStreamManager- پخش جاریسازی را مدیریت میکند و رویدادهای مربوط به آگهی را راهاندازی میکند.
پساز بار شدن نما، بارکننده آگهی، محتوی نمایش آگهی، و نمایش ویدیو را مقداردهی اولیه کنید.
آبجکتیو-سی
Swift
درخواست جاریسازی کنید
وقتی کاربر دکمه پخش را فشار میدهد، درخواست جاریسازی جدیدی ایجاد کنید.
از کلاس
IMALiveStreamRequest
برای جاریسازیهای زنده استفاده کنید. برای جاریسازیهای VOD، از کلاس
IMAVODStreamRequest
استفاده کنید.
درخواست جاریسازی به پارامترهای جاریسازی شما و همچنین ارجاع به محفظه نمایش آگهی و نمایش ویدیو شما نیاز دارد.
آبجکتیو-سی
Swift
گوش دادن به رویدادهای بار کردن جاریسازی
کلاس IMAAdsLoader
متدهای IMAAdsLoaderDelegate
را درصورت موفقیتآمیز بودن راهاندازی یا ناموفق بودن درخواست جاریسازی فرا میخواند.
در روش نماینده adsLoadedWithData
،
IMAStreamManagerDelegate را تنظیم کنید.
مدیر جاریسازی را مقداردهی اولیه کنید. در هنگام مقداردهی اولیه، مدیر جاریسازی
بازپخش را شروع میکند.
در روش نماینده
failedWithErrorData
، خطا را ثبت کنید. درصورت تمایل، جاریسازی پشتیبان را پخش کنید. روالهای مطلوب DAI را ببینید.
آبجکتیو-سی
Swift
گوش دادن به رویدادهای آگهی
IMAStreamManager
روشهای
IMAStreamManagerDelegate
را برای انتقال رویدادهای جاریسازی و خطاها به برنامه شما فرا میخواند.
برای این مثال، رویدادهای آگهی اصلی را در کنسول ثبت کنید:
آبجکتیو-سی
Swift
برنامهتان را اجرا کنید. اگر موفق بود، با «کیت توسعه نرمافزار IMA» درخواست جاریسازیهای Google DAI کنید و آنها را پخش کنید. برای آشنایی با ویژگیهای پیشرفتهتر کیت توسعه نرمافزار، سایر راهنماهای فهرستشده در نوار کناری سمت راست یا نمونههای GitHub را ببینید.