این راهنما ادغام IMA DAI SDK در برنامه پخشکننده ویدیو را پوشش میدهد. اگر میخواهید یک نمونه ادغام کامل را مشاهده یا دنبال کنید، PodServingExample را از GitHub بارگیری کنید.
نمای کلی IMA DAI
همانطور که این راهنما نشان میدهد، پیادهسازی IMA DAI شامل چهار مؤلفه اصلی کیت توسعه نرمافزار است:
IMAAdDisplayContainer– شیء نگهدارندهای که روی عنصر بازپخش ویدیو قرار میگیرد و عناصر میانای کاربر آگهی را در خود جای میدهد.IMAAdsLoader– شیئی که درخواست جاریسازی میکند و رویدادهای راهاندازیشده توسط اشیای پاسخ درخواست جاریسازی را مدیریت میکند. باید فقط یک بارگذارنده آگهی را نمونهسازی کنید که بتواند درطول عمر برنامه دوباره استفاده شود.IMAStreamRequest– یاIMAPodVODStreamRequestیاIMAPodStreamRequest.IMAStreamManager– شیئی که جریانهای درج آگهی پویا و تعاملات با پسبخش DAI را مدیریت میکند. مدیر جاریسازی همچنین پینگهای ردیابی را مدیریت میکند و رویدادهای جاریسازی و آگهی را به ناشر بازارسال میکند.
علاوهبراین، برای پخش کردن جاریسازیهای ارائهدهنده پاد، یک گرداننده VTP سفارشی پیادهسازی کنید. این گرداننده VTP سفارشی شناسه جاریسازی را بههمراه هر اطلاعات دیگری که برای برگرداندن مانیفست جاریسازی حاوی محتوا و آگهیهای ادغامشده لازم است به شریک فنی ویدیو (VTP) شما ارسال میکند. «ارائهدهنده گواهی مجازی» شما دستورالعملهایی درباره نحوه پیادهسازی گرداننده «ارائهدهنده گواهی مجازی» سفارشی ارائه میدهد.
پیشنیازها
قبلاز شروع، به موارد زیر نیاز دارید:
- Xcode نسخه ۱۳ یا بالاتر
- روش نصب کیت توسعه نرمافزار آگهیهای رسانهای تعاملی:
- Swift Package Manager (ترجیحی)
- نسخه بارگیریشده کیت توسعه نرمافزار IMA برای iOS
همچنین به پارامترهایی برای درخواست جاریسازی از کیت توسعه نرمافزار IMA نیاز دارید.
| پارامترهای جاریسازی زنده | |
|---|---|
| کد شبکه |
کد شبکه برای حساب Ad Manager 360 شما. |
| کلید دارایی سفارشی |
کلید دارایی سفارشی که رویداد «ارائه پاد» شما را در Ad Manager 360 شناسایی میکند. دستکاریکننده مانیفست شما یا شریک شخص ثالث ارائهدهنده Pod این را ایجاد میکند. |
| پارامترهای جاریسازی ویدیو بهدرخواست | |
| کد شبکه |
کد شبکه برای حساب Ad Manager 360 شما. |
ایجاد پروژه Xcode جدید
در Xcode، پروژه iOS جدیدی بااستفاده از Objective-C با نام «PodServingExample» ایجاد کنید.
افزودن IMA DAI SDK به پروژه Xcode
برای نصب کیت توسعه نرمافزار آگهیهای رسانهای تعاملی، روش ترجیحی را انتخاب کنید.
توصیهشده: نصب کیت توسعه نرمافزار بااستفاده از Swift Package Manager
کیت توسعه نرمافزار آگهیهای رسانهای تعاملی از نسخه ۳.۱۸.۴ از مدیر بسته Swift پشتیبانی میکند. برای وارد کردن بسته Swift، این مراحل را دنبال کنید.
در Xcode، بسته IMA DAI SDK Swift را نصب کنید: به File > Add Packages بروید.
در پیاموارهای که ظاهر میشود، مخزن GitHub بسته Swift مربوط به IMA DAI SDK را جستجو کنید:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-iosنسخه «بسته IMA DAI SDK Swift» را که میخواهید استفاده کنید انتخاب کنید. برای پروژههای جدید، از Up to Next Major Version استفاده کنید.
وقتی کارتان تمام شد، Xcode وابستگیهای بسته شما را حل میکند و آنها را در پسزمینه بارگیری میکند. برای جزئیات بیشتر درباره نحوه افزودن وابستگیهای بسته، مقاله Apple را ببینید.
بارگیری و نصب دستی کیت توسعه نرمافزار (SDK)
اگر نمیخواهید از Swift Package Manager استفاده کنید، «کیت توسعه نرمافزار آگهیهای رسانهای تعاملی» را بارگیری کنید و بهصورت دستی به پروژهتان اضافه کنید.
ایجاد پخشکننده ویدیو
پخشکننده ویدیو را در کنترلکننده نمای اصلیتان پیادهسازی کنید؛ پخشکننده AV را در نمای واسط کاربر قرار دهید. کیت توسعه نرمافزار IMA از نمای میانای کاربر برای نمایش عناصر میانای کاربر آگهی استفاده میکند.
آبجکتیو-سی
Swift
راهاندازی بارکننده آگهی
«کیت توسعه نرمافزار آگهیهای رسانهای تعاملی» را به کنترلکننده نمای خود وارد کنید و پروتکلهای
IMAAdsLoaderDelegate
و
IMAStreamManagerDelegate
را برای مدیریت رویدادهای بارکننده آگهی و مدیر جاریسازی اتخاذ کنید.
این ویژگیهای خصوصی را برای ذخیره کردن مؤلفههای کلیدی کیت توسعه نرمافزار IMA اضافه کنید:
IMAAdsLoader- درخواستهای جاریسازی را در طول عمر برنامهتان مدیریت میکند.
IMAAdDisplayContainer- مدیریت درج و مدیریت عناصر میانای کاربر آگهی.
IMAAVPlayerVideoDisplay- بین کیت توسعه نرمافزار آگهیهای رسانهای تعاملی و پخشکننده رسانه شما ارتباط برقرار میکند و فرادادههای زمانبندیشده را مدیریت میکند.IMAStreamManager- بازپخش جاریسازی را مدیریت میکند و رویدادهای مرتبط با آگهی را فعال میکند.
بارکننده آگهی، محفظه نمایش آگهی، و نمایش ویدیو را پساز بار شدن نما مقداردهی اولیه کنید.
آبجکتیو-سی
Swift
درخواست جاریسازی
وقتی کاربر دکمه پخش را فشار میدهد، درخواست جاریسازی جدیدی ایجاد کنید.
از کلاس
IMAPodStreamRequest
برای جاریسازیهای زنده استفاده کنید. برای جاریسازیهای «ویدیو بهدرخواست»، از کلاس
IMAPodVODStreamRequest
استفاده کنید.
درخواست جاریسازی به پارامترهای جاریسازی شما و همچنین ارجاع به محفظه نمایش آگهی و نمایش ویدیو شما نیاز دارد.
آبجکتیو-سی
Swift
گوش دادن به رویدادهای بار کردن جاریسازی
کلاس IMAAdsLoader
روشهای
IMAAdsLoaderDelegate
را درصورت موفقیت یا عدم موفقیت راهاندازی درخواست جاریسازی فراخوانی میکند.
در روش نماینده adsLoadedWithData،
IMAStreamManagerDelegate خود را تنظیم کنید.
شناسه جاریسازی را به گرداننده VTP سفارشیتان ارسال کنید و نشانی وب مانیفست جاریسازی را بازیابی کنید. برای جاریسازیهای زنده، نشانی وب مانیفست را در نمایشگر ویدیو بار کنید،
و بازپخش را شروع کنید. برای جاریسازیهای «ویدیو بهدرخواست»، نشانی وب مانیفست را به روش
loadThirdPartyStream
مدیر جاریسازی ارسال کنید. این روش دادههای رویداد آگهی را از Ad Manager 360 درخواست میکند، سپس نشانی وب مانیفست را بار میکند و بازپخش را شروع میکند.
در روش نماینده
failedWithErrorData
، خطا را ثبت کنید. درصورت تمایل، جاریسازی پشتیبان را پخش کنید. روالهای مطلوب درج آگهی پویا را ببینید.
آبجکتیو-سی
Swift
پیادهسازی کنترلکننده VTP سفارشی
گرداننده VTP سفارشی شناسه جاریسازی بیننده را بههمراه هر اطلاعات دیگری که VTP شما برای برگرداندن مانیفست جاریسازی حاوی محتوا و آگهیهای ادغامشده نیاز دارد به شریک فنی ویدیو (VTP) شما ارسال میکند. VTP شما دستورالعملهای خاصی درباره نحوه پیادهسازی گرداننده VTP سفارشی شما ارائه میدهد.
برای مثال، یک VTP ممکن است شامل یک نشانی وب الگوی مانیفست حاوی ماکرو
[[STREAMID]] باشد. در این مثال، گرداننده شناسه جاریسازی را بهجای ماکرو درج میکند و نشانی وب مانیفست حاصل را برمیگرداند.
آبجکتیو-سی
Swift
گوش دادن به رویدادهای آگهی
IMAStreamManager
روشهای
IMAStreamManagerDelegate
را برای ارسال رویدادها و خطاهای جاریسازی به برنامهتان فراخوانی میکند.
برای این مثال، رویدادهای آگهی اصلی را در کنسول ثبت کنید:
آبجکتیو-سی
Swift
پاکسازی داراییهای IMA DAI
برای متوقف کردن بازپخش جاریسازی، متوقف کردن همه ردگیریهای آگهی، و واگذار کردن همه
داراییهای جاریسازی بارشده، IMAStreamManager.destroy() را فراخوانی کنید.
برنامهتان را اجرا کنید. اگر موفقیتآمیز بود، با کیت توسعه نرمافزار IMA، جاریسازیهای Google DAI را درخواست و پخش کنید. برای آشنایی با ویژگیهای پیشرفتهتر کیت توسعه نرمافزار، به سایر راهنماهای فهرستشده در نوار کناری سمت راست یا نمونههای موجود در GitHub مراجعه کنید.