این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از i-mobile با استفاده از میانجیگری استفاده کنید که ادغامهای آبشار را پوشش میدهد. نحوه افزودن i-mobile به پیکربندی میانجی واحد تبلیغات و نحوه ادغام SDK و آداپتور i-mobile در یک برنامه Unity را پوشش می دهد.
رابط داشبورد i-mobile از متن ژاپنی برای برچسبها، دکمهها و توضیحات خود استفاده میکند. اسکرین شات های این راهنما ترجمه نشده اند. با این حال، در توضیحات و دستورالعملهای این راهنما، برچسبها و دکمهها با معادلهای انگلیسی خود در پرانتز ترجمه شدهاند.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
این Ad Manager آداپتور میانجی برای i-mobile دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | |
آبشار | |
فرمت ها | |
بنر | |
بینابینی | |
پاداش داده شد |
الزامات
- یونیتی 5.6 یا بالاتر
- جدیدترین SDK تبلیغات موبایل گوگل
- برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در i-mobile UI تنظیم کنید
مرحله 2: تقاضای i-mobile را در آن تنظیم کنید Ad Manager UI
مرحله 3: i-mobile SDK و آداپتور را وارد کنید
OpenUPM-CLI
اگر OpenUPM-CLI را نصب کردهاید، میتوانید با اجرای دستور زیر از دایرکتوری ریشه پروژه خود، پلاگین میانجیگری i-mobile Ads Google Mobile برای Unity را در پروژه خود نصب کنید:
openupm add com.google.ads.mobile.mediation.imobile
OpenUPM
در ویرایشگر پروژه 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 > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تفکیک وابستگی را از ابتدا انجام می دهد و وابستگی های اعلام شده را در فهرست Assets/Plugins/Android
برنامه Unity شما کپی می کند.
مرحله 4: کد اضافی مورد نیاز است
اندروید
هیچ کد اضافی مورد نیاز برای ادغام i-mobile نیست.
iOS
ادغام SKAdNetwork
برای افزودن شناسه های SKAdNetwork به فایل Info.plist
پروژه خود ، مستندات i-mobile را دنبال کنید.
مرحله 5: اجرای خود را آزمایش کنید
کدهای خطا
اگر آداپتور نتواند تبلیغی را از 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 پیکربندی شده در Ad Manager رابط کاربری موجود نیست/نامعتبر است. |
103 | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از i-mobile مطابقت ندارد. |
104 | پاسخ به تماس موفقیت آمیز بارگیری آگهی بومی i-mobile یک لیست تبلیغات بومی خالی را برگرداند. |
iOS
کد خطا | دلیل |
---|---|
0-10 | i-mobile SDK یک خطا را نشان داد. برای جزئیات بیشتر به کد مراجعه کنید. |
101 | پارامترهای سرور i-mobile پیکربندی شده در Ad Manager رابط کاربری موجود نیست/نامعتبر است. |
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 پشتیبانی می کند.