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

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

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

میانای داشبورد maio از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و توضیحات استفاده می‌کند و نماگرفت‌های این راهنما ترجمه نشده‌اند. بااین‌حال، در شرح‌ها و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی آن‌ها ارجاع داده می‌شوند. برای مثال، «URL スキーム» به‌معنای «طرح نشانی وب» است.

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

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

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

پیش‌نیازها

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

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

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

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

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

بینابینی

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

پاداش

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مرحله ۳: وارد کردن کیت توسعه نرم‌افزار و آداپتور 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، به کد اضافی نیاز نیست.

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

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

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

ناشرانی که از نسخه ۱۱.۶.۰ یا بالاتر 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

نسخه ۲.۰.۹.۱

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

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

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

نسخه ۲.۰.۹.۰

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

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

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

نسخه ۲.۰.۸.۲

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

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

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

نسخه ۲.۰.۸.۱

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

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

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

نسخه ۲.۰.۸.۰

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

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

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

نسخه ۲.۰.۷.۰

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

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

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

نسخه ۲.۰.۶.۰

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

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

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

نسخه ۲.۰.۵.۰

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

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

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

نسخه 2.0.4.0

  • سازگاری با نسخه ۲.۰.۴ کیت توسعه نرم‌افزار maio تأیید شد.

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

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

نسخه ۲.۰.۳.۱

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

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

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

نسخه ۲.۰.۳.۰

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • حداقل نسخه کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google موردنیاز به نسخه 19.4.0 به‌روزرسانی شد.

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

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

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

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

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

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

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

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

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

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

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

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

نسخه ۱.۱.۸.۰

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

نسخه ۱.۱.۷.۰

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

نسخه ۱.۱.۶.۱

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

نسخه ۱.۱.۶.۰

  • سازگاری با نسخه ۱.۱.۶ کیت توسعه نرم‌افزار maio تأیید شد.

نسخه ۱.۱.۵.۰

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

نسخه ۱.۱.۴.۰

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

نسخه ۱.۱.۳.۱

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

نسخه ۱.۱.۳.۰

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

نسخه ۱.۱.۲.۱

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

نسخه ۱.۱.۲.۰

  • سازگاری با نسخه ۱.۱.۲ کیت توسعه نرم‌افزار maio تأیید شد.

نسخه ۱.۱.۱.۱

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

نسخه ۱.۱.۱.۰

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

نسخه ۱.۱.۰.۰

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

نسخه ۱.۰.۸.۰

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

نسخه ۱.۰.۷.۱

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

نسخه ۱.۰.۷.۰

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

نسخه ۱.۰.۶.۰

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