این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از maio با استفاده از میانجیگری استفاده کنید که ادغامهای آبشار را پوشش میدهد. نحوه افزودن maio به پیکربندی میانجی واحد تبلیغات و نحوه ادغام maio SDK و آداپتور در یک برنامهAndroid را پوشش میدهد.
رابط داشبورد برای maio از متن ژاپنی برای برچسبها، دکمهها و توضیحات خود استفاده میکند و اسکرینشاتهای این راهنما ترجمه نشدهاند. اما در توضیحات و دستورالعمل های این راهنما، برچسب ها و دکمه ها با معادل های زبان انگلیسی خود ارجاع داده شده اند. برای مثال "URL スキーム"، "URL Scheme" و غیره است.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی Ad Manager برای maio دارای قابلیت های زیر است:
ادغام | |
---|---|
مناقصه | |
آبشار | |
فرمت ها | |
بنر | |
بینابینی | |
پاداش داده شد | |
بومی |
الزامات
- Android API سطح 21 یا بالاتر
- maio SDK 1.0.7 یا بالاتر
جدیدترین SDK تبلیغات موبایل گوگل
راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در maio UI تنظیم کنید
ابتدا ثبت نام کنید یا وارد حساب کاربری maio خود شوید. روی دکمه مدیریت برنامه در نوار کناری سمت چپ کلیک کنید و روی برنامه جدید کلیک کنید.
برگه مربوط به نوع تبلیغ دلخواه خود را انتخاب کنید.
بینابینی
نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و URL برنامه خود را ارائه دهید. Video interstitial را به عنوان نوع آگهی انتخاب کنید و سپس روی Update کلیک کنید.
پاداش داده شد
نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و URL برنامه خود را ارائه دهید. Video Rewards را به عنوان نوع تبلیغ انتخاب کنید و سپس روی Update کلیک کنید.
در صفحه مدیریت برنامه ، شناسه رسانه را یادداشت کنید. برای راهاندازی واحد تبلیغات Ad Manager در بخش بعدی، لازم است.
در صفحه مدیریت منطقه ، شناسه منطقه را یادداشت کنید. همچنین لازم است واحد تبلیغات Ad Manager خود را در بخش بعدی راه اندازی کنید.
علاوه بر شناسه رسانه و شناسه منطقه ، برای تنظیم شناسه واحد تبلیغاتی خود برای میانجیگری، علاوه بر شناسه رسانه و شناسه منطقه، به شناسه API و کلید API نیاز دارید. در صفحه گزارش API ، شناسه API و کلید API را یادداشت کنید.مرحله 2: تقاضای maio را در UI Ad Manager تنظیم کنید
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
به حساب Ad Manager خود وارد شوید.
به مسیر Delivery > Yield Groups بروید و روی دکمه گروه بازده جدید کلیک کنید.
یک نام منحصر به فرد برای گروه بازدهی خود وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب تبلیغات خود را انتخاب کنید و نوع موجودی را روی برنامه موبایل تنظیم کنید. در بخش Targeting > Inventory ، واحد تبلیغاتی را در برنامه Inventory and Mobile که میخواهید میانجیگری را به آن اضافه کنید، انتخاب کنید.
بعد، روی دکمه افزودن شریک عملکرد کلیک کنید.
اگر از قبل شریک بازدهی برایmaioدارید، میتوانید آن را انتخاب کنید. در غیر این صورت، Create a new yield partner را انتخاب کنید.
maio به عنوان شبکه تبلیغات انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید.
جمعآوری خودکار دادهها را روشن کنید وAPI ID and API KEYرا که در بخش قبل به دست آمد، وارد کنید.
پس از انتخاب شریک Yield ، Mobile SDK Mediation را به عنوان نوع یکپارچه سازی ، Android به عنوان پلتفرم و Active را به عنوان وضعیت انتخاب کنید.Media ID and Zone ID به دست آمده در بخش قبل را وارد کنید. سپس، یک مقدار پیش فرض CPM را وارد کنید.
پس از اتمام روی ذخیره در پایین صفحه کلیک کنید.
مرحله 3: maio SDK و آداپتور را وارد کنید
ادغام Android Studio (توصیه می شود)
در فایل settings.gradle.kts
سطح پروژه خود، مخازن زیر را اضافه کنید:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
سپس، در فایل build.gradle.kts
در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه maio SDK و آداپتور استفاده کنید:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
ادغام دستی
- آخرین نسخه maio Android SDK را دانلود کنید و آن را به پروژه خود اضافه کنید.
- به مصنوعات آداپتور maio در مخزن Maven Google بروید. آخرین نسخه را انتخاب کنید، فایل '.aar' آداپتور maio را دانلود کنید و آن را به پروژه خود اضافه کنید.
مرحله 4: کد مورد نیاز را اضافه کنید
هیچ کد اضافی برای ادغام maio Android مورد نیاز نیست.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برایAd Manager.
ناشرانکه از نسخه 11.6.0 یا بالاتر از Google Mobile Ads SDK استفاده میکنند، بهطور خودکار آگهیهای آزمایشی را از maio در تلفنها و رایانههای لوحی ثبتشده بهعنوان دستگاههای آزمایشی هنگام درخواست دریافت میکنند. ناشران
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را ازmaioدریافت میکنید، با استفاده از منبع(های) آگهی maio (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از maio دریافت کند، ناشران میتوانند با استفاده ازResponseInfo.getAdapterResponses()
در کلاسهای زیر، خطای اساسی را از پاسخ آگهی بررسی کنند:
قالب | نام کلاس |
---|---|
بینابینی | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
پاداش داده شد | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
در اینجا کدها و پیامهای همراهی هستند که توسط آداپتور maio در هنگام بارگیری یک آگهی ارسال میشوند:
کد خطا | دلیل |
---|---|
0-10 | maio یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به اسناد کد و maio مراجعه کنید. |
101 | Maio تبلیغی در دسترس ندارد. |
102 | پارامترهای سرور نامعتبر (به عنوان مثال شناسه مکان وجود ندارد). |
103 | زمینه مورد استفاده برای بارگیری آگهی، نمونه «فعالیت» نبود. |
maio Android Mediation Adapter Changelog
نسخه 1.1.16.3
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 23.0.0 به روز شد.
- سازگاری تایید شده با maio SDK نسخه 1.1.16.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 23.0.0.
- Maio SDK نسخه 1.1.16.
نسخه 1.1.16.2
- آداپتور بهروزرسانی شده برای استفاده از کلاس جدید
VersionInfo
. - حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.0.0 به روز شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 22.0.0.
- Maio SDK نسخه 1.1.16.
نسخه 1.1.16.1
-
compileSdkVersion
وtargetSdkVersion
را به API 31 به روز کرد. - حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.0.0 به روز کرد.
- حداقل سطح API Android مورد نیاز را به 19 به روز کرد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 21.0.0.
- Maio SDK نسخه 1.1.16.
نسخه 1.1.16.0
- کدهای خطا به روز شده برای گرفتن خطاهای اضافی maio.
- سازگاری تایید شده با maio SDK نسخه 1.1.16.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.4.0 به روز کرد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 20.4.0.
- Maio SDK نسخه 1.1.16.
نسخه 1.1.15.0
- سازگاری تایید شده با maio SDK نسخه 1.1.15.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.0.0 به روز کرد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 20.0.0.
- Maio SDK نسخه 1.1.15.
نسخه 1.1.14.0
- کدها و پیام های خطای استاندارد آداپتور اضافه شده است.
- سازگاری تایید شده با maio SDK نسخه 1.1.14.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.8.0 به روز کرد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 19.8.0.
- Maio SDK نسخه 1.1.14.
نسخه 1.1.13.0
- سازگاری تایید شده با maio SDK نسخه 1.1.13.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.5.0 به روز کرد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 19.5.0.
- Maio SDK نسخه 1.1.13.
نسخه 1.1.12.0
- حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.4.0 به روز کرد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 19.4.0.
- Maio SDK نسخه 1.1.12.
نسخه 1.1.11.1
- برای محدود کردن مهلتها، اگر maio آگهی آماده نمایش نداشته باشد، اکنون درخواستهای تبلیغات بلافاصله با شکست مواجه میشوند.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.1.0 به روز شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 19.1.0.
- Maio SDK نسخه 1.1.11.
نسخه 1.1.11.0
- سازگاری تایید شده با maio SDK نسخه 1.1.11.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.3.0 به روز شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 18.3.0.
- Maio SDK نسخه 1.1.11.
نسخه 1.1.10.0
- سازگاری تایید شده با maio SDK نسخه 1.1.10.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.2.0 به روز شد.
نسخه 1.1.8.0
- سازگاری تایید شده با maio SDK نسخه 1.1.8.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.1.0 به روز شد.
نسخه 1.1.7.0
- رفع اشکال.
- سازگاری تایید شده با maio SDK نسخه 1.1.7.
نسخه 1.1.6.1
- آداپتور بهروزرسانی شده برای پشتیبانی از API جدید Rewarded.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 17.2.0 به روز شد.
نسخه 1.1.6.0
- سازگاری تایید شده با maio SDK نسخه 1.1.6.
نسخه 1.1.5.0
- سازگاری تایید شده با maio SDK نسخه 1.1.5.
نسخه 1.1.4.0
- سازگاری تایید شده با maio SDK نسخه 1.1.4.
نسخه 1.1.3.1
- آداپتور را برای کار با کلاس نمونه به جای singleton به روز کرد.
نسخه 1.1.3.0
- سازگاری تایید شده با maio SDK نسخه 1.1.3.
نسخه 1.1.2.1
- آداپتور را با توابع اولیه به روز رسانی به روز کرد.
نسخه 1.1.2.0
- سازگاری تایید شده با maio SDK نسخه 1.1.2.
نسخه 1.1.1.1
- آداپتور را برای فراخوانی رویداد تبلیغاتی
onRewardedVideoComplete()
به روز کرد.
نسخه 1.1.1.0
- سازگاری تایید شده با maio SDK نسخه 1.1.1.
نسخه 1.1.0.0
- سازگاری تایید شده با maio SDK نسخه 1.1.0.
نسخه 1.0.8.0
- سازگاری تایید شده با maio SDK نسخه 1.0.8.
نسخه 1.0.7.1
- مشکلی را برطرف کرد که میتواند باعث بروز NullPointerExceptions در هنگام بارگیری نشدن تبلیغات شود.
نسخه 1.0.7.0
- قابلیت فعال کردن حالت تست با افزودن شناسه دستگاه آزمایشی به
AdRequest
اضافه شد. - سازگاری تایید شده با maio SDK نسخه 1.0.7.
نسخه 1.0.6.0
- اولین انتشار!
- اضافه شدن پشتیبانی برای تبلیغات ویدیویی بینابینی و پاداش.