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

پلاتفرم را انتخاب کنید: Android iOS Unity Flutter Android (Legacy)

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK (Legacy) برای بار کردن و نمایش دادن آگهی‌های maio بااستفاده از میانجی‌گری AdMob استفاده کنید، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن maio به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کیت توسعه نرم‌افزار و مبدل maio در برنامه Android را پوشش می‌دهد.

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

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

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

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

پیش‌نیازها

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

  • Android API سطح ۲۴ یا بالاتر.
  • کیت توسعه نرم‌افزار maio نسخه ۱.۰.۷ یا جدیدتر.

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

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

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

بینابینی

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

پاداش

نام برنامه‌تان را وارد کنید، پلاتفرم را انتخاب کنید و نشانی وب برنامه را ارائه دهید. پاداش‌های ویدیویی را به‌عنوان نوع آگهی انتخاب کنید، سپس روی به‌روزرسانی کلیک کنید.

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

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

علاوه‌بر شناسه رسانه و شناسه منطقه، به شناسه میانای برنامه‌سازی کاربردی و کلید میانای برنامه‌سازی کاربردی نیاز دارید تا شناسه واحد آگهی‌تان را برای میانجی‌گری راه‌اندازی کنید. در صفحه Reporting API، شناسه API و کلید API را یادداشت کنید.

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

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

باید maio را به پیکربندی میانجی‌گری برای واحد آگهی‌تان اضافه کنید.

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

برای ایجاد گروه میانجی‌گری جدید، ایجاد گروه میانجی‌گری را انتخاب کنید.

قالب آگهی و پلاتفرم را وارد کنید، سپس روی ادامه کلیک کنید.

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

این گروه میانجی را با یک یا چند واحد آگهی AdMob موجود مرتبط کنید. سپس روی تمام کلیک کنید.

اکنون باید کارت واحدهای آگهی را ببینید که با واحدهای آگهی انتخابی شما پر شده است:

افزودن maio به‌عنوان منبع آگهی


در زیر کارت آبشاری در بخش منابع آگهی، افزودن منبع آگهی را انتخاب کنید.

maio را انتخاب کنید و کلید بهینه‌سازی را فعال کنید. شناسه API و کلید API را که در بخش قبلی دریافت کردید وارد کنید تا بهینه‌سازی منبع آگهی برای maio راه‌اندازی شود. سپس مقدار eCPM را برای maio وارد کنید و روی ادامه کلیک کنید.




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



سپس، شناسه رسانه و شناسه منطقه را که در بخش قبلی به‌دست آوردید وارد کنید. سپس روی تمام کلیک کنید.


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

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

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

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

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:maio:2.0.9.1")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:maio:2.0.9.1'
}

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

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

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

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

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

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

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

ناشرانی که از نسخه ۱۱.۶.۰ یا بالاتر Google Mobile Ads SDK (Legacy) استفاده می‌کنند، هنگام درخواست دادن، به‌طور خودکار آگهی‌های آزمایشی از maio در تلفن‌ها و رایانه‌های لوحی ثبت‌شده به‌عنوان دستگاه‌های آزمایشی دریافت خواهند کرد.

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

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

کدهای خطا

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

قالب نام کلاس
بینابینی jp.maio.sdk.android.mediation.admob.adapter.Interstitial
پاداش jp.maio.sdk.android.mediation.admob.adapter.Rewarded

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

کد خطا استدلال
0-10 ‫maio خطای مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، کد و اسناد maio را ببینید.
۱۰۱ Maio آگهی دردسترس ندارد.
102 پارامترهای سرور نامعتبر است (مثلاً شناسه جای آگهی وجود ندارد).
103 بافتی که برای بار کردن آگهی استفاده شد نمونه `Activity` نبود.
104 درخواست دارای رفتار محدودشده سنی بود، اما کیت توسعه نرم‌افزار 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 نسخه ۱.۰.۷ تأیید شد.

نسخه ۱.۰.۶.۰

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