ادغام maio با میانجی‌گری

این راهنما به شما نشان می‌دهد که چگونه از GMA Next-Gen SDK برای بار کردن و نمایش دادن آگهی‌های maio بااستفاده از میانجی‌گری استفاده کنید، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن maio به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کیت توسعه نرم‌افزار و مبدل maio در برنامه Android را پوشش می‌دهد.

میانای داشبورد maio از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و توضیحات استفاده می‌کند و نماگرفت‌های این راهنما ترجمه نشده‌اند. اما در توضیحات و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی‌شان ارجاع داده شده‌اند. "URL スキーム," for example, is "URL Scheme".

یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده

آداپتور میانجی maio قابلیت‌های زیر را دارد:

پیش‌نیازها

قبل‌از ادامه دادن، موارد زیر را تأیید کنید:

• Android API سطح ۲۴ یا بالاتر.

• کیت توسعه نرم‌افزار maio نسخه ۱.۰.۷ یا جدیدتر.

• جدیدترین نسخه GMA Next-Gen SDK.

• راه‌اندازی میانجی‌گری.

مرحله ۱: راه‌اندازی پیکربندی‌ها در میانای کاربری maio

ابتدا، ثبت‌نام کنید یا به حساب maio خود وارد شوید. روی دکمه مدیریت برنامه در نوار کناری سمت راست کلیک کنید و روی برنامه جدید کلیک کنید.

زبانه مربوط به نوع آگهی موردنظرتان را انتخاب کنید.

در صفحه مدیریت برنامه، شناسه رسانه را یادداشت کنید. این شناسه برای راه‌اندازی واحد آگهی Ad Manager در بخش بعدی لازم است.

در صفحه مدیریت منطقه، شناسه منطقه را یادداشت کنید. همچنین برای راه‌اندازی واحد آگهی Ad Manager در بخش بعدی به آن نیاز خواهید داشت.

مرحله ۲: راه‌اندازی تقاضای maio در میانای کاربر Ad Manager

پیکربندی تنظیمات میانجی‌گری برای واحد آگهی شما

به سیستم حساب Ad Manager خود وارد شوید.

به تحویل > گروه‌های بازده بروید و روی دکمه گروه بازده جدید کلیک کنید.

نام منحصربه‌فردی برای گروه بازدهی‌تان وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب آگهی خود را انتخاب کنید، و نوع فضای آگهی را روی برنامه تلفن همراه تنظیم کنید. در بخش هدف‌یابی > فضای آگهی، واحد آگهی را در بخش فضای آگهی و برنامه تلفن همراه که می‌خواهید میانجی‌گری را به آن اضافه کنید انتخاب کنید.

سپس، روی دکمه افزودن شریک بازده کلیک کنید.

اگر ازقبل شریک Yield برای maio دارید، می‌توانید آن را انتخاب کنید. درغیراین‌صورت، ایجاد شریک بازده جدید را انتخاب کنید.

maio را به‌عنوان شبکه آگهی انتخاب کنید، نام یکتایی وارد کنید، و میانجی‌گری را فعال کنید.

جمع‌آوری خودکار داده را روشن کنید و شناسه API و کلید API را که در بخش قبلی دریافت کردید وارد کنید.

پس‌از انتخاب شریک بازده، میانجی‌گری کیت توسعه نرم‌افزار تلفن همراه را به‌عنوان نوع ادغام، Android را به‌عنوان پلاتفرم، و فعال را به‌عنوان وضعیت انتخاب کنید. شناسه رسانه و شناسه منطقه را که در بخش قبلی به‌دست آوردید وارد کنید. سپس، مقدار هزارظهوربهای پیش‌فرض را وارد کنید.

پس‌از اتمام، روی ذخیره در پایین صفحه کلیک کنید.

مرحله ۳: وارد کردن کیت توسعه نرم‌افزار و آداپتور maio

یکپارچه‌سازی «استودیو Android» (توصیه‌شده)

در فایل settings.gradle.kts سطح پروژه، مخازن زیر را اضافه کنید:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

در فایل gradle سطح برنامه، وابستگی‌های پیاده‌سازی و پیکربندی‌های زیر را اضافه کنید:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:maio:2.0.9.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:maio:2.0.9.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

یکپارچه‌سازی دستی

• جدیدترین نسخه کیت توسعه نرم‌افزار maio Android را بارگیری کنید و آن را به پروژه‌تان اضافه کنید.
• به مصنوعات آداپتور maio در مخزن Maven Google بروید. جدیدترین نسخه را انتخاب کنید، فایل ‎.aar آداپتور maio را بارگیری کنید، و آن را به پروژه‌تان اضافه کنید.

مرحله ۴: افزودن کد لازم

برای یکپارچه‌سازی maio Android به کد دیگری نیاز نیست.

مرحله ۵: آزمایش پیاده‌سازی

فعال کردن آگهی‌های آزمایشی

مطمئن شوید دستگاه آزمایشی خود را برای Ad Manager ثبت کنید.

ناشرانی که از نسخه ۱۱.۶.۰ یا بالاتر GMA Next-Gen SDK استفاده می‌کنند، هنگام درخواست دادن، به‌طور خودکار آگهی‌های آزمایشی از maio در تلفن‌ها و رایانه‌های لوحی ثبت‌شده به‌عنوان دستگاه‌های آزمایشی دریافت خواهند کرد.

درستی‌سنجی آگهی‌های آزمایشی

برای تأیید اینکه آگهی‌های آزمایشی را از maio دریافت می‌کنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع (های) آگهی maio(آبشاری) فعال کنید.

کدهای خطا

اگر آداپتور نتواند آگهی را از maio دریافت کند، ناشران می‌توانند خطای اصلی را از پاسخ آگهی بااستفاده از ResponseInfo.getAdSourceResponses() تحت کلاس‌های زیر بررسی کنند:

در اینجا کدها و پیام‌های همراهی که توسط آداپتور maio هنگام بارگیری نشدن آگهی ارسال می‌شوند، آورده شده است:

گزارش تغییرات آداپتور میانجی maio Android

نسخه بعدی

• آداپتور برای استفاده از میانای برنامه‌سازی کاربردی InitializationCompleteCallback.onInitializationFailed(AdError) به‌روز شد.
• حداقل سطح میانای برنامه‌سازی کاربردی Android موردنیاز به ۲۴ به‌روز شد.

نسخه ۲.۰.۹.۱

• وابستگی Kotlin آداپتور را به ۱.۹.۰ (حداقل نسخه Kotlin پشتیبانی‌شده توسط کیت توسعه نرم‌افزار GMA NextGen) سنجاق کنید.
• رفتار بازگشتی در شاخه‌های ناموفق دارای محدودیت سنی درطول درخواست‌های مقداردهی اولیه آگهی و بار کردن آگهی برطرف شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار Google Mobile Ads نسخه ۲۵.۴.۰.
• نسخه ۱.۵.۰ کیت توسعه نرم‌افزار نسل بعدی آگهی‌های Google Mobile.
• Maio SDK نسخه ۲.۰.۹.۱.

نسخه ۲.۰.۹.۰

• وقتی AgeRestrictedTreatment جدید روی CHILD تنظیم شده باشد، درخواست‌های دارای محدودیت سنی برای maio SDK فیلتر می‌شود.
• سازگاری با maio SDK نسخه ۲.۰.۹ تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار Google Mobile Ads نسخه ۲۵.۴.۰.
• کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google نسل بعدی نسخه ۱.۳.۱.
• Maio SDK نسخه ۲.۰.۹.۰.

نسخه ۲.۰.۸.۲

• درخواست‌های دارای محدودیت سنی را برای کیت توسعه نرم‌افزار maio فیلتر کنید چون نمی‌تواند سیگنال‌های دارای محدودیت سنی را دریافت کند.
• ویژگی‌ای برای ساختن آداپتور با وابستگی GMA Next-Gen SDK اضافه شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۵.۱.۰.
• نسخه ۱.۱.۰ کیت توسعه نرم‌افزار نسل بعدی آگهی‌های Google Mobile.
• کیت توسعه نرم‌افزار Maio نسخه ۲.۰.۸.۲.

نسخه ۲.۰.۸.۱

• پشتیبانی از قالب آگهی برنما اضافه شد

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۵.۰.۰.
• Maio SDK نسخه ۲.۰.۸.۱.

نسخه ۲.۰.۸.۰

• سازگاری با maio SDK نسخه ۲.۰.۸ تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
• Maio SDK نسخه ۲.۰.۸.۰.

نسخه ۲.۰.۷.۰

• سازگاری با maio SDK نسخه 2.0.7 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
• Maio SDK نسخه ۲.۰.۷.۰.

نسخه ۲.۰.۶.۰

• ارجاع‌های سطح کلاس به Context برداشته شد. می‌تواند به کاهش مشکلات نشت حافظه کمک کند
• سازگاری با maio SDK نسخه 2.0.6 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۶.۰.
• کیت توسعه نرم‌افزار Maio نسخه ۲.۰.۶.۰.

نسخه ۲.۰.۵.۰

• سازگاری با maio SDK نسخه ۲.۰.۵ تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۴.۰.
• Maio SDK نسخه ۲.۰.۵.۰.

نسخه ۲.۰.۴.۰

• سازگاری با maio SDK نسخه 2.0.4 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۳.۰.
• Maio SDK نسخه ۲.۰.۴.۰.

نسخه ۲.۰.۳.۱

• حداقل سطح میانای برنامه‌سازی کاربردی Android موردنیاز به ۲۳ به‌روز شد.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۴.۰.۰ به‌روزرسانی شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۰.۰.
• Maio SDK نسخه ۲.۰.۳.۰.

نسخه ۲.۰.۳.۰

• سازگاری با maio SDK نسخه 2.0.3.0 تأیید شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار Google Mobile Ads نسخه ۲۳.۶.۰.
• Maio SDK نسخه ۲.۰.۳.۰.

نسخه ۱.۱.۱۶.۳

• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۳.۰.۰ به‌روزرسانی شد.
• سازگاری با maio SDK نسخه ۱.۱.۱۶ درستی‌سنجی شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۳.۰.۰.
• Maio SDK نسخه ۱.۱.۱۶.

نسخه ۱.۱.۱۶.۲

• آداپتور برای استفاده از کلاس VersionInfo جدید به‌روز شد.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۲.۰.۰ به‌روزرسانی شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۲.۰.۰.
• Maio SDK نسخه ۱.۱.۱۶.

نسخه ۱.۱.۱۶.۱

• ‫compileSdkVersion و targetSdkVersion به میانای برنامه‌سازی کاربردی ۳۱ به‌روزرسانی شد.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۱.۰.۰ به‌روزرسانی شد.
• حداقل سطح میانای برنامه‌سازی کاربردی Android موردنیاز به ۱۹ به‌روز شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۱.۰.۰.
• Maio SDK نسخه ۱.۱.۱۶.

نسخه ۱.۱.۱۶.۰

• کدهای خطا برای ثبت خطاهای maio بیشتر به‌روز شد.
• سازگاری با maio SDK نسخه ۱.۱.۱۶ درستی‌سنجی شد.
• حداقل نسخه لازم «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۰.۴.۰ به‌روزرسانی شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۰.۴.۰.
• Maio SDK نسخه ۱.۱.۱۶.

نسخه ۱.۱.۱۵.۰

• سازگاری با maio SDK نسخه ۱.۱.۱۵ تأیید شد.
• حداقل نسخه لازم «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۰.۰.۰ به‌روزرسانی شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۰.۰.۰.
• Maio SDK نسخه ۱.۱.۱۵.

نسخه ۱.۱.۱۴.۰

• کدها و پیام‌های خطای استانداردشده آداپتور اضافه شد.
• سازگاری با maio SDK نسخه ۱.۱.۱۴ تأیید شد.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۱۹.۸.۰ به‌روزرسانی شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۹.۸.۰.
• Maio SDK نسخه ۱.۱.۱۴.

نسخه ۱.۱.۱۳.۰

• سازگاری با maio SDK نسخه ۱.۱.۱۳ تأیید شد.
• حداقل نسخه لازم «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۱۹.۵.۰ به‌روزرسانی شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۹.۵.۰.
• Maio SDK نسخه ۱.۱.۱۳.

نسخه ۱.۱.۱۲.۰

• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۱۹.۴.۰ به‌روزرسانی شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۹.۴.۰.
• Maio SDK نسخه ۱.۱.۱۲.

نسخه ۱.۱.۱۱.۱

• برای محدود کردن زمان‌های وقفه، اگر maio آگهی آماده‌ای برای نمایش نداشته باشد، درخواست‌های آگهی ازاین‌پس فوراً ناموفق خواهد بود.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۱۹.۱.۰ به‌روزرسانی شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۹.۱.۰.
• Maio SDK نسخه ۱.۱.۱۱.

نسخه ۱.۱.۱۱.۰

• سازگاری با maio SDK نسخه ۱.۱.۱۱ تأیید شد.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۱۸.۳.۰ به‌روزرسانی شد.

ساخته و آزمایش‌شده با:

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۸.۳.۰.
• Maio SDK نسخه ۱.۱.۱۱.

نسخه ۱.۱.۱۰.۰

• سازگاری با maio SDK نسخه ۱.۱.۱۰ تأیید شد.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۱۸.۲.۰ به‌روزرسانی شد.

نسخه ۱.۱.۸.۰

• سازگاری با maio SDK نسخه ۱.۱.۸ تأیید شد.
• حداقل نسخه موردنیاز کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google به ۱۸.۱.۰ به‌روزرسانی شد.

نسخه ۱.۱.۷.۰

• رفع اشکال‌ها.
• سازگاری با maio SDK نسخه ۱.۱.۷ تأیید شد.

نسخه ۱.۱.۶.۱

• آداپتور برای پشتیبانی از «میانای برنامه‌سازی کاربردی پاداش‌دار» جدید به‌روز شد.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه» Google به ۱۷.۲.۰ به‌روز شد.

نسخه ۱.۱.۶.۰

• سازگاری با maio SDK نسخه ۱.۱.۶ تأیید شد.

نسخه ۱.۱.۵.۰

• سازگاری با maio SDK نسخه ۱.۱.۵ تأیید شد.

نسخه ۱.۱.۴.۰

• سازگاری با maio SDK نسخه ۱.۱.۴ تأیید شد.

نسخه ۱.۱.۳.۱

• آداپتور به‌روزرسانی شد تا به‌جای سینگلتون با کلاس نمونه کار کند.

نسخه ۱.۱.۳.۰

• سازگاری با maio SDK نسخه ۱.۱.۳ تأیید شد.

نسخه ۱.۱.۲.۱

• آداپتور با عملکردهای مقداردهی اولیه به‌روزشده به‌روز شد.

نسخه ۱.۱.۲.۰

• سازگاری با maio SDK نسخه ۱.۱.۲ تأیید شد.

نسخه ۱.۱.۱.۱

• آداپتور برای فراخوانی رویداد آگهی onRewardedVideoComplete() به‌روز شد.

نسخه ۱.۱.۱.۰

• سازگاری با maio SDK نسخه ۱.۱.۱ تأیید شد.

نسخه ۱.۱.۰.۰

• سازگاری با maio SDK نسخه ۱.۱.۰ تأیید شد.

نسخه ۱.۰.۸.۰

• سازگاری با maio SDK نسخه ۱.۰.۸ تأیید شد.

نسخه ۱.۰.۷.۱

• مشکلی که می‌توانست باعث شود NullPointerExceptions هنگام بار نشدن آگهی‌ها رخ دهد برطرف شد.

نسخه ۱.۰.۷.۰

• قابلیت فعال کردن حالت آزمایشی با افزودن شناسه دستگاه آزمایشی به AdRequest اضافه شد.
• سازگاری با maio SDK نسخه ۱.۰.۷ تأیید شد.

نسخه ۱.۰.۶.۰

• اولین انتشار!
• پشتیبانی از آگهی‌های بینابینی و آگهی‌های ویدیویی پاداش‌دار اضافه شد.