ادغام i-mobile با واسطه

این راهنما به شما نشان می‌دهد که چگونه از 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

تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید

اندروید

برای دستورالعمل‌ها، مرحله 2 را در راهنما ببینیداندروید .

iOS

برای دستورالعمل‌ها، مرحله 2 را در راهنما ببینیدiOS .

مرحله 3: i-mobile SDK و آداپتور را وارد کنید

OpenUPM-CLI

مهم: اگر از استفاده از .unitypackage به استفاده از OpenUPM-CLI مهاجرت می‌کنید، باید با حذف همه فایل‌ها از پوشه Assets/GoogleMobileAds/Mediation/IMobile دارایی‌ها را از محل قدیمی حذف نصب کنید.

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای دستور زیر از دایرکتوری ریشه پروژه خود، پلاگین میانجیگری i-mobile Ads Google Mobile برای Unity را در پروژه خود نصب کنید:

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

مهم: اگر از استفاده از .unitypackage به استفاده از OpenUPM مهاجرت می‌کنید، باید با حذف همه فایل‌ها از پوشه Assets/GoogleMobileAds/Mediation/IMobile دارایی‌ها را از مکان قدیمی حذف نصب کنید.

در ویرایشگر پروژه 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: اجرای خود را آزمایش کنید

کدهای خطا

اگر آداپتور نتواند تبلیغی را از 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 پشتیبانی می کند.