این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads Unity Plugin برای بار کردن و نمایش دادن آگهی‌های maio بااستفاده از میانجی‌گری استفاده کنید، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن maio به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کیت توسعه نرم‌افزار و آداپتور maio در برنامه Unity را پوشش می‌دهد.
میانای داشبورد maio از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و شرح‌هایش استفاده می‌کند و نماگرفت‌های این راهنما ترجمه نشده است. بااین‌حال، در شرح‌ها و دستورالعمل‌های اینجا، برچسب‌ها و دکمه‌ها با معادل انگلیسی آن‌ها نام برده می‌شوند. "URL スキーム," for example, is "URL Scheme,".
یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده
آداپتور میانجی‌گری maio قابلیت‌های زیر را دارد:
| یکپارچه‌سازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالب‌ها | |
| صفحه باز شدن برنامه | |
| برنما | |
| بینابینی | |
| پاداش | |
| بینابینی پاداش‌دار | |
| بومی | |
پیش‌نیازها
قبل‌از ادامه دادن، موارد زیر را تأیید کنید:
- جدیدترین نسخه Google Mobile Ads Unity Plugin.
- نسخه ۴ یا بالاتر «ویرایشگر Unity».
- برای استقرار در 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 پشتیبانی می‌کند.
- با نسخه ۱۱.۵.۰ افزونه Unity تبلیغات تلفن همراه Google ساخته و آزمایش شده است.
نسخه ۳.۱.۱۰
- از نسخه 2.0.9.0 آداپتور maio Android پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه ۲.۲.۲.۰ پشتیبانی می‌کند.
- با نسخه 11.4.0 افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه ۳.۱.۹
- از نسخه 2.0.9.0 آداپتور maio Android پشتیبانی می‌کند.
- از نسخه 2.2.1.2.1 سازگار maio iOS پشتیبانی می‌کند.
- بااستفاده از «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۱۱.۳.۰ ساخته و آزمایش شده است.
نسخه ۳.۱.۸
- از آداپتور maio Android نسخه 2.0.8.2 پشتیبانی می‌کند.
- از نسخه 2.2.1.2 سازگار maio iOS پشتیبانی می‌کند.
- با نسخه 11.1.0 افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه ۳.۱.۷
- از نسخه 2.0.8.2 سازگار maio Android پشتیبانی می‌کند.
- از آداپتور maio برای iOS نسخه 2.2.1.1 پشتیبانی می‌کند.
- با نسخه ۱۱.۰.۰ افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه ۳.۱.۶
- از نسخه 2.0.8.1 سازگار maio Android پشتیبانی می‌کند.
- از نسخه 2.2.1.0 آداپتور maio iOS پشتیبانی می‌کند.
- با نسخه ۱۱.۰.۰ افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه ۳.۱.۵
- از آداپتور maio Android نسخه 2.0.8.0 پشتیبانی می‌کند.
- از نسخه ۲.۲.۰.۳ آداپتور maio iOS پشتیبانی می‌کند.
- با نسخه ۱۱.۰.۰ افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه ۳.۱.۴
- از آداپتور maio Android نسخه 2.0.8.0 پشتیبانی می‌کند.
- از آداپتور maio برای iOS نسخه ۲.۲.۰.۱ پشتیبانی می‌کند.
- با نسخه ۱۰.۶.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۳.۱.۳
- از آداپتور maio Android نسخه 2.0.7.0 پشتیبانی می‌کند.
- از نسخه ۲.۲.۰.۱ آداپتور maio iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۶.۰ «افزونه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۳.۱.۲
- از نسخه 2.0.7.0 سازگار maio Android پشتیبانی می‌کند.
- از نسخه ۲.۲.۰.۰ آداپتور maio iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۶.۰ «افزونه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۳.۱.۱
- از نسخه 2.0.6.0 آداپتور maio Android پشتیبانی می‌کند.
- از نسخه ۲.۲.۰.۰ آداپتور maio iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۵.۰ «افزونه Unity تبلیغات Google در تلفن همراه» ساخته و آزمایش شده است.
نسخه ۳.۱.۰
- از نسخه 2.0.5.0 سازگار maio Android پشتیبانی می‌کند.
- از نسخه ۲.۲.۰.۰ آداپتور maio iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۵.۰ «افزونه Unity تبلیغات Google در تلفن همراه» ساخته و آزمایش شده است.
نسخه ۳.۰.۲
- از آداپتور maio Android نسخه 2.0.5.0 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۲.۱.۶.۱ برای iOS پشتیبانی می‌کند.
- بااستفاده از «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۱۰.۲.۰ ساخته و آزمایش شده است.
نسخه ۳.۰.۱
- از آداپتور maio Android نسخه 2.0.4.0 پشتیبانی می‌کند.
- از نسخه ۲.۱.۶.۱ آداپتور maio iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۲.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۳.۰.۰
- افزونه به‌روزرسانی شد تا چارچوب پویای
MaioSDK-v2را برای همه هدف‌های iOS دربرگیرد. - از نسخه 2.0.3.1 سازگار maio Android پشتیبانی می‌کند.
- از نسخه ۲.۱.۶.۱ آداپتور maio iOS پشتیبانی می‌کند.
- با Google Mobile Ads Unity Plugin نسخه ۱۰.۰.۰ ساخته و آزمایش شده است.
نسخه ۲.۰.۴
- از آداپتور maio Android نسخه ۱.۱.۱۶.۳ پشتیبانی می‌کند.
- از نسخه 2.1.5.1 سازگار maio iOS پشتیبانی می‌کند.
- بااستفاده از «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۹.۳.۰ ساخته و آزمایش شده است.
نسخه ۲.۰.۳
- از آداپتور maio Android نسخه ۱.۱.۱۶.۳ پشتیبانی می‌کند.
- از نسخه ۲.۱.۵.۰ آداپتور maio iOS پشتیبانی می‌کند.
- با «افزونه Unity تبلیغات تلفن همراه Google» نسخه ۹.۱.۰ ساخته و آزمایش شده است.
نسخه ۲.۰.۲
- از آداپتور maio Android نسخه ۱.۱.۱۶.۳ پشتیبانی می‌کند.
- از آداپتور maio نسخه ۲.۱.۴.۰ برای iOS پشتیبانی می‌کند.
- با نسخه ۹.۰.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۲.۰.۱
- از نسخه 1.1.16.2 آداپتور maio Android پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه 2.1.3.0 پشتیبانی می‌کند.
- بااستفاده از «افزونه Google Mobile Ads Unity» نسخه ۹.۰.۰ ساخته و آزمایش شده است.
نسخه ۲.۰.۰
- از آداپتور maio Android نسخه 1.1.16.2 پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه 2.1.1.0 پشتیبانی می‌کند.
- بااستفاده از «افزونه Google Mobile Ads Unity» نسخه ۸.۶.۰ ساخته و آزمایش شده است.
نسخه ۱.۴.۳
- محتوای آداپتور به
GoogleMobileAds/Mediation/Maio/منتقل شد. - از آداپتور maio Android نسخه 1.1.16.2 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۱.۶.۳.۱ برای iOS پشتیبانی می‌کند.
- با نسخه 8.1.0 «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۴.۲
- از آداپتور maio Android نسخه 1.1.16.1 پشتیبانی می‌کند.
- از نسخه ۱.۶.۳.۰ آداپتور maio iOS پشتیبانی می‌کند.
- بااستفاده از «افزونه Google Mobile Ads Unity» نسخه ۷.۴.۰ ساخته و آزمایش شده است.
نسخه ۱.۴.۱
- از نسخه 1.1.16.1 آداپتور maio Android پشتیبانی می‌کند.
- از نسخه 1.6.2.0 آداپتور maio iOS پشتیبانی می‌کند.
- با نسخه ۷.۱.۰ «افزونه Unity تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.
نسخه ۱.۴.۰
- از آداپتور maio Android نسخه 1.1.16.0 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۱.۶.۰.۱ برای iOS پشتیبانی می‌کند.
- با نسخه ۷.۰.۰ «افزونه Unity تبلیغات Google برای تلفن همراه» ساخته و آزمایش شده است.
نسخه ۱.۳.۶
- از آداپتور maio Android نسخه 1.1.16.0 پشتیبانی می‌کند.
- از نسخه ۱.۵.۸.۰ آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۳.۵
- از آداپتور maio Android نسخه 1.1.15.0 پشتیبانی می‌کند.
- از آداپتور maio نسخه ۱.۵.۶.۱ برای iOS پشتیبانی می‌کند.
نسخه ۱.۳.۴
- از آداپتور maio Android نسخه 1.1.11.1 پشتیبانی می‌کند.
- از نسخه 1.5.4.0 آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۳.۳
- از نسخه ۱.۱.۱۱.۱ آداپتور maio Android پشتیبانی می‌کند.
- از آداپتور maio برای iOS نسخه 1.5.3.1 پشتیبانی می‌کند.
نسخه ۱.۳.۲
- از آداپتور maio Android نسخه 1.1.11.0 پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه 1.5.2.1 پشتیبانی می‌کند.
نسخه ۱.۳.۱
- از نسخه ۱.۱.۱۰.۰ آداپتور Android مربوط به maio پشتیبانی می‌کند.
- از نسخه ۱.۵.۱.۰ آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۳.۰
- از نسخه ۱.۱.۱۰.۰ آداپتور Android مربوط به maio پشتیبانی می‌کند.
- از آداپتور maio برای iOS نسخه 1.5.0.0 پشتیبانی می‌کند.
نسخه ۱.۲.۳
- افزونه را برای پشتیبانی از API پاداش‌دار جدید به‌روز کردیم.
- از نسخه ۱.۱.۷.۰ آداپتور maio Android پشتیبانی می‌کند.
- از نسخه 1.4.6.0 آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۲.۲
- از آداپتور maio Android نسخه 1.1.6.0 پشتیبانی می‌کند.
- از نسخه 1.4.2.0 آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۲.۱
- از آداپتور maio Android نسخه 1.1.6.0 پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه ۱.۴.۱.۰ پشتیبانی می‌کند.
نسخه ۱.۲.۰
- از نسخه 1.1.4.1 آداپتور maio Android پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه ۱.۴.۰.۰ پشتیبانی می‌کند.
نسخه ۱.۱.۳
- از نسخه 1.1.3.1 آداپتور maio Android پشتیبانی می‌کند.
- از نسخه ۱.۳.۲.۰ آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۱.۲
- از maio Android adapter نسخه ۱.۱.۳.۰ پشتیبانی می‌کند.
- از نسخه ۱.۳.۲.۰ آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۱.۱
- از maio Android adapter نسخه 1.1.1.0 پشتیبانی می‌کند.
- از نسخه 1.3.1.1 آداپتور maio iOS پشتیبانی می‌کند.
نسخه ۱.۱.۰
- از آداپتور maio Android نسخه ۱.۱.۰.۰ پشتیبانی می‌کند.
- از آداپتور maio iOS نسخه ۱.۳.۰.۰ پشتیبانی می‌کند.
نسخه ۱.۰.۲
- از کیت توسعه نرم‌افزار Android نسخه ۱.۰.۸ maio پشتیبانی می‌کند.
- از maio iOS SDK نسخه ۱.۲.۱۹ پشتیبانی می‌کند.
نسخه ۱.۰.۱
- از maio Android SDK نسخه 1.0.7 پشتیبانی می‌کند.
- از نسخه ۱.۲.۱۹ کیت توسعه نرم‌افزار maio iOS پشتیبانی می‌کند.
نسخه ۱.۰.۰
- اولین انتشار!
- از کیت توسعه نرم‌افزار Android نسخه ۱.۰.۶ maio پشتیبانی می‌کند.
- از maio iOS SDK نسخه ۱.۲.۱۸ پشتیبانی می‌کند.