این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بار کردن و نمایش دادن آگهی‌های i-mobile بااستفاده از میانجی‌گری، که شامل ادغام‌های آبشاری می‌شود، استفاده کنید. این راهنما نحوه افزودن i-mobile به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کردن کیت توسعه نرم‌افزار و آداپتور i-mobile در برنامه iOS را پوشش می‌دهد.
میانای داشبورد i-mobile از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و شرح‌های خود استفاده می‌کند. نماگرفت‌های این راهنما ترجمه نشده‌اند. اما در توضیحات و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل انگلیسی‌شان در پرانتز ترجمه شده‌اند.
یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده
آداپتور میانجی i-mobile قابلیت‌های زیر را دارد:
| یکپارچه‌سازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالب‌ها | |
| برنما | |
| بینابینی | |
| پاداش | |
| بومی | |
پیش‌نیازها
قبل‌از ادامه دادن، موارد زیر را تأیید کنید:
- هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.
جدیدترین نسخه Google Mobile Ads SDK.
مرحله ۱: راه‌اندازی پیکربندی‌ها در میانای کاربری i-mobile
ثبت‌نام کنید یا به حساب i-mobile خود وارد شوید.
با کلیک کردن روی برگه サイト／アプリ管理 (مدیریت سایت/برنامه) و دکمه مربوط به پلاتفرم برنامه، برنامه‌تان را به داشبورد i-mobile اضافه کنید.
فرم را تکمیل کنید و روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.
برای ایجاد «جای آگهی» جدید، برنامه خود را در برگه サイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.
به برگه 広告スポット管理 (مدیریت جای آگهی) پیمایش کنید و روی دکمه 新規広告スポット (جای آگهی جدید) کلیک کنید.
سپس، فرم را با ارائه 広告スポット名 (نام جایگاه آگهی)، 広告スポットサイズ (اندازه جایگاه آگهی) و جزئیات دیگر تکمیل کنید. سپس روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.
جای آگهی جدید شما آماده است. برای مشاهده جزئیات یکپارچه‌سازی آن، روی دکمه アプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.
パブリッシャーID (شناسه ناشر)، メディアID (شناسه رسانه)، و スポットID (شناسه نقطه) را یادداشت کنید. بعداً هنگام پیکربندی i-mobile برای میانجی‌گری در میانای کاربری Ad Manager به این پارامترها نیاز خواهید داشت.
فایل app-ads.txt خود را به‌روز کنید
Authorized Sellers for Apps app-ads.txt ابتکاری از IAB Tech Lab است که کمک می‌کند مطمئن شوید
فهرست آگهی‌های برنامه‌تان فقط ازطریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از
افت قابل‌توجه در درآمد آگهی، باید فایل app-ads.txt را پیاده‌سازی کنید.
اگر قبلاً این کار را انجام نداده‌اید،
فایل app-ads.txt برای Ad Manager ایجاد کنید.
برای پیاده‌سازی app-ads.txt برای i-mobile، به
پرسشگان آن‌ها مراجعه کنید.
مرحله ۲: راه‌اندازی تقاضای i-mobile در میانای کاربری Ad Manager
پیکربندی تنظیمات واسطه‌گری برای واحد آگهی
به سیستم حساب Ad Manager خود وارد شوید.
به ارائه > گروه‌های بازدهی پیمایش کنید و روی دکمه گروه بازدهی جدید کلیک کنید.
نام منحصربه‌فردی برای گروه درآمد خود وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب آگهی خود را انتخاب کنید، و نوع فضای آگهی را روی برنامه تلفن همراه تنظیم کنید. در بخش هدف‌یابی > فضای آگهی، واحد آگهی را در فضای آگهی و برنامه تلفن همراه که می‌خواهید میانجی‌گری را به آن اضافه کنید انتخاب کنید.
سپس، روی دکمه افزودن شریک بازده کلیک کنید.
اگر ازقبل شریک Yield برای i-mobile دارید، می‌توانید آن را انتخاب کنید. درغیراین‌صورت، ایجاد شریک بازده جدید را انتخاب کنید.
i-mobile را به‌عنوان شبکه تبلیغات انتخاب کنید، نام یکتایی وارد کنید، و واسطه‌گری را فعال کنید.
جمع‌آوری خودکار داده‌ها را روشن کنید و نام ورود به سیستم و گذرواژه API را وارد کنید
پس‌از انتخاب شریک بهینه‌سازی، میانجی‌گری کیت توسعه نرم‌افزار تلفن همراه را به‌عنوان نوع ادغام، iOS را به‌عنوان پلاتفرم، و فعال را به‌عنوان وضعیت انتخاب کنید. شناسه ناشر، شناسه رسانه، و شناسه جای آگهی را که در بخش قبلی به‌دست آورده‌اید وارد کنید. سپس، مقدار هزارظهوربهای پیش‌فرض را وارد کنید.
پس‌از اتمام، در پایین صفحه روی ذخیره کلیک کنید.
مرحله ۳: وارد کردن i-mobile SDK و آداپتور
استفاده از مدیر بسته Swift
قبل‌از ادامه دادن، باید حداقل نسخه پشتیبانی‌شده آداپتور 2.3.4.2 را داشته باشید.
برای افزودن وابستگی بسته به پروژه، این مراحل را دنبال کنید:
در 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
برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه، مستندات i-mobile را دنبال کنید.
مرحله ۵: آزمایش پیاده‌سازی
فعال کردن آگهی‌های آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید. 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 پیکربندی‌شده در Ad Manager 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» فیلتر کنید.
ساخته و آزمایش‌شده با:
- نسخه ۱۳.۴.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۶
- درخواست‌های دارای محدودیت سنی برای i-mobile SDK فیلتر شود زیرا نمی‌تواند سیگنال‌های دارای محدودیت سنی را دریافت کند.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۳.۲.۰.
- نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.
نسخه ۲.۳.۴.۵
- وابستگی کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google به نسخه ۱۳.۰.۰ به‌روز شد.
ساخته و آزمایش‌شده با:
- نسخه 13.0.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.
نسخه ۲.۳.۴.۴
- حداقل نسخه iOS برای CocoaPods به
13.0به‌روزرسانی شد.
ساخته و آزمایش‌شده با:
- نسخه 13.0.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۳
- نام‌های چارچوب و سرصفحه چتری در نقشه ماژول
IMobileAdapterاصلاح شد.
ساخته و آزمایش‌شده با:
- نسخه ۱۲.۱۲.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۲
- اکنون به «کیت توسعه نرم‌افزار تبلیغات Google ویژه تلفن همراه» نسخه ۱۲.۰.۰ یا بالاتر نیاز دارد.
ساخته و آزمایش‌شده با:
- نسخه ۱۲.۰.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- i-mobile SDK نسخه ۲.۳.۴.
نسخه ۲.۳.۴.۱
-
CFBundleShortVersionStringبه‌روز شد تا به‌جای چهار مؤلفه، سه مؤلفه داشته باشد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۱.۱۰.۰.
- نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.
نسخه ۲.۳.۴.۰
- سازگاری با 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» نیاز دارد.
ساخته و آزمایش‌شده با:
- نسخه ۱۰.۴.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- i-mobile SDK نسخه ۲.۳.۲.
نسخه ۲.۳.۱.۰
- سازگاری با i-mobile SDK 2.3.1 تأیید شد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۰.۳.۰.
- i-mobile SDK نسخه ۲.۳.۱.
نسخه ۲.۳.۰.۱
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۱۰.۰.۰ یا بالاتر نیاز دارد.
ساخته و آزمایش‌شده با:
- نسخه 10.0.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- نسخه ۲.۳.۰ کیت توسعه نرم‌افزار i-mobile.
نسخه ۲.۳.۰.۰
- سازگاری با i-mobile SDK 2.3.0 تأیید شد.
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۹.۸.۰ یا بالاتر نیاز دارد.
ساخته و آزمایش‌شده با:
- نسخه ۹.۱۳.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- i-mobile SDK نسخه ۲.۳.۰.
نسخه ۲.۲.۰.۱
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۹.۰.۰ یا بالاتر نیاز دارد.
ساخته و آزمایش‌شده با:
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۹.۰.۰.
- نسخه ۲.۲.۰ کیت توسعه نرم‌افزار i-mobile.
نسخه ۲.۲.۰.۰
- سازگاری با نسخه ۲.۲.۰ کیت توسعه نرم‌افزار i-mobile تأیید شد.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۸.۱۳.۰.
- i-mobile SDK نسخه ۲.۲.۰.
نسخه ۲.۱.۰.۱
- وابستگی به کیت توسعه نرم‌افزار Google Mobile Ads نسخه ۸.۰.۰ یا بالاتر کاهش یافته است.
ساخته و آزمایش‌شده با
- نسخه ۸.۴.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- i-mobile SDK نسخه ۲.۱.۰.
نسخه ۲.۱.۰.۰
- سازگاری با نسخه ۲.۱.۰ کیت توسعه نرم‌افزار i-mobile تأیید شد.
- اکنون به «کیت توسعه نرم‌افزار تبلیغات Google Mobile» نسخه ۸.۱.۰ یا بالاتر نیاز دارد.
- آداپتور را برای استفاده از قالب
.xcframeworkبه‌روز کردیم.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۸.۱.۰.
- i-mobile SDK نسخه ۲.۱.۰.
نسخه ۲.۰.۳۳.۱
- کدها و پیام‌های خطای استانداردشده آداپتور اضافه شد.
- اکنون آداپتور درخواست چندین آگهی بینابینی را بااستفاده از یک «شناسه نقطه i-mobile» محدود می‌کند.
- اکنون وقتی روی آگهی‌های بومی تک‌ضرب زده می‌شود، آداپتور فراخوانی برگشتی
-nativeAdWillLeaveApplication:را بازارسال می‌کند. - اکنون به «کیت توسعه نرم‌افزار تبلیغات Google Mobile» نسخه ۷.۶۸.۰ یا بالاتر نیاز دارد.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار Google Mobile Ads نسخه ۷.۶۸.۰.
- i-mobile SDK نسخه ۲.۰.۳۳.
نسخه 2.0.33.0
- سازگاری با نسخه ۲.۰.۳۳ کیت توسعه نرم‌افزار i-mobile تأیید شد.
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۷.۶۵.۰ یا بالاتر نیاز دارد.
- اکنون حداقل به iOS نسخه ۹.۰ نیاز دارد.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۷.۶۵.۰.
- نسخه کیت توسعه نرم‌افزار i-mobile 2.0.33.
نسخه 2.0.32.0
- سازگاری با i-mobile SDK نسخه ۲.۰.۳۲ تأیید شد.
- اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۷.۶۰.۰ یا بالاتر نیاز دارد.
- پشتیبانی از مقیاس‌بندی آگهی‌های ۳۲۰×۵۰ و ۳۲۰×۱۰۰ برای تطابق بهتر با اندازه‌های درخواست برنمای تطبیقی اضافه شد.
- پشتیبانی از معماری i386 برداشته شد.
ساخته و آزمایش‌شده با
- نسخه ۷.۶۰.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- i-mobile SDK نسخه ۲.۰.۳۲.
نسخه ۲.۰.۳۱.۰
- سازگاری با i-mobile SDK نسخه ۲.۰.۳۱ تأیید شد.
ساخته و آزمایش‌شده با
- نسخه ۷.۵۳.۱ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه کیت توسعه نرم‌افزار i-mobile 2.0.31.
نسخه ۲.۰.۲۹.۰
- انتشار اولیه!
- پشتیبانی از آگهی‌های برنما، بینابینی، و بومی اضافه شد.
ساخته و آزمایش‌شده با
- کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۷.۵۲.۰.
- i-mobile SDK نسخه ۲.۰.۲۹.