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

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از maio با استفاده از میانجی‌گری استفاده کنید که ادغام‌های آبشار را پوشش می‌دهد. نحوه افزودن maio به پیکربندی میانجی واحد تبلیغات و نحوه ادغام maio SDK و آداپتور در برنامه Unity را پوشش می‌دهد.

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

ادغام ها و قالب های تبلیغاتی پشتیبانی شده

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

ادغام
مناقصه
آبشار
فرمت ها
بنر
بینابینی
پاداش داده شد

الزامات

• یونیتی 4 یا بالاتر
• جدیدترین SDK تبلیغات موبایل گوگل
• برای استقرار در اندروید
  • Android API سطح 21 یا بالاتر
• برای استقرار در iOS
  • هدف استقرار iOS 12.0 یا بالاتر
• یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
• راهنمای شروع میانجیگری را کامل کنید

مرحله 1: تنظیمات را در maio UI تنظیم کنید

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

برگه مربوط به نوع تبلیغ دلخواه خود را انتخاب کنید.

بینابینی

نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و URL برنامه خود را ارائه دهید. Video interstitial را به عنوان نوع آگهی انتخاب کنید و سپس روی Update کلیک کنید.

اندروید

iOS

توجه: تبلیغات بینابینی از maio به طور پیش فرض قابل رد شدن هستند.

پاداش داده شد

نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و URL برنامه خود را ارائه دهید. Video Rewards را به عنوان نوع تبلیغ انتخاب کنید و سپس روی Update کلیک کنید.

اندروید

iOS

توجه: تبلیغات ویدیویی پاداش دار از maio به طور پیش فرض قابل رد شدن نیستند .

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

اندروید

iOS

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

اندروید

iOS

(فقط آبشار)علاوه بر شناسه رسانه و شناسه منطقه ، برای تنظیم شناسه واحد تبلیغاتی خود برای میانجیگری، علاوه بر شناسه رسانه و شناسه منطقه، به شناسه API و کلید API نیاز دارید. در صفحه گزارش API ، شناسه API و کلید API را یادداشت کنید.

توجه: (فقط Waterfall)اگر این اولین باری است که حساب maio خود را راه اندازی می کنید، ممکن است لازم باشد با تیم پشتیبانی maio تماس بگیرید تا شناسه API و کلید API شما برای شما صادر شود.

مرحله 2: تقاضای maio را در UI AdMob تنظیم کنید

تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید

اندروید

برای دستورالعمل‌ها، مرحله 2 را در راهنمایAndroid ببینید.

iOS

برای دستورالعمل‌ها، مرحله 2 را در راهنمایiOS ببینید.

مرحله 3: maio SDK و آداپتور را وارد کنید

توجه: عدم ادغام نسخه‌های maio و Google Mobile Ads SDK ممکن است منجر به مشکلات ساخت شود.

آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل برای maio را از لینک دانلود در Changelog برای maio دانلود کنید و GoogleMobileAdsMaioMediation.unitypackage را از فایل فشرده استخراج کنید.

در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsMaioMediation.unitypackage را که دانلود کرده اید پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.

سپس، Assets > Play Services Resolver > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه Unity Play Services Resolver تفکیک وابستگی‌ها را از ابتدا انجام می‌دهد و وابستگی‌های اعلام‌شده را در فهرست Assets/Plugins/Android برنامه Unity شما کپی می‌کند.

مرحله 4: کد مورد نیاز را اضافه کنید

اندروید

هیچ کد اضافی برای ادغام maio مورد نیاز نیست.

iOS

ادغام SKAdNetwork

مستندات maio را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.

مرحله 5: اجرای خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

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

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

مهم: قبل از انتشار برنامه، حالت تست را برای AdMob وmaio غیرفعال کنید.

تبلیغات آزمایشی را تأیید کنید

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

کدهای خطا

اگر آداپتور نتواند تبلیغی را از maio دریافت کند، ناشران می‌توانند با استفاده از ResponseInfo در کلاس‌های زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:

اندروید

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

iOS

قالب	نام کلاس
بینابینی	GADMMaioInterstitialAdapter
پاداش داده شد	GADMMaioRewardedAdapter

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

اندروید

کد خطا	دلیل
0-10	maio یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به اسناد کد و maio مراجعه کنید.
101	Maio تبلیغی در دسترس ندارد.
102	پارامترهای سرور نامعتبر (به عنوان مثال شناسه مکان وجود ندارد).
103	زمینه مورد استفاده برای بارگیری آگهی، نمونه «فعالیت» نبود.

iOS

کد خطا	دلیل
0-10	maio یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به کد maio مراجعه کنید.
101	maio هنوز تبلیغی در دسترس ندارد.
102	پارامترهای سرور نامعتبر (به عنوان مثال شناسه مکان وجود ندارد).
103	آداپتور maio از قالب آگهی درخواستی پشتیبانی نمی کند.
104	یک آگهی قبلاً برای این پیکربندی شبکه بارگیری شده است.

maio Unity Mediation Plugin Changelog

نسخه 2.0.2

• از آداپتور maio اندروید نسخه 1.1.16.3 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 2.1.4.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.0.0.

نسخه 2.0.1

• از آداپتور maio اندروید نسخه 1.1.16.2 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 2.1.3.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.0.0.

نسخه 2.0.0

• از آداپتور maio اندروید نسخه 1.1.16.2 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 2.1.1.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 8.6.0.

نسخه 1.4.3

• محتوای آداپتور به GoogleMobileAds/Mediation/Maio/ منتقل شد.
• از آداپتور maio اندروید نسخه 1.1.16.2 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.6.3.1 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 8.1.0.

نسخه 1.4.2

• از آداپتور maio اندروید نسخه 1.1.16.1 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.6.3.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.4.0 ساخته و آزمایش شده است.

نسخه 1.4.1

• از آداپتور maio اندروید نسخه 1.1.16.1 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.6.2.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 7.1.0.

نسخه 1.4.0

• از آداپتور maio اندروید نسخه 1.1.16.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.6.0.1 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.0.0 ساخته و آزمایش شده است.

نسخه 1.3.6

• از آداپتور maio اندروید نسخه 1.1.16.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.5.8.0 پشتیبانی می کند.

نسخه 1.3.5

• از آداپتور اندروید maio نسخه 1.1.15.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.5.6.1 پشتیبانی می کند.

نسخه 1.3.4

• از آداپتور اندروید maio نسخه 1.1.11.1 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.5.4.0 پشتیبانی می کند.

نسخه 1.3.3

• از آداپتور اندروید maio نسخه 1.1.11.1 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.5.3.1 پشتیبانی می کند.

نسخه 1.3.2

• از آداپتور maio اندروید نسخه 1.1.11.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.5.2.1 پشتیبانی می کند.

نسخه 1.3.1

• از آداپتور maio اندروید نسخه 1.1.10.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.5.1.0 پشتیبانی می کند.

نسخه 1.3.0

• از آداپتور maio اندروید نسخه 1.1.10.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.5.0.0 پشتیبانی می کند.

نسخه 1.2.3

• افزونه را برای پشتیبانی از Rewarded API جدید به روز کرد.
• از آداپتور maio اندروید نسخه 1.1.7.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.4.6.0 پشتیبانی می کند.

نسخه 1.2.2

• از آداپتور maio اندروید نسخه 1.1.6.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.4.2.0 پشتیبانی می کند.

نسخه 1.2.1

• از آداپتور maio اندروید نسخه 1.1.6.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.4.1.0 پشتیبانی می کند.

نسخه 1.2.0

• از آداپتور اندروید maio نسخه 1.1.4.1 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.4.0.0 پشتیبانی می کند.

نسخه 1.1.3

• از آداپتور maio اندروید نسخه 1.1.3.1 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.3.2.0 پشتیبانی می کند.

نسخه 1.1.2

• از آداپتور اندروید maio نسخه 1.1.3.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.3.2.0 پشتیبانی می کند.

نسخه 1.1.1

• از آداپتور maio اندروید نسخه 1.1.1.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.3.1.1 پشتیبانی می کند.

نسخه 1.1.0

• از آداپتور اندروید maio نسخه 1.1.0.0 پشتیبانی می کند.
• از آداپتور maio iOS نسخه 1.3.0.0 پشتیبانی می کند.

نسخه 1.0.2

• پشتیبانی از maio Android SDK نسخه 1.0.8.
• پشتیبانی از maio iOS SDK نسخه 1.2.19.

نسخه 1.0.1

• پشتیبانی از maio Android SDK نسخه 1.0.7.
• پشتیبانی از maio iOS SDK نسخه 1.2.19.

نسخه 1.0.0

• اولین انتشار!
• پشتیبانی از maio Android SDK نسخه 1.0.6.
• پشتیبانی از maio iOS SDK نسخه 1.2.18.