این راهنما به شما نشان می‌دهد که چگونه از 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 تنظیم کنید
مرحله 2: تقاضای maio را تنظیم کنید Ad Manager UI
مرحله 3: maio SDK و آداپتور را وارد کنید
OpenUPM-CLI
اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای دستور زیر از دایرکتوری ریشه پروژه، افزونه Google Mobile Ads maio Mediation for Unity را در پروژه خود نصب کنید:
openupm add com.google.ads.mobile.mediation.maioOpenUPM
در ویرایشگر پروژه Unity خود، Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.
در برگه Scoped Registries ، OpenUPM را به عنوان یک رجیستری محدوده با جزئیات زیر اضافه کنید:
- نام:
OpenUPM - آدرس اینترنتی:
https://package.openupm.com - محدوده (ها):
com.google
سپس به مسیر Window > Package Manager بروید تا Unity Package Manager را باز کنید و My Registries را از منوی کشویی انتخاب کنید.
بسته Google Mobile Ads maio Mediation را انتخاب کنید و روی Install کلیک کنید.
پکیج یونیتی
آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل برای maio را از لینک دانلود در Changelog دانلود کنید و GoogleMobileAdsMaioMediation.unitypackage را از فایل فشرده استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsMaioMediation.unitypackage را که دانلود کرده اید پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.
سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تفکیک وابستگی را از ابتدا انجام می دهد و وابستگی های اعلام شده را در فهرست Assets/Plugins/Android برنامه Unity شما کپی می کند.
مرحله 4: کد مورد نیاز را اضافه کنید
اندروید
هیچ کد اضافی برای ادغام maio مورد نیاز نیست.
iOS
ادغام SKAdNetwork
مستندات maio را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.
مرحله 5: اجرای خود را آزمایش کنید
کدهای خطا
اگر آداپتور نتواند تبلیغی را از 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.3
- از آداپتور maio اندروید نسخه 1.1.16.3 پشتیبانی می کند.
- از آداپتور maio iOS نسخه 2.1.5.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 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.