این راهنما نحوه استفاده از Google Mobile Ads SDK (Legacy) را برای بار کردن و نمایش آگهی‌های i-mobile بااستفاده از واسطه‌گری، پوشش ادغام‌های آبشاری، نشان می‌دهد. این راهنما نحوه افزودن i-mobile به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کردن i-mobile SDK و آداپتور در برنامه Android را پوشش می‌دهد.
میانای داشبورد i-mobile از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و شرح‌های خود استفاده می‌کند. نماگرفت‌های این راهنما ترجمه نشده است. بااین‌حال، در شرح‌ها و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی آن‌ها در پرانتز ترجمه شده‌اند.
یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده
کارگزار میانجی‌گری برای i-mobile قابلیت‌های زیر را دارد:
| یکپارچه‌سازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالب‌ها | |
| برنما | |
| بینابینی | |
| پاداش | |
| بومی | |
پیش‌نیازها
قبل‌از ادامه دادن، موارد زیر را درستی‌سنجی کنید:
- سطح میانای برنامه کاربردی Android 24 یا بالاتر.
جدیدترین نسخه Google Mobile Ads SDK (Legacy).
مرحله ۱: پیکربندی‌ها را در i-mobile UI راه‌اندازی کنید
در حساب i-mobile خود ثبت‌نام کنید یا وارد سیستم شوید.
با کلیک کردن روی برگه サイト／アプリ管理 (مدیریت سایت/برنامه) و دکمه مربوط به پلاتفرم برنامه، برنامه‌تان را به داشبورد i-mobile اضافه کنید.
فرم را تکمیل کنید و روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.
برای ایجاد «جای آگهی» جدید، برنامه خود را در برگه サイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.
به برگه 広告スポット管理 (مدیریت جای آگهی) پیمایش کنید و روی دکمه 新規広告スポット (جای آگهی جدید) کلیک کنید.
سپس با ارائه 広告スポット名 (نام جای آگهی)، 広告スポットサイズ (اندازه جای آگهی)، و جزئیات دیگر، فرم را تکمیل کنید. سپس، روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.
جای آگهی جدید شما آماده است. برای مشاهده جزئیات یکپارچه‌سازی آن، روی دکمه アプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.
パブリッシャーID (شناسه ناشر)، メディアID (شناسه رسانه)، و スポットID (شناسه نقطه) را یادداشت کنید. بعداً هنگام پیکربندی i-mobile برای میانجی‌گری در «میانای کاربر Ad Manager» به این پارامترها نیاز خواهید داشت.
به‌روزرسانی app-ads.txt
«فروشندگان مجاز برای برنامه‌ها» 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 خود وارد شوید.
به ارائه > گروه‌های بازدهی پیمایش کنید و روی دکمه گروه بازدهی جدید کلیک کنید.
نام منحصربه‌فردی برای گروه درآمد خود وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب آگهی خود را انتخاب کنید، و نوع فضای آگهی را روی برنامه تلفن همراه تنظیم کنید. در بخش هدف‌یابی > فضای آگهی، واحد آگهی را در فضای آگهی و برنامه تلفن همراه که می‌خواهید میانجی‌گری را به آن اضافه کنید انتخاب کنید.
سپس، روی دکمه افزودن شریک بازدهی کلیک کنید.
اگر ازقبل شریک بازده برای i-mobile دارید، می‌توانید آن را انتخاب کنید. درغیراین‌صورت، ایجاد شریک بازده جدید را انتخاب کنید.
i-mobile را به‌عنوان شبکه تبلیغات انتخاب کنید، نام یکتایی وارد کنید، و واسطه‌گری را فعال کنید.
جمع‌آوری خودکار داده‌ها را روشن کنید و نام ورود به سیستم و گذرواژه API را وارد کنید
پس‌از انتخاب شریک بازدهی، واسطه‌گری کیت توسعه نرم‌افزار تلفن همراه را به‌عنوان نوع ادغام، Android را به‌عنوان پلاتفرم، و فعال را به‌عنوان وضعیت انتخاب کنید. شناسه ناشر، شناسه رسانه، و شناسه جای آگهی را که در بخش قبلی به‌دست آورده‌اید وارد کنید. سپس، مقدار هزارظهوربهای پیش‌فرض را وارد کنید.
پس‌از اتمام، در پایین صفحه روی ذخیره کلیک کنید.
مرحله ۳: وارد کردن i-mobile SDK و «آداپتور»
یکپارچه‌سازی «استودیو Android» (توصیه می‌شود)
در فایل settings.gradle.kts سطح پروژه، مخزن‌های زیر را اضافه کنید:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
در فایل gradle سطح برنامه، وابستگی‌های پیاده‌سازی زیر را اضافه کنید:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:25.5.0") implementation("com.google.ads.mediation:imobile:2.3.2.5") }
Groovy
dependencies { implementation 'com.google.android.gms:play-services-ads:25.5.0' implementation 'com.google.ads.mediation:imobile:2.3.2.5' }
یکپارچه‌سازی دستی
جدیدترین نسخه i-mobile SDK را بارگیری کنید و
android-ad-sdk.aarرا در پوشهsdkاستخراج کنید و به پروژه‌تان اضافه کنید.به آرتیفکت‌های آداپتور i-mobile در «مخزن Maven» متعلق به Google پیمایش کنید. جدیدترین نسخه را انتخاب کنید، فایل
.aarآداپتور i-mobile را بارگیری کنید، و آن را به پروژه‌تان اضافه کنید.
مرحله ۴: افزودن کد الزامی
بار کردن آگهی با بافت فعالیت
هنگام بار کردن قالب‌های آگهی «برنمایی»، «بینابینی»، «پاداش‌دار»، و «بومی»، زمینه Activity را ارسال کنید.بدون زمینه فعالیت، بار کردن آگهی ناموفق خواهد بود.
مرحله ۵: پیاده‌سازی‌تان را آزمایش کنید
فعال کردن آگهی‌های آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید. i-mobile شناسه نقطه، شناسه رسانه، و شناسه ناشر را برای آزمایش ارائه می‌دهد، می‌توانید آن‌ها را اینجا پیدا کنید.
درستی‌سنجی آگهی‌های آزمایشی
برای تأیید اینکه از i-mobile آگهی‌های آزمایشی دریافت می‌کنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع (های) آگهی i-mobile(آبشاری) فعال کنید.
مراحل اختیاری
استفاده از آگهی‌های بومی
پرداز آگهی
آداپتور i-mobile
فیلدهای
زیر را برای
NativeAd پر می‌کند.
| فیلد | دارایی‌هایی که همیشه توسط آداپتور i-mobile اضافه می‌شود |
|---|---|
| Headline | |
| تصویر | |
| بدن | |
| نماد برنامه | ۱ |
| دعوت به اقدام | |
| رده‌بندی با ستاره | |
| فروشگاه | |
| قیمت |
۱ برای آگهی‌های بومی، «کیت توسعه نرم‌افزار i-mobile» دارایی نماد برنامه ارائه نمی‌دهد. درعوض، آداپتور i-mobile نماد برنامه را با تصویر شفافی پر می‌کند.
کدهای خطا
اگر این آداپتور نتواند آگهی را از i-mobile دریافت کند،
ناشران می‌توانند خطای زیربنایی را از پاسخ آگهی بااستفاده از
ResponseInfo.getAdapterResponses()
در کلاس‌های زیر بررسی کنند:
| قالب | نام کلاس |
|---|---|
| برنما | com.google.ads.mediation.imobile.IMobileAdapter |
| بینابینی | com.google.ads.mediation.imobile.IMobileAdapter |
| بومی | com.google.ads.mediation.imobile.IMobileMediationAdapter |
در اینجا کدها و پیام‌های همراهی که توسط آداپتور i-mobile وقتی آگهی بار نمی‌شود ارائه می‌شود آورده شده است:
| کد خطا | استدلال |
|---|---|
| 0-99 | «کیت توسعه نرم‌افزار i-mobile» خطایی برگرداند. برای جزئیات بیشتر، کد را ببینید. |
| ۱۰۱ | i-mobile برای بار کردن آگهی‌ها به بافت Activity نیاز دارد. |
| 102 | پارامترهای سرور i-mobile که در «واسط کاربر» Ad Manager پیکربندی شده‌اند وجود ندارند/نامعتبر هستند. |
| 103 | اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده i-mobile مطابقت ندارد. |
| 104 | کاربرگشتی موفقیت بار آگهی بومی i-mobile فهرست آگهی‌های بومی خالی را برگرداند. |
| ۱۰۵ | درخواست دارای پردازش محدودیت سنی بود، اما «کیت توسعه نرم‌افزار i-mobile» نمی‌تواند نشان‌های محدودیت سنی را دریافت کند |
تغییر گزارش میانجی‌گری i-mobile Android
نسخه ۲.۳.۲.۵
- وابستگی Kotlin آداپتور را به 1.9.0 (حداقل نسخه Kotlin پشتیبانی‌شده توسط کیت توسعه نرم‌افزار GMA NextGen) سنجاق کنید.
- عملکرد برگشتی در شاخه‌های خطای محدودیت سنی درطول مقداردهی اولیه آگهی و درخواست‌های بار آگهی اصلاح شد.
ساخته و آزمایش‌شده با:
- نسخه ۲۵.۴.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه ۱.۴.۰ «کیت توسعه نرم‌افزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه IMobile SDK 2.3.2.
نسخه ۲.۳.۲.۴
- وقتی
AgeRestrictedTreatmentجدید رویCHILDتنظیم می‌شود، درخواست‌های دارای محدودیت سنی را برای «کیت توسعه نرم‌افزار i-mobile» فیلتر کنید.
ساخته و آزمایش‌شده با:
- نسخه ۲۵.۴.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه ۱.۲.۰ «کیت توسعه نرم‌افزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه IMobile SDK 2.3.2.
نسخه ۲.۳.۲.۳
- درخواست‌های دارای محدودیت سنی را برای «کیت توسعه نرم‌افزار i-mobile» فیلتر کنید زیرا نمی‌تواند نشان‌های دارای محدودیت سنی را دریافت کند.
ساخته و آزمایش‌شده با:
- نسخه ۲۵.۱.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- نسخه ۱.۱.۰ «کیت توسعه نرم‌افزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه IMobile SDK 2.3.2.
نسخه ۲.۳.۲.۲
- دارایی برای ساختن آداپتور با وابستگی «کیت توسعه نرم‌افزار نسل بعدی GMA» اضافه شد.
- پیاده‌سازی‌های آگهی برافزا، بینابینی، و بومی از میانای برنامه‌سازی کاربردی قدیمی به میانای برنامه‌سازی کاربردی جدید انتقال یافت.
ساخته و آزمایش‌شده با:
- نسخه ۲۵.۱.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- نسخه IMobile SDK 2.3.2.
نسخه ۲.۳.۲.۱
- حداقل سطح میانای برنامه‌سازی کاربردی Android موردنیاز به ۲۳ به‌روزرسانی شد.
- حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۴.۰.۰ به‌روزرسانی شد.
ساخته و آزمایش‌شده با:
- نسخه ۲۴.۰.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه IMobile SDK 2.3.2.
نسخه ۲.۳.۲.۰
- سازگاری با i-mobile SDK نسخه ۲.۳.۲ تأیید شد.
ساخته و آزمایش‌شده با:
- نسخه ۲۳.۱.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه IMobile SDK 2.3.2.
نسخه ۲.۳.۱.۲
- حداقل نسخه کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google موردنیاز به ۲۳.۰.۰ به‌روزرسانی شد.
- سازگاری با i-mobile SDK نسخه ۲.۳.۱ تأیید شد.
ساخته و آزمایش‌شده با:
- نسخه ۲۳.۰.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه IMobile SDK 2.3.1.
نسخه ۲.۳.۱.۱
- برای استفاده از کلاس جدید
VersionInfo، آداپتور به‌روزرسانی شد. - حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۲.۰.۰ به‌روزرسانی شد.
ساخته و آزمایش‌شده با:
- نسخه ۲۲.۰.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه IMobile SDK 2.3.1.
نسخه ۲.۳.۱.۰
- سازگاری با i-mobile SDK نسخه ۲.۳.۱ تأیید شد.
- حداقل نسخه کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google موردنیاز به ۲۱.۵.۰ به‌روزرسانی شد.
ساخته و آزمایش‌شده با:
- نسخه ۲۱.۵.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه IMobile SDK 2.3.1.
نسخه ۲.۳.۰.۰
- سازگاری با i-mobile SDK نسخه ۲.۳.۰ تأیید شد.
- حداقل نسخه کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google موردنیاز به ۲۱.۳.۰ به‌روز شد.
ساخته و آزمایش‌شده با:
- نسخه ۲۱.۳.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه IMobile SDK 2.3.0.
نسخه 2.0.23.1
-
compileSdkVersionوtargetSdkVersionبه API 31 به‌روزرسانی شد. - حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۱.۰.۰ به‌روزرسانی شد.
- حداقل سطح میانای برنامه‌سازی کاربردی Android موردنیاز به ۱۹ به‌روز شد.
ساخته و آزمایش‌شده با:
- نسخه ۲۱.۰.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه IMobile SDK 2.0.23.
نسخه 2.0.23.0
- سازگاری با i-mobile SDK نسخه ۲.۰.۲۳ تأیید شد.
- حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۰.۵.۰ به‌روزرسانی شد.
ساخته و آزمایش‌شده با
- نسخه Google Mobile Ads SDK 20.5.0.
- نسخه IMobile SDK 2.0.23.
نسخه 2.0.22.2
- پیام‌ها و کدهای خطای آداپتور استانداردشده اضافه شد.
- حداقل نسخه کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google موردنیاز به نسخه ۲۰.۱.۰ به‌روزرسانی شد.
ساخته و آزمایش‌شده با
- نسخه 20.1.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- نسخه IMobile SDK 2.0.22.
نسخه 2.0.22.1
- حداقل نسخه کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google موردنیاز به نسخه ۲۰.۰.۰ به‌روزرسانی شد.
ساخته و آزمایش‌شده با
- نسخه 20.0.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- نسخه IMobile SDK 2.0.22.
نسخه 2.0.22.0
- سازگاری با i-mobile SDK نسخه ۲.۰.۲۲ تأیید شد.
- آداپتور برای پشتیبانی از درخواست‌های برنمای تطبیقی درون‌خط به‌روزرسانی شد.
ساخته و آزمایش‌شده با
- نسخه 19.1.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- نسخه IMobile SDK 2.0.22.
نسخه 2.0.21.0
- سازگاری با i-mobile SDK نسخه ۲.۰.۲۱ تأیید شد.
- حداقل نسخه کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google موردنیاز به 19.1.0 به‌روزرسانی شد.
- پشتیبانی از آگهی‌های برنمای تطبیقی مقیاس‌پذیر اضافه شد.
ساخته و آزمایش‌شده با
- نسخه 19.1.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
- نسخه IMobile SDK 2.0.21.
نسخه 2.0.20.2
- پشتیبانی از اندازه‌های آگهی برنمایی انعطاف‌پذیر اضافه شد.
- حداقل نسخه کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google موردنیاز به نسخه ۱۸.۳.۰ به‌روز شد.
ساخته و آزمایش‌شده با
- نسخه ۱۸.۳.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه IMobile SDK 2.0.20.
نسخه 2.0.20.1
- اکنون «آداپتور» نسبت ابعادی غیرصفر
mediaContentرا برمی‌گرداند.
ساخته و آزمایش‌شده با
- نسخه ۱۸.۲.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
- نسخه IMobile SDK 2.0.20.
نسخه 2.0.20.0
- انتشار اولیه!
- پشتیبانی از آگهی‌های برنمایی، بینابینی، و بومی اضافه شد.