این راهنما به شما نشان می‌دهد که چگونه از 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 تنظیم کنید
ثبت نام کنید یا به حساب آی موبایل خود وارد شوید .
با کلیک کردن روی تب (مدیریت سایت/برنامه) و دکمه پلت فرم برنامه خود، برنامه خود را به داشبورد i-mobile اضافه کنید.
اندروید
iOS
فرم را پر کنید و روی دکمه新規登録 (ثبت نام) کلیک کنید.
اندروید
iOS
برای ایجاد یک مکان تبلیغاتی جدید، برنامه خود را در زیر تبサイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.
اندروید
iOS
به تب広告スポット管理 (مدیریت مکان تبلیغات) بروید و روی دکمه新規広告スポット (نقطه تبلیغاتی جدید) کلیک کنید.
سپس، فرم را با ارائه広告スポットサイズ (اندازه آگهی) و سایر جزئیات، پر کنید. سپس، روی دکمه新規登録 (ثبت نام) کلیک کنید.
محل آگهی جدید شما آماده است. برای مشاهده جزئیات ادغام آن، روی دکمهアプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.
به شناسه パブリッシャーشناسه (شناسه ناشر) ، شناسه (شناسه رسانه) و شناسه (شناسه نقطه ای) توجه داشته باشید. بعداً هنگام پیکربندی i-mobile برای میانجیگری در رابط کاربری AdMob به این پارامترها نیاز خواهید داشت.
اندروید
iOS
مرحله 2: تقاضای i-mobile را در آن تنظیم کنید Ad Manager UI
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعمل‌ها، مرحله 2 را در راهنما ببینیداندروید .
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 > 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 پشتیبانی می کند.
این راهنما به شما نشان می‌دهد که چگونه از 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 تنظیم کنید
ثبت نام کنید یا به حساب آی موبایل خود وارد شوید .
با کلیک کردن روی تب (مدیریت سایت/برنامه) و دکمه پلت فرم برنامه خود، برنامه خود را به داشبورد i-mobile اضافه کنید.
اندروید
iOS
فرم را پر کنید و روی دکمه新規登録 (ثبت نام) کلیک کنید.
اندروید
iOS
برای ایجاد یک مکان تبلیغاتی جدید، برنامه خود را در زیر تبサイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.
اندروید
iOS
به تب広告スポット管理 (مدیریت مکان تبلیغات) بروید و روی دکمه新規広告スポット (نقطه تبلیغاتی جدید) کلیک کنید.
سپس، فرم را با ارائه広告スポットサイズ (اندازه آگهی) و سایر جزئیات، پر کنید. سپس، روی دکمه新規登録 (ثبت نام) کلیک کنید.
محل آگهی جدید شما آماده است. برای مشاهده جزئیات ادغام آن، روی دکمهアプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.
به شناسه パブリッシャーشناسه (شناسه ناشر) ، شناسه (شناسه رسانه) و شناسه (شناسه نقطه ای) توجه داشته باشید. بعداً هنگام پیکربندی i-mobile برای میانجیگری در رابط کاربری AdMob به این پارامترها نیاز خواهید داشت.
اندروید
iOS
مرحله 2: تقاضای i-mobile را در آن تنظیم کنید Ad Manager UI
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعمل‌ها، مرحله 2 را در راهنما ببینیداندروید .
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 > 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 پشتیبانی می کند.