‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

ادغام i-mobile با میانجی‌گری

انتخاب پلاتفرم: Android iOS Unity Flutter Android (قدیمی)

این راهنما نحوه استفاده از Google Mobile Ads Unity Plugin را برای بار کردن و نمایش آگهی‌های i-mobile بااستفاده از واسطه‌گری، پوشش ادغام‌های آبشاری، نشان می‌دهد. این آموزش شامل نحوه افزودن i-mobile به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کردن کیت توسعه نرم‌افزار و آداپتور i-mobile در برنامه Unity است.

میانای داشبورد i-mobile از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و شرح‌های خود استفاده می‌کند. نماگرفت‌های این راهنما ترجمه نشده است. بااین‌حال، در شرح‌ها و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی آن‌ها در پرانتز ترجمه شده‌اند.

یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده

آداپتور میانجی‌گری AdMob برای i-mobile قابلیت‌های زیر را دارد:

یکپارچه‌سازی
پیشنهاد قیمت
آبشار
قالب‌ها
باز کردن برنامه
برنما
بینابینی
پاداش
بینابینی پاداش‌دار
بومی

پیش‌نیازها

قبل‌از ادامه دادن، موارد زیر را درستی‌سنجی کنید:

جدیدترین نسخه Google Mobile Ads Unity Plugin.
نسخه ۵.۶ یا بالاتر از «ویرایشگر Unity».
برای استقرار در Android
- سطح میانای برنامه کاربردی Android 24 یا بالاتر.
برای استقرار در iOS
- هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.
پروژه Unity فعال که با Google Mobile Ads Unity Plugin پیکربندی شده باشد. برای جزئیات بیشتر، راه‌اندازی Google Mobile Ads Unity Plugin را ببینید.
واسطه‌گری AdMob را راه‌اندازی کنید.

مرحله ۱: پیکربندی‌ها را در i-mobile UI راه‌اندازی کنید

در حساب i-mobile خود ثبت‌نام کنید یا وارد سیستم شوید.

با کلیک کردن روی برگه サイト／アプリ管理 (مدیریت سایت/برنامه) و دکمه مربوط به پلاتفرم برنامه، برنامه‌تان را به داشبورد i-mobile اضافه کنید.

Android

iOS

فرم را تکمیل کنید و روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.

Android

iOS

برای ایجاد «جای آگهی» جدید، برنامه خود را در برگه サイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.

Android

iOS

به برگه 広告スポット管理 (مدیریت جای آگهی) پیمایش کنید و روی دکمه 新規広告スポット (جای آگهی جدید) کلیک کنید.

create_ad_spot

سپس با ارائه 広告スポット名 (نام جای آگهی)، 広告スポットサイズ (اندازه جای آگهی)، و جزئیات دیگر، فرم را تکمیل کنید. سپس، روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.

new_ad_spot_form

جای آگهی جدید شما آماده است. برای مشاهده جزئیات یکپارچه‌سازی آن، روی دکمه アプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.

ad_spot_list

パブリッシャーID (شناسه ناشر)، メディアID (شناسه رسانه)، و スポットID (شناسه نقطه) را یادداشت کنید. بعداً هنگام پیکربندی i-mobile برای میانجی‌گری در «میانای کاربر AdMob» به این پارامترها نیاز خواهید داشت.

Android

iOS

به‌روزرسانی app-ads.txt

«فروشندگان مجاز برای برنامه‌ها» app-ads.txt ابتکار IAB Tech Lab است که کمک می‌کند مطمئن شوید فضای آگهی برنامه شما فقط ازطریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از کاهش قابل‌توجه درآمد آگهی، باید فایل app-ads.txt را پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، فایل app-ads.txt را برای برنامه‌تان راه‌اندازی کنید.

برای پیاده‌سازی app-ads.txt برای i-mobile، به پرسشگان آن‌ها مراجعه کنید.

مرحله ۲: راه‌اندازی تقاضای i-mobile در «میانای کاربری AdMob»

پیکربندی تنظیمات واسطه‌گری برای واحد آگهی

Android

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

iOS

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

مرحله ۳: وارد کردن کیت توسعه نرم‌افزار و آداپتور i-mobile

OpenUPM-CLI

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

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

OpenUPM

در ویرایشگر پروژه Unity، ویرایش > تنظیمات پروژه > مدیر بسته را انتخاب کنید تا تنظیمات مدیر بسته Unity باز شود.

در زبانه ثبت‌های محدود، OpenUPM را به‌عنوان ثبت محدود با جزئیات زیر اضافه کنید:

نام: OpenUPM
نشانی وب: https://package.openupm.com
حوزه(ها): com.google

جزئیات OpenUPM

سپس به Window (پنجره) > Package Manager (مدیر بسته) بروید تا Unity Package Manager (مدیر بسته Unity) را باز کنید و My Registries (ثبت‌های من) را از منو کرکره‌ای انتخاب کنید.

ثبت‌های Unity

بسته Google Mobile Ads IMobile Mediation را انتخاب کنید و روی نصب کلیک کنید.

نصب از OpenUPM

بسته Unity

جدیدترین نسخه افزایه میانجی‌گری «تبلیغات تلفن همراه Google» را برای i-mobile از پیوند بارگیری در Changelog بارگیری کنید و GoogleMobileAdsIMobileMediation.unitypackage را از فایل zip استخراج کنید.

در ویرایشگر پروژه Unity، دارایی‌ها > وارد کردن بسته > بسته سفارشی را انتخاب کنید و GoogleMobileAdsIMobileMediation.unitypackage فایل بارگیری‌شده را پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی وارد کردن کلیک کنید.

وارد کردن از Unity

سپس دارایی‌ها > مدیر وابستگی خارجی > حل‌کننده Android > حل اجباری را انتخاب کنید. کتابخانه «مدیر وابستگی خارجی» عمل حل وابستگی را از ابتدا انجام می‌دهد و وابستگی‌های اعلام‌شده را در دایرکتوری Assets/Plugins/Android برنامه Unity شما کپی می‌کند.

حل‌وفصل اجباری

مرحله ۴: کد اضافی لازم است

Android

برای ادغام i-mobile، کد اضافی لازم نیست.

iOS

یکپارچه‌سازی SKAdNetwork

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه، مستندات i-mobile را دنبال کنید.

مرحله ۵: پیاده‌سازی‌تان را آزمایش کنید

فعال کردن آگهی‌های آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده‌اید. ‫i-mobile شناسه نقطه، شناسه رسانه، و شناسه ناشر را برای آزمایش ارائه می‌دهد، می‌توانید آن‌ها را اینجا پیدا کنید.

درستی‌سنجی آگهی‌های آزمایشی

برای تأیید اینکه از i-mobile آگهی‌های آزمایشی دریافت می‌کنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع (های) آگهی i-mobile(آبشاری) فعال کنید.

کدهای خطا

اگر این آداپتور نتواند آگهی را از i-mobile دریافت کند، ناشران می‌توانند خطای زیربنایی را از پاسخ آگهی بااستفاده از ResponseInfo در کلاس‌های زیر بررسی کنند:

Android

قالب	نام کلاس
برنما	com.google.ads.mediation.imobile.IMobileAdapter
بینابینی	com.google.ads.mediation.imobile.IMobileAdapter
بومی	com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

قالب	نام کلاس
برنما	IMobileAdapter
بینابینی	IMobileAdapter
بومی	GADMediationAdapterIMobile

در اینجا کدها و پیام‌های همراهی که توسط آداپتور i-mobile وقتی آگهی بار نمی‌شود ارائه می‌شود آورده شده است:

Android

کد خطا	استدلال
0-99	«کیت توسعه نرم‌افزار i-mobile» خطایی برگرداند. برای جزئیات بیشتر، کد را ببینید.
۱۰۱	‫i-mobile برای بار کردن آگهی‌ها به بافت `Activity` نیاز دارد.
102	پارامترهای سرور i-mobile که در «میانای کاربری AdMob» پیکربندی شده‌اند وجود ندارند یا نامعتبر هستند.
103	اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده i-mobile مطابقت ندارد.
104	کاربرگشتی موفقیت بار آگهی بومی i-mobile فهرست آگهی‌های بومی خالی را برگرداند.

iOS

کد خطا	استدلال
0-10	«کیت توسعه نرم‌افزار i-mobile» خطایی برگرداند. برای جزئیات بیشتر، کد را ببینید.
۱۰۱	پارامترهای سرور i-mobile که در «میانای کاربری AdMob» پیکربندی شده‌اند وجود ندارند یا نامعتبر هستند.
102	اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده i-mobile مطابقت ندارد.
103	‫i-mobile نتوانست آگهی ارائه دهد.
104	‫i-mobile آرایه آگهی بومی خالی برگرداند.
۱۰۵	‫i-mobile دارایی‌های آگهی بومی را بارگیری نکرد.
106	‫i-mobile از درخواست برای چندین آگهی بینابینی بااستفاده از یک «شناسه نقطه» پشتیبانی نمی‌کند.