این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از i-mobile با استفاده از میانجیگری استفاده کنید که ادغام‌های آبشار را پوشش می‌دهد. نحوه افزودن i-mobile به پیکربندی میانجی واحد تبلیغات و نحوه ادغام SDK و آداپتور i-mobile در یک برنامه Unity را پوشش می دهد.
رابط داشبورد i-mobile از متن ژاپنی برای برچسب‌ها، دکمه‌ها و توضیحات خود استفاده می‌کند. اسکرین شات های این راهنما ترجمه نشده اند. با این حال، در توضیحات و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی خود در پرانتز ترجمه شده‌اند.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
این AdMob آداپتور میانجی برای i-mobile دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | |
| فرمت ها | |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
الزامات
- یونیتی 5.6 یا بالاتر
- جدیدترین SDK تبلیغات موبایل گوگل
- برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در i-mobile UI تنظیم کنید
مرحله 2: تقاضای i-mobile را در آن تنظیم کنید AdMob UI
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعمل‌ها، مرحله 2 را در راهنمایAndroid ببینید.
iOS
برای دستورالعمل‌ها، مرحله 2 را در راهنمایiOS ببینید.
مرحله 3: i-mobile SDK و آداپتور را وارد کنید
OpenUPM-CLI
اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای دستور زیر از دایرکتوری ریشه پروژه خود، پلاگین میانجیگری i-mobile Ads Google Mobile برای Unity را در پروژه خود نصب کنید:
openupm add com.google.ads.mobile.mediation.imobileOpenUPM
در ویرایشگر پروژه 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 i-mobile Mediation را انتخاب کنید و روی Install کلیک کنید.
پکیج یونیتی
آخرین نسخه پلاگین میانجی گری تبلیغات موبایل گوگل برای آی موبایل را از لینک دانلود در Changelog دانلود کنید و GoogleMobileAdsIMobileMediation.unitypackage را از فایل فشرده استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsIMobileMediation.unitypackage را که دانلود کرده اید پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.
سپس، Assets > Play Services Resolver > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه Unity Play Services Resolver تفکیک وابستگی‌ها را از ابتدا انجام می‌دهد و وابستگی‌های اعلام‌شده را در فهرست Assets/Plugins/Android برنامه Unity شما کپی می‌کند.
مرحله 4: کد اضافی مورد نیاز است
اندروید
هیچ کد اضافی مورد نیاز برای ادغام i-mobile نیست.
iOS
ادغام SKAdNetwork
برای افزودن شناسه های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات i-mobile را دنبال کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برایAdMob.i-mobile شناسه نقطه آزمایشی، شناسه رسانه و شناسه ناشر را برای آزمایش فراهم می کند، می توانید آنها را در اینجا بیابید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهی‌های آزمایشی را ازi-mobileدریافت می‌کنید، با استفاده از منبع(های) آگهی i-mobile (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از i-mobile دریافت کند، ناشران می‌توانند با استفاده از ResponseInfo در کلاس‌های زیر، خطای اساسی مربوط به پاسخ آگهی را بررسی کنند:
اندروید
| قالب | نام کلاس |
|---|---|
| بنر | com.google.ads.mediation.imobile.IMobileAdapter |
| بینابینی | com.google.ads.mediation.imobile.IMobileAdapter |
| بومی | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
| قالب | نام کلاس |
|---|---|
| بنر | آداپتور IMobile |
| بینابینی | آداپتور IMobile |
| بومی | GADMediationAdapterIMmobile |
در اینجا کدها و پیام‌های همراهی که توسط آداپتور i-mobile پرتاب می‌شود، در صورت عدم بارگیری آگهی آمده است:
اندروید
| کد خطا | دلیل |
|---|---|
| 0-99 | i-mobile SDK یک خطا را نشان داد. برای جزئیات بیشتر به کد مراجعه کنید. |
| 101 | i-mobile برای بارگیری تبلیغات به یک زمینه Activity نیاز دارد. |
| 102 | پارامترهای سرور i-mobile پیکربندی شده در AdMob رابط کاربری موجود نیست/نامعتبر است. |
| 103 | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از i-mobile مطابقت ندارد. |
| 104 | پاسخ به تماس موفقیت آمیز بارگیری آگهی بومی i-mobile یک لیست تبلیغات بومی خالی را برگرداند. |
iOS
| کد خطا | دلیل |
|---|---|
| 0-10 | i-mobile SDK یک خطا را نشان داد. برای جزئیات بیشتر به کد مراجعه کنید. |
| 101 | پارامترهای سرور i-mobile پیکربندی شده در AdMob رابط کاربری موجود نیست/نامعتبر است. |
| 102 | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از i-mobile مطابقت ندارد. |
| 103 | i-mobile موفق به ارائه آگهی نشد. |
| 104 | i-mobile یک آرایه تبلیغاتی بومی خالی را برگرداند. |
| 105 | i-mobile در دانلود دارایی های تبلیغاتی بومی شکست خورد. |
| 106 | i-mobile از درخواست چندین آگهی بینابینی با استفاده از همان Spot ID پشتیبانی نمی کند. |
i-mobile Unity Mediation Plugin Changelog
نسخه 1.3.5
- از آداپتور اندروید i-mobile نسخه 2.3.2.0 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.3.4.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 1.3.4
- از آداپتور اندروید i-mobile نسخه 2.3.1.2 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.3.4.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.0.0.
نسخه 1.3.3
- از آداپتور اندروید i-mobile نسخه 2.3.1.1 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.3.3.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.0.0.
نسخه 1.3.2
- محتوای آداپتور به
GoogleMobileAds/Mediation/IMobile/منتقل شد. - از آداپتور اندروید i-mobile نسخه 2.3.1.1 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.3.2.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 8.1.0 ساخته و آزمایش شده است.
نسخه 1.3.1
- از آداپتور اندروید i-mobile نسخه 2.3.0.0 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.3.0.1 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 7.4.1 ساخته و آزمایش شده است.
نسخه 1.3.0
- از آداپتور اندروید i-mobile نسخه 2.3.0.0 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.3.0.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 7.3.1 ساخته و آزمایش شده است.
نسخه 1.2.2
- از آداپتور اندروید i-mobile نسخه 2.0.23.1 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.2.0.1 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 7.0.2.
نسخه 1.2.1
- از آداپتور اندروید i-mobile نسخه 2.0.23.0 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.2.0.1 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 7.0.0 ساخته و آزمایش شده است.
نسخه 1.2.0
- از آداپتور اندروید i-mobile نسخه 2.0.23.0 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.2.0.0 پشتیبانی می کند.
نسخه 1.1.0
- از آداپتور اندروید i-mobile نسخه 2.0.22.2 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.1.0.1 پشتیبانی می کند.
نسخه 1.0.2
- از آداپتور اندروید i-mobile نسخه 2.0.22.0 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.0.32.0 پشتیبانی می کند.
نسخه 1.0.1
- از آداپتور اندروید i-mobile نسخه 2.0.21.0 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.0.31.0 پشتیبانی می کند.
نسخه 1.0.0
- اولین انتشار!
- از آداپتور اندروید i-mobile نسخه 2.0.20.1 پشتیبانی می کند.
- از آداپتور i-mobile iOS نسخه 2.0.29.0 پشتیبانی می کند.