این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بار کردن و نمایش دادن آگهی‌های i-mobile بااستفاده از میانجی‌گری AdMob استفاده کنید، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن i-mobile به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کیت توسعه نرم‌افزار و آداپتور i-mobile در برنامه iOS را پوشش می‌دهد.
رابط داشبورد i-mobile از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و توضیحات استفاده می‌کند. نماگرفت‌های این راهنما ترجمه نشده‌اند. اما در توضیحات و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل انگلیسی‌شان در پرانتز ترجمه شده‌اند.
یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده
آداپتور میانجی i-mobile قابلیت‌های زیر را دارد:
| یکپارچه‌سازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالب‌ها | |
| برنما | |
| بینابینی | |
| پاداش | |
| بومی | |
پیش‌نیازها
پیش‌از ادامه دادن، موارد زیر را تأیید کنید:
- هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.
جدیدترین نسخه Google Mobile Ads SDK.
مرحله ۱: راه‌اندازی پیکربندی‌ها در میانای کاربری i-mobile
ثبت‌نام کنید یا به حساب i-mobile خود وارد شوید.
با کلیک کردن روی برگه サイト／アプリ管理 (مدیریت سایت/برنامه) و دکمه پلاتفرم برنامه‌تان، برنامه خود را به داشبورد i-mobile اضافه کنید.
فرم را تکمیل کنید و روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.
برای ایجاد «جایگاه آگهی» جدید، برنامه‌تان را در برگه サイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.
به برگه 広告スポット管理 (Ad Spot Management) بروید و روی دکمه 新規広告スポット (New Ad Spot) کلیک کنید.
سپس، فرم را با ارائه 広告スポット名 (نام جایگاه آگهی)، 広告スポットサイズ (اندازه جایگاه آگهی) و جزئیات دیگر تکمیل کنید. سپس روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.
جایگاه آگهی جدیدتان آماده است. برای مشاهده جزئیات یکپارچه‌سازی آن، روی دکمه アプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.
パブリッシャーID (Publisher ID)، メディアID (Media ID)، و スポットID (Spot ID) را یادداشت کنید. هنگام پیکربندی i-mobile برای میانجی‌گری در میانای کاربر AdMob، به این پارامترها نیاز خواهید داشت.
فایل app-ads.txt خود را به‌روز کنید
فروشندگان مجاز برای برنامه‌ها (app-ads.txt) ابتکاری از IAB Tech Lab است که کمک می‌کند مطمئن شوید
فضای آگهی برنامه‌تان فقط ازطریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از
افت قابل‌توجه در درآمد آگهی، باید فایل app-ads.txt را پیاده‌سازی کنید.
اگر قبلاً این کار را نکرده‌اید،
فایل app-ads.txt را برای برنامه‌تان راه‌اندازی کنید.
برای پیاده‌سازی app-ads.txt برای i-mobile،
پرسشگان آن‌ها را ببینید.
مرحله ۲: راه‌اندازی تقاضای i-mobile در میانای کاربری AdMob
پیکربندی تنظیمات میانجی‌گری برای واحد آگهی شما
باید i-mobile را به پیکربندی میانجی‌گری برای واحد آگهی‌تان اضافه کنید.
ابتدا، به سیستم حساب AdMob خود وارد شوید. سپس به برگه میانجی‌گری بروید. اگر گروه میانجی‌گری موجودی دارید که می‌خواهید آن را اصلاح کنید، روی نام آن گروه میانجی‌گری کلیک کنید تا آن را ویرایش کنید و به افزودن i-mobile به‌عنوان منبع آگهی بروید.
برای ایجاد گروه میانجی‌گری جدید، ایجاد گروه میانجی‌گری را انتخاب کنید.
قالب آگهی و پلاتفرم را وارد کنید، سپس روی ادامه کلیک کنید.
نامی برای گروه میانجی‌گری‌تان انتخاب کنید و مکان‌های هدف را انتخاب کنید. سپس، وضعیت گروه میانجی‌گری را روی فعال تنظیم کنید و سپس روی افزودن واحدهای آگهی کلیک کنید.
این گروه میانجی را با یک یا چند واحد آگهی AdMob موجودتان مرتبط کنید. سپس روی تمام کلیک کنید.
اکنون باید کارت واحدهای آگهی را ببینید که با واحدهای آگهی انتخابی شما پر شده است:
افزودن i-mobile به‌عنوان منبع آگهی
در زیر کارت آبشاری در بخش منابع آگهی، افزودن منبع آگهی را انتخاب کنید.
i-mobile را انتخاب کنید و کلید بهینه‌سازی را فعال کنید. نام ورود به سیستم و گذرواژه API را که در بخش قبلی دریافت کردید وارد کنید تا بهینه‌سازی منبع آگهی را برای i-mobile راه‌اندازی کنید. سپس مقدار eCPM را برای i-mobile وارد کنید و روی ادامه کلیک کنید.
اگر ازقبل نگاشتی برای i-mobile دارید، می‌توانید آن را انتخاب کنید. درغیراین‌صورت، روی افزودن نگاشت کلیک کنید.
سپس، شناسه ناشر، شناسه رسانه و شناسه نقطه به‌دست‌آمده در بخش قبلی را وارد کنید. سپس روی تمام کلیک کنید.
مرحله ۳: وارد کردن i-mobile SDK و آداپتور
استفاده از Swift Package Manager
پیش‌از ادامه دادن، باید حداقل نسخه پشتیبانی‌شده آداپتور ۲.۳.۴.۲ را داشته باشید.
برای افزودن وابستگی بسته به پروژه‌تان، این مراحل را دنبال کنید:
در Xcode، به File > Add Package Dependencies... بروید.
در پیام‌واره‌ای که ظاهر می‌شود، نشانی وب بسته زیر را جستجو کنید:
https://github.com/googleads/googleads-mobile-ios-mediation-imobile.gitدر قانون وابستگی، شاخه را انتخاب کنید.
در فیلد نوشتاری،
mainرا وارد کنید.
استفاده از CocoaPods
خط زیر را به Podfile پروژه‌تان اضافه کنید:
pod 'GoogleMobileAdsMediationIMobile'از خط فرمان، این دستور را اجرا کنید:
pod install --repo-update
ادغام دستی
- جدیدترین نسخه i-mobile
SDK را بارگیری کنید و
ImobileSdkAds.frameworkرا در پروژه‌تان پیوند دهید. - جدیدترین نسخه آداپتور i-mobile را از پیوند بارگیری در
گزارش تغییرات بارگیری کنید و
پیوند
IMobileAdapter.frameworkرا در پروژه‌تان قرار دهید.
مرحله ۴: افزودن کد لازم
پیاده‌سازی SKAdNetwork
اسناد i-mobile را دنبال کنید
تا شناسه‌های SKAdNetwork را به فایل Info.plist پروژه‌تان اضافه کنید.
مرحله ۵: آزمایش کردن پیاده‌سازی
فعال کردن آگهی‌های آزمایشی
مطمئن شوید دستگاه آزمایشی‌تان را برای AdMob ثبت کرده‌اید. i-mobile شناسه Spot، شناسه رسانه، و شناسه ناشر آزمایشی را برای آزمایش ارائه می‌دهد، می‌توانید آن‌ها را اینجا پیدا کنید.
درستی‌سنجی آگهی‌های آزمایشی
برای تأیید اینکه آگهی‌های آزمایشی را از i-mobile دریافت می‌کنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع (های) آگهی i-mobile(آبشاری) فعال کنید.
مراحل اختیاری
استفاده از آگهی‌های بومی
پرداز آگهی
آداپتور i-mobile موارد زیر را پر می‌کند
شرح فیلد پیشرفته آگهی‌های بومی
برای
GADNativeAd.
| فیلد | دارایی‌هایی که همیشه توسط آداپتور i-mobile اضافه می‌شوند |
|---|---|
| Headline | |
| تصویر | |
| بدن | |
| نماد برنامه | ۱ |
| دعوت به اقدام | |
| رده‌بندی با ستاره | |
| فروشگاه | |
| قیمت |
۱ برای آگهی‌های بومی، کیت توسعه نرم‌افزار i-mobile دارایی نماد برنامه ارائه نمی‌دهد. درعوض، آداپتور i-mobile نماد برنامه را با تصویری شفاف پر می‌کند.
کدهای خطا
اگر آداپتور نتواند آگهی را از i-mobile دریافت کند،
ناشران می‌توانند خطای اساسی را از پاسخ آگهی بااستفاده از
GADResponseInfo.adNetworkInfoArray
تحت کلاس‌های زیر بررسی کنند:
| قالب | نام کلاس |
|---|---|
| برنما | IMobileAdapter |
| بینابینی | IMobileAdapter |
| بومی | GADMediationAdapterIMobile |
در اینجا کدها و پیام‌های همراهی که توسط آداپتور i-mobile هنگام عدم بارگیری آگهی ارسال می‌شوند، آورده شده است:
| کد خطا | استدلال |
|---|---|
| 0-10 | کیت توسعه نرم‌افزار i-mobile خطایی برگرداند. برای جزئیات بیشتر، کد را ببینید. |
| ۱۰۱ | پارامترهای سرور i-mobile پیکربندی‌شده در AdMob UI وجود ندارد/نامعتبر است. |
| 102 | اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده i-mobile مطابقت ندارد. |
| 103 | i-mobile نتوانست آگهی ارائه دهد. |
| 104 | i-mobile آرایه آگهی بومی خالی برگرداند. |
| ۱۰۵ | i-mobile نتوانست دارایی‌های آگهی بومی را بارگیری کند. |
| 106 | i-mobile از درخواست برای چند آگهی بینابینی بااستفاده از یک «شناسه جایگاه» پشتیبانی نمی‌کند. |
| 107 | درخواست‌های دارای محدودیت سنی را برای i-mobile SDK فیلتر کنید زیرا نمی‌تواند سیگنال‌های دارای محدودیت سنی را دریافت کند. |
گزارش تغییرات آداپتور میانجی i-mobile iOS
نسخه ۲.۳.۴.۸
- حداقل نسخه iOS به‌روز شد تا وابستگی به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» کاهش یابد و نسخه‌های جزئی مجاز شوند.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۳.۷.۰.
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۷
- وقتی
ageRestrictedTreatmentجدید رویGADAgeRestrictedTreatmentChildتنظیم شده باشد، درخواست‌های دارای محدودیت سنی برای i-mobile SDK فیلتر می‌شود.
ساخته و آزمایش‌شده با:
- نسخه ۱۳.۴.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۶
- درخواست‌های دارای محدودیت سنی را برای i-mobile SDK فیلتر کنید زیرا نمی‌تواند سیگنال‌های دارای محدودیت سنی را دریافت کند.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۳.۲.۰.
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۵
- وابستگی کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google به نسخه ۱۳.۰.۰ به‌روز شد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۳.۰.۰.
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۴
- حداقل نسخه iOS برای CocoaPods به
13.0به‌روزرسانی شد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۳.۰.۰.
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۳
- نام‌های سرصفحه چتری و چارچوب در نقشه ماژول
IMobileAdapterاصلاح شد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۲.۱۲.۰.
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۲
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۱۲.۰.۰ یا بالاتر نیاز دارد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۲.۰.۰.
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۱
-
CFBundleShortVersionStringبه‌روز شد تا به‌جای چهار مؤلفه، سه مؤلفه داشته باشد.
ساخته و آزمایش‌شده با:
- نسخه ۱۱.۱۰.۰ کیت توسعه نرم‌افزار Google Mobile Ads.
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۰
- سازگاری با i-mobile SDK 2.3.4 تأیید شد.
- پشتیبانی برای برگرداندن نسخه کیت توسعه نرم‌افزار i-mobile در
adSDKVersionاضافه شد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۱.۲.۰.
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۳.۰
- سازگاری با i-mobile SDK 2.3.3 تأیید شد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۱.۱.۰.
- i-mobile SDK نسخه ۲.۳.۳.
نسخه ۲.۳.۲.۱
- روش نماینده
willBackgroundApplicationمنسوخ‌شده از پیاده‌سازی‌های آگهی بومی، بینابینی، و برنما برداشته شد. - اکنون به حداقل iOS نسخه ۱۲.۰ نیاز دارد.
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۱۱.۰ یا بالاتر نیاز دارد.
Info.plistرا در چارچوب‌هایIMobileAdapter.xcframeworkگنجاندیم.
ساخته و آزمایش‌شده با:
- نسخه ۱۱.۰.۱ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- i-mobile SDK نسخه ۲.۳.۲.
نسخه ۲.۳.۲.۰
- سازگاری با i-mobile SDK 2.3.2 تأیید شد.
- پشتیبانی از معماری
armv7برداشته شد. - اکنون به حداقل iOS نسخه ۱۱.۰ نیاز دارد.
- اکنون به «کیت توسعه نرم‌افزار تبلیغات Google Mobile» نسخه ۱۰.۴.۰ یا بالاتر نیاز دارد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۰.۴.۰.
- i-mobile SDK نسخه ۲.۳.۲.
نسخه ۲.۳.۱.۰
- سازگاری با i-mobile SDK 2.3.1 تأیید شد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۰.۳.۰.
- i-mobile SDK نسخه ۲.۳.۱.
نسخه ۲.۳.۰.۱
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۱۰.۰.۰ یا بالاتر نیاز دارد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۰.۰.۰.
- i-mobile SDK نسخه ۲.۳.۰.
نسخه ۲.۳.۰.۰
- سازگاری با i-mobile SDK نسخه ۲.۳.۰ تأیید شد.
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۹.۸.۰ یا بالاتر نیاز دارد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۹.۱۳.۰.
- i-mobile SDK نسخه ۲.۳.۰.
نسخه ۲.۲.۰.۱
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۹.۰.۰ یا بالاتر نیاز دارد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۹.۰.۰.
- i-mobile SDK نسخه ۲.۲.۰.
نسخه ۲.۲.۰.۰
- سازگاری با i-mobile SDK نسخه ۲.۲.۰ تأیید شد.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۸.۱۳.۰.
- i-mobile SDK نسخه ۲.۲.۰.
نسخه ۲.۱.۰.۱
- وابستگی به کیت توسعه نرم‌افزار Google Mobile Ads نسخه ۸.۰.۰ یا بالاتر کاهش یافته است.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۸.۴.۰.
- i-mobile SDK نسخه ۲.۱.۰.
نسخه ۲.۱.۰.۰
- سازگاری با i-mobile SDK نسخه ۲.۱.۰ تأیید شد.
- اکنون به «کیت توسعه نرم‌افزار تبلیغات Google Mobile» نسخه ۸.۱.۰ یا بالاتر نیاز دارد.
- آداپتور برای استفاده از قالب
.xcframeworkبه‌روز شد.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۸.۱.۰.
- i-mobile SDK نسخه ۲.۱.۰.
نسخه ۲.۰.۳۳.۱
- کدها و پیام‌های خطای استانداردشده آداپتور اضافه شد.
- اکنون آداپتور درخواست چند آگهی بینابینی را بااستفاده از یک «شناسه نقطه i-mobile» محدود می‌کند.
- اکنون وقتی روی آگهی‌های بومی تک‌ضرب زده می‌شود، آداپتور فراخوانی برگشتی
-nativeAdWillLeaveApplication:را بازارسال می‌کند. - اکنون به «کیت توسعه نرم‌افزار تبلیغات Google Mobile» نسخه ۷.۶۸.۰ یا بالاتر نیاز دارد.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار Google Mobile Ads نسخه ۷.۶۸.۰.
- i-mobile SDK نسخه ۲.۰.۳۳.
نسخه ۲.۰.۳۳.۰
- سازگاری با نسخه ۲.۰.۳۳ کیت توسعه نرم‌افزار i-mobile تأیید شد.
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۷.۶۵.۰ یا بالاتر نیاز دارد.
- اکنون به حداقل iOS نسخه ۹.۰ نیاز دارد.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۷.۶۵.۰.
- i-mobile SDK نسخه ۲.۰.۳۳.
نسخه ۲.۰.۳۲.۰
- سازگاری با i-mobile SDK نسخه ۲.۰.۳۲ تأیید شد.
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۷.۶۰.۰ یا بالاتر نیاز دارد.
- پشتیبانی از مقیاس‌بندی آگهی‌های ۳۲۰×۵۰ و ۳۲۰×۱۰۰ برای تطابق بهتر با اندازه‌های درخواست برنمای تطبیقی اضافه شد.
- پشتیبانی از معماری i386 برداشته شد.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۷.۶۰.۰.
- i-mobile SDK نسخه ۲.۰.۳۲.
نسخه ۲.۰.۳۱.۰
- سازگاری با i-mobile SDK نسخه ۲.۰.۳۱ تأیید شد.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۷.۵۳.۱.
- i-mobile SDK نسخه ۲.۰.۳۱.
نسخه ۲.۰.۲۹.۰
- انتشار اولیه!
- پشتیبانی از آگهی‌های برنما، بینابینی، و بومی اضافه شد.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۷.۵۲.۰.
- i-mobile SDK نسخه ۲.۰.۲۹.