این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads Unity Plugin برای بار کردن و نمایش دادن آگهی‌های maio بااستفاده از میانجی‌گری استفاده کنید، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن maio به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کیت توسعه نرم‌افزار و آداپتور maio در برنامه Unity را پوشش می‌دهد.
میانای داشبورد maio از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و توضیحات استفاده می‌کند و نماگرفت‌های این راهنما ترجمه نشده‌اند. بااین‌حال، در توضیحات و دستورالعمل‌های اینجا، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی‌شان نام برده می‌شوند. "URL スキーム," for example, is "URL Scheme,".
یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده
آداپتور میانجی maio قابلیت‌های زیر را دارد:
| یکپارچه‌سازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالب‌ها | |
| صفحه باز شدن برنامه | |
| برنما | |
| بینابینی | |
| پاداش | |
| بینابینی پاداش‌دار | |
| بومی | |
پیش‌نیازها
قبل‌از ادامه دادن، موارد زیر را تأیید کنید:
- جدیدترین نسخه Google Mobile Ads Unity Plugin.
- Unity Editor نسخه ۴ یا بالاتر.
- برای استقرار در Android
- Android API سطح ۲۴ یا بالاتر.
- برای استقرار در iOS
- هدف استقرار iOS نسخه ۱۵.۰ یا جدیدتر.
- یک پروژه Unity فعال که با Google Mobile Ads Unity Plugin پیکربندی شده باشد. برای جزئیات، راه‌اندازی Google Mobile Ads Unity Plugin را ببینید.
مرحله ۱: راه‌اندازی پیکربندی‌ها در میانای کاربری maio
ابتدا، ثبت‌نام کنید یا به حساب maio خود وارد شوید. روی دکمه مدیریت برنامه در نوار کناری سمت راست کلیک کنید و روی برنامه جدید کلیک کنید.
زبانه مربوط به نوع آگهی موردنظرتان را انتخاب کنید.
بینابینی
نام برنامه‌تان را وارد کنید، پلاتفرم را انتخاب کنید و نشانی وب برنامه را ارائه دهید. آگهی تمام‌صفحه ویدیویی را به‌عنوان نوع آگهی انتخاب کنید، و سپس روی به‌روزرسانی کلیک کنید.
Android
iOS
پاداش
نام برنامه‌تان را وارد کنید، پلاتفرم را انتخاب کنید و نشانی وب برنامه را ارائه دهید. پاداش‌های ویدیویی را به‌عنوان نوع آگهی انتخاب کنید، سپس روی به‌روزرسانی کلیک کنید.
Android
iOS
در صفحه مدیریت برنامه، شناسه رسانه را یادداشت کنید. این کد برای راه‌اندازی واحد آگهی Ad Manager در بخش بعدی لازم است.
Android
iOS
در صفحه مدیریت منطقه، شناسه منطقه را یادداشت کنید. همچنین برای راه‌اندازی واحد آگهی Ad Manager در بخش بعدی به آن نیاز خواهید داشت.
Android
iOS
مرحله ۲: راه‌اندازی تقاضای maio در میانای کاربر Ad Manager
پیکربندی تنظیمات میانجی‌گری برای واحد آگهی شما
Android
برای دستورالعمل‌ها، مرحله ۲ را در راهنمای Android ببینید.
iOS
برای دستورالعمل‌ها، مرحله ۲ را در راهنمای iOS ببینید.
مرحله ۳: وارد کردن کیت توسعه نرم‌افزار maio و آداپتور
OpenUPM-CLI
اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای فرمان زیر از دایرکتوری ریشه پروژه‌تان، «افزونه میانجی‌گری Google Mobile Ads maio» را برای Unity در پروژه‌تان نصب کنید:
openupm add com.google.ads.mobile.mediation.maioOpenUPM
در ویرایشگر پروژه Unity، ویرایش > تنظیمات پروژه > مدیر بسته را انتخاب کنید تا تنظیمات مدیر بسته Unity باز شود.
در برگه Scoped Registries، OpenUPM را به‌عنوان یک scoped registry با جزئیات زیر اضافه کنید:
- نام:
OpenUPM - نشانی وب:
https://package.openupm.com - حوزه(ها):
com.google
سپس، به Window > Package Manager بروید تا Unity Package Manager را باز کنید و My Registries را از منوِ کرکره‌ای انتخاب کنید.
بسته Google Mobile Ads Maio Mediation را انتخاب کنید و روی Install (نصب) کلیک کنید.
بسته Unity
جدیدترین نسخه افزونه میانجی‌گری «تبلیغات Google برای تلفن همراه» را برای maio از پیوند بارگیری در گزارش تغییرات بارگیری کنید و GoogleMobileAdsMaioMediation.unitypackage را از فایل zip استخراج کنید.
در ویرایشگر پروژه Unity، دارایی‌ها > وارد کردن بسته >
بسته سفارشی را انتخاب کنید و
فایل GoogleMobileAdsMaioMediation.unitypackage
بارگیری‌شده را پیدا کنید. مطمئن شوید همه فایل‌ها انتخاب شده باشند و روی
وارد کردن کلیک کنید.
سپس Assets (دارایی‌ها) > External Dependency Manager (مدیر وابستگی خارجی) >
Android Resolver (حل‌کننده Android) > Force Resolve (حل اجباری) را انتخاب کنید. کتابخانه «مدیر وابستگی خارجی»
وضوح وابستگی را از ابتدا انجام خواهد داد و وابستگی‌های اعلام‌شده را
در دایرکتوری Assets/Plugins/Android برنامه Unity شما
کپی خواهد کرد.
مرحله ۴: افزودن کد لازم
Android
برای ادغام maio به کد دیگری نیاز نیست.
iOS
ادغام SKAdNetwork
اسناد maio را دنبال کنید
تا شناسه‌های SKAdNetwork را به فایل Info.plist پروژه‌تان اضافه کنید.
مرحله ۵: آزمایش پیاده‌سازی
فعال کردن آگهی‌های آزمایشی
مطمئن شوید دستگاه آزمایشی‌تان را برای Ad Manager ثبت کرده باشید.
ناشرانی که از نسخه ۷.۲۶.۰ یا بالاتر Google Mobile Ads Unity Plugin استفاده می‌کنند، هنگام درخواست دادن، به‌طور خودکار آگهی‌های آزمایشی از maio در تلفن‌ها و رایانه‌های لوحی ثبت‌شده به‌عنوان دستگاه‌های آزمایشی دریافت خواهند کرد.
درستی‌سنجی آگهی‌های آزمایشی
برای تأیید اینکه آگهی‌های آزمایشی را از maio دریافت می‌کنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع (های) آگهی maio(آبشاری) فعال کنید.
کدهای خطا
اگر آداپتور نتواند آگهی را از maio دریافت کند، ناشران می‌توانند خطای اساسی را از پاسخ آگهی بااستفاده از ResponseInfo تحت کلاس‌های زیر بررسی کنند:
Android
| قالب | نام کلاس |
|---|---|
| بینابینی | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| پاداش | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
| قالب | نام کلاس |
|---|---|
| بینابینی | GADMMaioInterstitialAdapter |
| پاداش | GADMMaioRewardedAdapter |
در اینجا کدها و پیام‌های همراهی که توسط آداپتور maio هنگام بارگیری نشدن آگهی ارسال می‌شوند آورده شده است:
Android
| کد خطا | استدلال |
|---|---|
| 0-10 | maio خطای مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، کد و اسناد maio را ببینید. |
| ۱۰۱ | Maio آگهی دردسترس ندارد. |
| 102 | پارامترهای سرور نامعتبر است (مثلاً شناسه جای آگهی وجود ندارد). |
| 103 | بافتی که برای بار کردن آگهی استفاده شده است نمونه `Activity` نبود. |
iOS
| کد خطا | استدلال |
|---|---|
| 0-10 | maio خطای مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، کد maio را ببینید. |
| ۱۰۱ | maio هنوز آگهی دردسترس ندارد. |
| 102 | پارامترهای سرور نامعتبر است (مثلاً شناسه جای آگهی وجود ندارد). |
| 103 | آداپتور maio از قالب آگهی درخواست‌شده پشتیبانی نمی‌کند. |
| 104 | آگهی ازقبل برای این پیکربندی شبکه بار شده است. |
گزارش تغییرات افزایه میانجی‌گری Unity برای maio
نسخه ۳.۱.۱۱
- از آداپتور maio Android نسخه 2.0.9.1 پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه 2.2.3.0 پشتیبانی می‌کند.
- با نسخه ۱۱.۵.۰ افزونه Unity تبلیغات تلفن همراه Google ساخته و آزمایش شده است.
نسخه ۳.۱.۱۰
- از نسخه 2.0.9.0 آداپتور maio Android پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه ۲.۲.۲.۰ پشتیبانی می‌کند.
- با نسخه ۱۱.۴.۰ «افزونه Unity تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.
نسخه ۳.۱.۹
- از آداپتور maio Android نسخه 2.0.9.0 پشتیبانی می‌کند.
- از نسخه 2.2.1.2.1 آداپتور maio iOS پشتیبانی می‌کند.
- بااستفاده از «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۱۱.۳.۰ ساخته و آزمایش شده است.
نسخه ۳.۱.۸
- از آداپتور maio Android نسخه 2.0.8.2 پشتیبانی می‌کند.
- از نسخه ۲.۲.۱.۲ آداپتور maio iOS پشتیبانی می‌کند.
- با «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۱۱.۱.۰ ساخته و آزمایش شده است.
نسخه ۳.۱.۷
- از آداپتور maio Android نسخه 2.0.8.2 پشتیبانی می‌کند.
- از آداپتور maio برای iOS نسخه 2.2.1.1 پشتیبانی می‌کند.
- با «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۱۱.۰.۰ ساخته و آزمایش شده است.
نسخه ۳.۱.۶
- از آداپتور maio Android نسخه 2.0.8.1 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۲.۲.۱.۰ برای iOS پشتیبانی می‌کند.
- با «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۱۱.۰.۰ ساخته و آزمایش شده است.
نسخه ۳.۱.۵
- از آداپتور maio Android نسخه 2.0.8.0 پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه 2.2.0.3 پشتیبانی می‌کند.
- با «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۱۱.۰.۰ ساخته و آزمایش شده است.
نسخه ۳.۱.۴
- از آداپتور maio Android نسخه 2.0.8.0 پشتیبانی می‌کند.
- از آداپتور maio برای iOS نسخه ۲.۲.۰.۱ پشتیبانی می‌کند.
- با نسخه ۱۰.۶.۰ «افزونه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۳.۱.۳
- از آداپتور maio Android نسخه 2.0.7.0 پشتیبانی می‌کند.
- از آداپتور maio برای iOS نسخه ۲.۲.۰.۱ پشتیبانی می‌کند.
- با نسخه ۱۰.۶.۰ «افزونه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۳.۱.۲
- از آداپتور maio Android نسخه 2.0.7.0 پشتیبانی می‌کند.
- از نسخه ۲.۲.۰.۰ آداپتور maio iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۶.۰ «افزونه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۳.۱.۱
- از آداپتور maio Android نسخه 2.0.6.0 پشتیبانی می‌کند.
- از نسخه ۲.۲.۰.۰ آداپتور maio iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۵.۰ «افزونه Unity تبلیغات Google در تلفن همراه» ساخته و آزمایش شده است.
نسخه ۳.۱.۰
- از آداپتور maio Android نسخه 2.0.5.0 پشتیبانی می‌کند.
- از نسخه ۲.۲.۰.۰ آداپتور maio iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۵.۰ «افزونه Unity تبلیغات Google در تلفن همراه» ساخته و آزمایش شده است.
نسخه ۳.۰.۲
- از آداپتور maio Android نسخه 2.0.5.0 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۲.۱.۶.۱ برای iOS پشتیبانی می‌کند.
- بااستفاده از «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۱۰.۲.۰ ساخته و آزمایش شده است.
نسخه ۳.۰.۱
- از آداپتور maio Android نسخه 2.0.4.0 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۲.۱.۶.۱ برای iOS پشتیبانی می‌کند.
- بااستفاده از «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۱۰.۲.۰ ساخته و آزمایش شده است.
نسخه ۳.۰.۰
- افزونه به‌روزرسانی شد تا چارچوب پویای
MaioSDK-v2را برای همه هدف‌های iOS دربرگیرد. - از آداپتور maio Android نسخه 2.0.3.1 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۲.۱.۶.۱ برای iOS پشتیبانی می‌کند.
- با Google Mobile Ads Unity Plugin نسخه ۱۰.۰.۰ ساخته و آزمایش شده است.
نسخه ۲.۰.۴
- از آداپتور maio Android نسخه ۱.۱.۱۶.۳ پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه 2.1.5.1 پشتیبانی می‌کند.
- با نسخه ۹.۳.۰ افزونه Unity تبلیغات تلفن همراه Google ساخته و آزمایش شده است.
نسخه ۲.۰.۳
- از آداپتور maio Android نسخه ۱.۱.۱۶.۳ پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه 2.1.5.0 پشتیبانی می‌کند.
- با «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۹.۱.۰ ساخته و آزمایش شده است.
نسخه ۲.۰.۲
- از آداپتور maio Android نسخه ۱.۱.۱۶.۳ پشتیبانی می‌کند.
- از آداپتور maio نسخه ۲.۱.۴.۰ برای iOS پشتیبانی می‌کند.
- بااستفاده از «افزونه Google Mobile Ads Unity» نسخه ۹.۰.۰ ساخته و آزمایش شده است.
نسخه ۲.۰.۱
- از آداپتور maio Android نسخه 1.1.16.2 پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه 2.1.3.0 پشتیبانی می‌کند.
- بااستفاده از «افزونه Google Mobile Ads Unity» نسخه ۹.۰.۰ ساخته و آزمایش شده است.
نسخه ۲.۰.۰
- از آداپتور maio Android نسخه ۱.۱.۱۶.۲ پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه 2.1.1.0 پشتیبانی می‌کند.
- بااستفاده از «افزونه Google Mobile Ads Unity» نسخه ۸.۶.۰ ساخته و آزمایش شده است.
نسخه ۱.۴.۳
- محتوای آداپتور به
GoogleMobileAds/Mediation/Maio/منتقل شد. - از آداپتور maio Android نسخه 1.1.16.2 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۱.۶.۳.۱ برای iOS پشتیبانی می‌کند.
- بااستفاده از «افزونه Google Mobile Ads Unity» نسخه ۸.۱.۰ ساخته و آزمایش شده است.
نسخه ۱.۴.۲
- از آداپتور maio Android نسخه 1.1.16.1 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۱.۶.۳.۰ برای iOS پشتیبانی می‌کند.
- بااستفاده از «افزونه Google Mobile Ads Unity» نسخه ۷.۴.۰ ساخته و آزمایش شده است.
نسخه ۱.۴.۱
- از آداپتور maio Android نسخه 1.1.16.1 پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه 1.6.2.0 پشتیبانی می‌کند.
- بااستفاده از «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۷.۱.۰ ساخته و آزمایش شده است.
نسخه ۱.۴.۰
- از آداپتور maio Android نسخه 1.1.16.0 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۱.۶.۰.۱ برای iOS پشتیبانی می‌کند.
- با نسخه ۷.۰.۰ «افزونه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۳.۶
- از آداپتور maio Android نسخه 1.1.16.0 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۱.۵.۸.۰ برای iOS پشتیبانی می‌کند.
نسخه ۱.۳.۵
- از آداپتور maio Android نسخه 1.1.15.0 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۱.۵.۶.۱ برای iOS پشتیبانی می‌کند.
نسخه ۱.۳.۴
- از آداپتور maio Android نسخه 1.1.11.1 پشتیبانی می‌کند.
- از نسخه ۱.۵.۴.۰ آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۳.۳
- از آداپتور maio Android نسخه 1.1.11.1 پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه 1.5.3.1 پشتیبانی می‌کند.
نسخه ۱.۳.۲
- از آداپتور maio Android نسخه 1.1.11.0 پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه ۱.۵.۲.۱ پشتیبانی می‌کند.
نسخه ۱.۳.۱
- از آداپتور maio Android نسخه ۱.۱.۱۰.۰ پشتیبانی می‌کند.
- از نسخه ۱.۵.۱.۰ آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۳.۰
- از آداپتور maio Android نسخه ۱.۱.۱۰.۰ پشتیبانی می‌کند.
- از آداپتور maio برای iOS نسخه 1.5.0.0 پشتیبانی می‌کند.
نسخه ۱.۲.۳
- افزونه را برای پشتیبانی از API پاداش‌دار جدید به‌روز کردیم.
- از نسخه ۱.۱.۷.۰ آداپتور maio Android پشتیبانی می‌کند.
- از نسخه 1.4.6.0 آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۲.۲
- از نسخه 1.1.6.0 آداپتور maio Android پشتیبانی می‌کند.
- از آداپتور maio نسخه ۱.۴.۲.۰ برای iOS پشتیبانی می‌کند.
نسخه ۱.۲.۱
- از آداپتور maio Android نسخه 1.1.6.0 پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه ۱.۴.۱.۰ پشتیبانی می‌کند.
نسخه ۱.۲.۰
- از maio Android adapter نسخه ۱.۱.۴.۱ پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه ۱.۴.۰.۰ پشتیبانی می‌کند.
نسخه ۱.۱.۳
- از نسخه 1.1.3.1 آداپتور maio Android پشتیبانی می‌کند.
- از نسخه ۱.۳.۲.۰ آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۱.۲
- از maio Android adapter نسخه ۱.۱.۳.۰ پشتیبانی می‌کند.
- از نسخه ۱.۳.۲.۰ آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۱.۱
- از maio Android adapter نسخه ۱.۱.۱.۰ پشتیبانی می‌کند.
- از نسخه 1.3.1.1 آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۱.۰
- از آداپتور maio Android نسخه 1.1.0.0 پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه ۱.۳.۰.۰ پشتیبانی می‌کند.
نسخه ۱.۰.۲
- از کیت توسعه نرم‌افزار Android نسخه ۱.۰.۸ maio پشتیبانی می‌کند.
- از maio iOS SDK نسخه ۱.۲.۱۹ پشتیبانی می‌کند.
نسخه ۱.۰.۱
- از maio Android SDK نسخه ۱.۰.۷ پشتیبانی می‌کند.
- از maio iOS SDK نسخه ۱.۲.۱۹ پشتیبانی می‌کند.
نسخه ۱.۰.۰
- اولین انتشار!
- از کیت توسعه نرم‌افزار Android نسخه ۱.۰.۶ maio پشتیبانی می‌کند.
- از maio iOS SDK نسخه ۱.۲.۱۸ پشتیبانی می‌کند.