این راهنما به شما نشان می دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از i-mobile با استفاده از میانجیگری AdMob ،پوشش ادغام آبشار نحوه افزودن i-mobile به پیکربندی میانجی واحد تبلیغاتی و نحوه ادغام i-mobile SDK و آداپتور در یک Android برنامه
رابط داشبورد i-mobile از متن ژاپنی برای برچسب‌ها، دکمه‌ها و توضیحات خود استفاده می‌کند. اسکرین شات های این راهنما ترجمه نشده اند. با این حال، در توضیحات و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی خود در پرانتز ترجمه شده‌اند.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای i-mobile دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | |
| فرمت ها | |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
| بومی | |
الزامات
- Android API سطح 21 یا بالاتر
جدیدترین SDK تبلیغات موبایل گوگل
راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در i-mobile UI تنظیم کنید
ثبت نام کنید یا به حساب آی موبایل خود وارد شوید .
با کلیک کردن روی تب (مدیریت سایت/برنامه) و دکمه پلت فرم برنامه خود، برنامه خود را به داشبورد i-mobile اضافه کنید.
فرم را پر کنید و روی دکمه新規登録 (ثبت نام) کلیک کنید.
برای ایجاد یک مکان تبلیغاتی جدید، برنامه خود را در زیر تبサイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.
به تب広告スポット管理 (مدیریت مکان تبلیغات) بروید و روی دکمه新規広告スポット (نقطه تبلیغاتی جدید) کلیک کنید.
سپس، فرم را با ارائه広告スポットサイズ (اندازه آگهی) و سایر جزئیات، پر کنید. سپس، روی دکمه新規登録 (ثبت نام) کلیک کنید.
محل آگهی جدید شما آماده است. برای مشاهده جزئیات ادغام آن، روی دکمهアプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.
به شناسه パブリッシャーشناسه (شناسه ناشر) ، شناسه (شناسه رسانه) و شناسه (شناسه نقطه ای) توجه داشته باشید. بعداً هنگام پیکربندی i-mobile برای میانجیگری در رابط کاربری AdMob به این پارامترها نیاز خواهید داشت.
مرحله 2: تقاضای i-mobile را در آن تنظیم کنید AdMob UI
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
باید i-mobile را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.
ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر گروه میانجی موجودی دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید و به افزودن i-mobile به عنوان منبع آگهی بروید.
برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.
قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی Continue کلیک کنید.
به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.
این گروه میانجی را با یک یا چند واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید.
اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کرده‌اید مشاهده کنید:
i-mobile را به عنوان منبع تبلیغ اضافه کنید
در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید. سپس i-mobile را انتخاب کنید.
i-mobile را انتخاب کرده و کلید Optimize را فعال کنید. برای تنظیم بهینه‌سازی منبع آگهی برای i-mobile، نام ورود و گذرواژه API را که در بخش قبل به دست آورده‌اید، وارد کنید. سپس یک مقدار eCPM برای i-mobile وارد کنید و روی Continue کلیک کنید.
اگر قبلاً نقشه ای برای i-mobile دارید، می توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.
در مرحله بعد، شناسه ناشر ، شناسه رسانه و شناسه Spot را که در بخش قبل به دست آمده است وارد کنید. سپس روی Done کلیک کنید.
مرحله 3: SDK و آداپتور i-mobile را وارد کنید
ادغام Android Studio (توصیه می شود)
در فایل settings.gradle.kts سطح پروژه خود، مخازن زیر را اضافه کنید:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
سپس، در فایل build.gradle.kts در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه‌های i-mobile SDK و آداپتور استفاده کنید:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
ادغام دستی
آخرین نسخه i-mobile SDK را دانلود کنید و
android-ad-sdk.aarرا در زیر پوشهsdkاستخراج کرده و به پروژه خود اضافه کنید.به مصنوعات آداپتور i-mobile در مخزن Maven Google بروید. آخرین نسخه را انتخاب کنید، فایل
.aarآداپتور i-mobile را دانلود کرده و آن را به پروژه خود اضافه کنید.
مرحله 4: کد مورد نیاز را اضافه کنید
هیچ کد اضافی برای ادغام i-mobile مورد نیاز نیست.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید. i-mobile برای تست Spot ID ، Media ID و Publisher ID ارائه می‌کند، می‌توانید آنها را در اینجا پیدا کنید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهی‌های آزمایشی را از i-mobile دریافت می‌کنید، با استفاده از منبع(های) آگهی i-mobile (Waterfall) آزمایش منبع آگهی را در ad inspector فعال کنید.
مراحل اختیاری
استفاده از تبلیغات بومی
رندر آگهی
آداپتور i-mobile موارد زیر را پر می کندتوضیحات فیلد پیشرفته تبلیغات بومیبرای یکNativeAd .
| میدان | دارایی ها همیشه توسط آداپتور i-mobile گنجانده شده است |
|---|---|
| تیتر | |
| تصویر | |
| بدن | |
| نماد برنامه | 1 |
| فراخوان به اقدام | |
| امتیاز ستاره | |
| فروشگاه | |
| قیمت |
1 برای تبلیغات بومی، i-mobile SDK دارایی نماد برنامه را ارائه نمی دهد. در عوض، آداپتور 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 SDK یک خطا را نشان داد. برای جزئیات بیشتر به کد مراجعه کنید. |
| 101 | i-mobile برای بارگیری تبلیغات به یک زمینه Activity نیاز دارد. |
| 102 | پارامترهای سرور i-mobile پیکربندی شده در AdMob رابط کاربری موجود نیست/نامعتبر است. |
| 103 | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از i-mobile مطابقت ندارد. |
| 104 | پاسخ به تماس موفقیت آمیز بارگیری آگهی بومی i-mobile یک لیست تبلیغات بومی خالی را برگرداند. |
I-mobile Android Mediation Adapter Changelog
نسخه 2.3.2.0
- سازگاری تایید شده با i-mobile SDK v2.3.2.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 23.1.0.
- IMobile SDK نسخه 2.3.2.
نسخه 2.3.1.2
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 23.0.0 به روز شد.
- سازگاری تایید شده با i-mobile SDK v2.3.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 23.0.0.
- IMobile SDK نسخه 2.3.1.
نسخه 2.3.1.1
- آداپتور به‌روزرسانی شده برای استفاده از کلاس جدید
VersionInfo. - حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.0.0 به روز شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 22.0.0.
- IMobile SDK نسخه 2.3.1.
نسخه 2.3.1.0
- سازگاری تایید شده با i-mobile SDK v2.3.1.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 21.5.0 به روز شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 21.5.0.
- IMobile SDK نسخه 2.3.1.
نسخه 2.3.0.0
- سازگاری تایید شده با i-mobile SDK v2.3.0.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 21.3.0 به روز شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 21.3.0.
- IMobile SDK نسخه 2.3.0.
نسخه 2.0.23.1
-
compileSdkVersionوtargetSdkVersionرا به API 31 به روز کرد. - حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.0.0 به روز کرد.
- حداقل سطح API Android مورد نیاز را به 19 به روز کرد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 21.0.0.
- IMobile SDK نسخه 2.0.23.
نسخه 2.0.23.0
- سازگاری تایید شده با i-mobile SDK v2.0.23.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 20.5.0 به روز شد.
ساخته و تست شده با
- Google Mobile Ads SDK نسخه 20.5.0.
- IMobile SDK نسخه 2.0.23.
نسخه 2.0.22.2
- کدها و پیام های خطای استاندارد آداپتور اضافه شده است.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 20.1.0 به روز شد.
ساخته و تست شده با
- Google Mobile Ads SDK نسخه 20.1.0.
- IMobile SDK نسخه 2.0.22.
نسخه 2.0.22.1
- حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.0.0 به روز کرد.
ساخته و تست شده با
- Google Mobile Ads SDK نسخه 20.0.0.
- IMobile SDK نسخه 2.0.22.
نسخه 2.0.22.0
- سازگاری تایید شده با i-mobile SDK v2.0.22.
- آداپتور را برای پشتیبانی از درخواست های بنر تطبیقی درون خطی به روز کرد.
ساخته و تست شده با
- Google Mobile Ads SDK نسخه 19.1.0.
- IMobile SDK نسخه 2.0.22.
نسخه 2.0.21.0
- سازگاری تایید شده با i-mobile SDK v2.0.21.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.1.0 به روز شد.
- پشتیبانی از مقیاس بندی تبلیغات بنری تطبیقی اضافه شده است.
ساخته و تست شده با
- Google Mobile Ads SDK نسخه 19.1.0.
- IMobile SDK نسخه 2.0.21.
نسخه 2.0.20.2
- پشتیبانی از اندازه های تبلیغاتی بنر انعطاف پذیر اضافه شده است.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.3.0 به روز شد.
ساخته و تست شده با
- Google Mobile Ads SDK نسخه 18.3.0.
- IMobile SDK نسخه 2.0.20.
نسخه 2.0.20.1
- آداپتور اکنون نسبت ابعادی
mediaContentغیر صفر را برمی‌گرداند.
ساخته و تست شده با
- Google Mobile Ads SDK نسخه 18.2.0.
- IMobile SDK نسخه 2.0.20.
نسخه 2.0.20.0
- انتشار اولیه!
- پشتیبانی از تبلیغات بنر، بینابینی و بومی اضافه شده است.