i-mobile را با Mediation ادغام کنید

این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از i-mobile با استفاده از میانجیگری استفاده کنید، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه اضافه کردن i-mobile به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور i-mobile در یک برنامه iOS را پوشش می‌دهد.

رابط کاربری داشبورد برای i-mobile از متن ژاپنی برای برچسب‌ها، دکمه‌ها و توضیحات خود استفاده می‌کند. تصاویر موجود در این راهنما ترجمه نشده‌اند. با این حال، در توضیحات و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی آنها در داخل پرانتز ترجمه شده‌اند.

ادغام‌ها و قالب‌های تبلیغاتی پشتیبانی‌شده

آداپتور میانجیگری برای i-mobile دارای قابلیت‌های زیر است:

الزامات

• هدف استقرار iOS 12.0 یا بالاتر

• جدیدترین SDK تبلیغات موبایلی گوگل

• راهنمای شروع میانجیگری را تکمیل کنید

مرحله ۱: تنظیمات را در رابط کاربری i-mobile انجام دهید

ثبت نام کنید یا وارد حساب کاربری i-mobile خود شوید .

با کلیک کردن روی تب (مدیریت سایت/برنامه) و دکمه پلت فرم برنامه خود، برنامه خود را به داشبورد i-mobile اضافه کنید.

فرم را پر کنید و روی دکمه新規登録 (ثبت نام) کلیک کنید.

برای ایجاد یک مکان تبلیغاتی جدید، برنامه خود را در زیر تبサイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.

به تب広告スポット管理 (مدیریت مکان تبلیغات) بروید و روی دکمه新規広告スポット (نقطه تبلیغاتی جدید) کلیک کنید.

سپس، فرم را با ارائه広告スポットサイズ (اندازه آگهی) و سایر جزئیات، پر کنید. سپس، روی دکمه新規登録 (ثبت نام) کلیک کنید.

محل آگهی جدید شما آماده است. برای مشاهده جزئیات ادغام آن، روی دکمهアプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.

به شناسهパブリッシャーشناسه (شناسه ناشر) ، شناسه (شناسه رسانه) و شناسه (شناسه نقطه ای) توجه داشته باشید. بعداً هنگام پیکربندی i-mobile برای میانجیگری در رابط کاربری Ad Manager به این پارامترها نیاز خواهید داشت.

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .

برای پیاده‌سازی app-ads.txt برای i-mobile، به بخش سوالات متداول مراجعه کنید.

مرحله ۲: تنظیم تقاضای i-mobile در رابط کاربری Ad Manager

تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید

وارد حساب مدیر تبلیغات خود شوید.

به بخش تحویل > گروه‌های بازده بروید و روی دکمه‌ی گروه بازده جدید کلیک کنید.

یک نام منحصر به فرد برای گروه yield خود وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب تبلیغ خود را انتخاب کنید و نوع موجودی را روی برنامه موبایل تنظیم کنید. در قسمت Targeting > Inventory ، واحد تبلیغاتی را که می‌خواهید به آن واسطه‌گری اضافه کنید، در قسمت Inventory and Mobile application انتخاب کنید.

سپس، روی دکمه‌ی «افزودن شریک Yield» کلیک کنید.

اگر از قبل یک شریک Yield برای i-mobile دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، گزینه Create a new yield partner را انتخاب کنید.

i-mobile را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و گزینه میانجیگری را فعال کنید.

جمع‌آوری خودکار داده‌ها را فعال کنید و نام کاربری و رمز عبور API را وارد کنید.

پس از انتخاب شریک Yield ، در قسمت نوع ادغام ، گزینه Mobile SDK Mediation ، در قسمت پلتفرم ، گزینه iOS و در قسمت وضعیت، گزینه Active را انتخاب کنید. شناسه ناشر (Publisher ID) ، شناسه رسانه (Media ID) و شناسه نقطه (Spot ID) که در بخش قبل به دست آورده‌اید را وارد کنید. سپس، یک مقدار پیش‌فرض برای هر نمایش (CPM) وارد کنید.

پس از اتمام کار، روی ذخیره در پایین صفحه کلیک کنید.

مرحله 3: SDK و آداپتور i-mobile را وارد کنید

استفاده از CocoaPods (توصیه می‌شود)

خط زیر را به Podfile پروژه خود اضافه کنید:

pod 'GoogleMobileAdsMediationIMobile'

از خط فرمان اجرا کنید:

pod install --repo-update

ادغام دستی

• آخرین نسخه i-mobile SDK را دانلود کنید و ImobileSdkAds.framework را در پروژه خود لینک کنید.
• آخرین نسخه آداپتور i-mobile را از لینک دانلود در Changelog دانلود کنید و IMobileAdapter.framework در پروژه خود لینک دهید.

مرحله ۴: اضافه کردن کد مورد نیاز

ادغام شبکه SKAd

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات i-mobile را دنبال کنید.

مرحله ۵: پیاده‌سازی خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید . i-mobile برای آزمایش، Test Spot ID ، Media ID و Publisher ID را ارائه می‌دهد که می‌توانید آنها را اینجا پیدا کنید.

تأیید تبلیغات آزمایشی

برای تأیید اینکه تبلیغات آزمایشی را از i-mobile دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی i-mobile (Waterfall ) فعال کنید.

مراحل اختیاری

استفاده از تبلیغات بومی

رندرینگ آگهی

آداپتور i-mobile فیلدهای زیر را برای GADNativeAd پر می‌کند.

^۱- برای تبلیغات بومی، کیت توسعه نرم‌افزار i-mobile آیکون برنامه را ارائه نمی‌دهد. در عوض، آداپتور i-mobile آیکون برنامه را با یک تصویر شفاف پر می‌کند.

کدهای خطا

اگر آداپتور نتواند تبلیغی از i-mobile دریافت کند، ناشران می‌توانند خطای اساسی را از پاسخ تبلیغ با استفاده از GADResponseInfo.adNetworkInfoArray تحت کلاس‌های زیر بررسی کنند:

در اینجا کدها و پیام‌های همراه آداپتور i-mobile که هنگام بارگیری ناموفق یک تبلیغ نمایش داده می‌شوند، آمده است:

تغییرات آداپتور میانجیگری iOS برای i-mobile

نسخه بعدی

• ‎-fobjc-arc و -fstack-protector-all را فعال کنید.

نسخه ۲.۳.۴.۲

• اکنون به نسخه ۱۲.۰.۰ یا بالاتر SDK تبلیغات موبایل گوگل نیاز دارد.

ساخته و آزمایش شده با:

• نسخه ۱۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۳.۴.

نسخه ۲.۳.۴.۱

• CFBundleShortVersionString به‌روزرسانی شد تا به جای چهار جزء، سه جزء داشته باشد.

ساخته و آزمایش شده با:

• نسخه ۱۱.۱۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۳.۴.

نسخه ۲.۳.۴.۰

• سازگاری تأیید شده با i-mobile SDK 2.3.4.
• پشتیبانی برای بازگرداندن نسخه SDK آی-موبایل در adSDKVersion اضافه شد.

ساخته و آزمایش شده با:

• نسخه ۱۱.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۳.۴.

نسخه ۲.۳.۳.۰

• سازگاری تأیید شده با i-mobile SDK 2.3.3.

ساخته و آزمایش شده با:

• نسخه ۱۱.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۳.۳.

نسخه ۲.۳.۲.۱

• متد نماینده‌ی منسوخ‌شده‌ی willBackgroundApplication از پیاده‌سازی‌های بنر، تبلیغات بینابینی و تبلیغات بومی حذف شد.
• اکنون به حداقل نسخه iOS 12.0 نیاز دارد.
• اکنون به نسخه ۱۱.۰ یا بالاتر SDK تبلیغات موبایل گوگل نیاز دارد.
• Info.plist در چارچوب‌های درون IMobileAdapter.xcframework گنجانده شده است.

ساخته و آزمایش شده با:

• نسخه ۱۱.۰.۱ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۳.۲.

نسخه ۲.۳.۲.۰

• سازگاری تأیید شده با i-mobile SDK 2.3.2.
• پشتیبانی از معماری armv7 حذف شد.
• اکنون به حداقل نسخه iOS 11.0 نیاز دارد.
• اکنون به نسخه ۱۰.۴.۰ یا بالاتر SDK تبلیغات موبایلی گوگل نیاز دارد.

ساخته و آزمایش شده با:

• نسخه ۱۰.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۳.۲.

نسخه ۲.۳.۱.۰

• سازگاری تأیید شده با i-mobile SDK 2.3.1.

ساخته و آزمایش شده با:

• نسخه ۱۰.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۳.۱.

نسخه ۲.۳.۰.۱

• اکنون به نسخه ۱۰.۰.۰ یا بالاتر SDK تبلیغات موبایل گوگل نیاز دارد.

ساخته و آزمایش شده با:

• نسخه ۱۰.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۳.۰.

نسخه ۲.۳.۰.۰

• سازگاری تأیید شده با i-mobile SDK 2.3.0.
• اکنون به نسخه ۹.۸.۰ یا بالاتر SDK تبلیغات موبایل گوگل نیاز دارد.

ساخته و آزمایش شده با:

• نسخه ۹.۱۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۳.۰.

نسخه ۲.۲.۰.۱

• اکنون به نسخه ۹.۰.۰ یا بالاتر SDK تبلیغات موبایل گوگل نیاز است.

ساخته و آزمایش شده با:

• نسخه ۹.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۲.۰.

نسخه ۲.۲.۰.۰

• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۲.۰.

ساخته و آزمایش شده با

• نسخه ۸.۱۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۲.۰.

نسخه ۲.۱.۰.۱

• وابستگی کمتر به SDK تبلیغات موبایلی گوگل نسخه ۸.۰.۰ یا بالاتر.

ساخته و آزمایش شده با

• نسخه ۸.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۱.۰.

نسخه ۲.۱.۰.۰

• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۱.۰.
• اکنون به نسخه ۸.۱.۰ یا بالاتر SDK تبلیغات موبایلی گوگل نیاز دارد.
• آداپتور برای استفاده از فرمت .xcframework به‌روزرسانی شد.

ساخته و آزمایش شده با

• نسخه ۸.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• آی-موبایل SDK نسخه ۲.۱.۰.

نسخه ۲.۰.۳۳.۱

• کدهای خطای استاندارد آداپتور و پیام‌ها اضافه شد.
• آداپتور اکنون درخواست چندین تبلیغ بینابینی را با استفاده از همان شناسه نقطه i-mobile محدود می‌کند.
• آداپتور اکنون وقتی روی تبلیغات بومی ضربه زده می‌شود، فراخوانی -nativeAdWillLeaveApplication: را ارسال می‌کند.
• اکنون به نسخه ۷.۶۸.۰ یا بالاتر SDK تبلیغات موبایلی گوگل نیاز دارد.

ساخته و آزمایش شده با

• نسخه ۷.۶۸.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۲.۰.۳۳ کیت توسعه نرم‌افزار آی-موبایل.

نسخه ۲.۰.۳۳.۰

• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۰.۳۳.
• اکنون به نسخه ۷.۶۵.۰ یا بالاتر SDK تبلیغات موبایلی گوگل نیاز دارد.
• اکنون به حداقل نسخه iOS 9.0 نیاز دارد.

ساخته و آزمایش شده با

• نسخه ۷.۶۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۲.۰.۳۳ کیت توسعه نرم‌افزار آی-موبایل.

نسخه ۲.۰.۳۲.۰

• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۰.۳۲.
• اکنون به نسخه ۷.۶۰.۰ یا بالاتر SDK تبلیغات موبایل گوگل نیاز دارد.
• پشتیبانی از مقیاس‌بندی تبلیغات ۳۲۰x۵۰ و ۳۲۰x۱۰۰ اضافه شد تا با اندازه‌های درخواست بنر تطبیقی ​​بهتر مطابقت داشته باشد.
• پشتیبانی از معماری i386 حذف شد.

ساخته و آزمایش شده با

• نسخه ۷.۶۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۲.۰.۳۲ کیت توسعه نرم‌افزار آی-موبایل.

نسخه ۲.۰.۳۱.۰

• سازگاری تأیید شده با i-mobile SDK نسخه ۲.۰.۳۱.

ساخته و آزمایش شده با

• نسخه ۷.۵۳.۱ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۲.۰.۳۱ کیت توسعه نرم‌افزار آی-موبایل.

نسخه ۲.۰.۲۹.۰

• انتشار اولیه!
• پشتیبانی از تبلیغات بنری، بینابینی و بومی اضافه شد.

ساخته و آزمایش شده با

• نسخه ۷.۵۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۲.۰.۲۹ کیت توسعه نرم‌افزار آی-موبایل.