این راهنما نحوه استفاده از Google Mobile Ads Flutter Plugin را برای بار کردن و نمایش آگهی‌های i-mobile بااستفاده از واسطه‌گری، پوشش ادغام‌های آبشاری، نشان می‌دهد. این راهنما نحوه افزودن i-mobile به پیکربندی میانجی‌گری واحد تبلیغات و نحوه ادغام کردن i-mobile SDK و آداپتور در برنامه Flutter را پوشش می‌دهد.
میانای داشبورد i-mobile از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و شرح‌های خود استفاده می‌کند. نماگرفت‌های این راهنما ترجمه نشده است. بااین‌حال، در شرح‌ها و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی آن‌ها در پرانتز ترجمه شده‌اند.
یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده
کاربر میانجی‌گری Ad Manager برای i-mobile قابلیت‌های زیر را دارد:
| یکپارچه‌سازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالب‌ها | |
| باز کردن برنامه | |
| برنما | |
| بینابینی | |
| پاداش | |
| بینابینی پاداش‌دار | |
| بومی | |
پیش‌نیازها
قبل‌از ادامه دادن، موارد زیر را درستی‌سنجی کنید:
- جدیدترین نسخه Google Mobile Ads Flutter Plugin.
- نسخه چارچوب Flutter ۳.۷.۰ یا بالاتر.
- برای استقرار در Android
- سطح میانای برنامه کاربردی Android 24 یا بالاتر.
- برای استقرار در iOS
- هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.
- پروژه Flutter کاری که با Google Mobile Ads Flutter Plugin پیکربندی شده است. برای جزئیات بیشتر، راه‌اندازی Google Mobile Ads Flutter Plugin را ببینید.
- میانجی‌گری را راه‌اندازی کنید.
مرحله ۱: پیکربندی‌ها را در i-mobile UI راه‌اندازی کنید
در حساب i-mobile خود ثبت‌نام کنید یا وارد سیستم شوید.
با کلیک کردن روی برگه サイト／アプリ管理 (مدیریت سایت/برنامه) و دکمه مربوط به پلاتفرم برنامه، برنامه‌تان را به داشبورد i-mobile اضافه کنید.
Android
iOS
فرم را تکمیل کنید و روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.
Android
iOS
برای ایجاد «جای آگهی» جدید، برنامه خود را در برگه サイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.
Android
iOS
به برگه 広告スポット管理 (مدیریت جای آگهی) پیمایش کنید و روی دکمه 新規広告スポット (جای آگهی جدید) کلیک کنید.
سپس با ارائه 広告スポット名 (نام جای آگهی)، 広告スポットサイズ (اندازه جای آگهی)، و جزئیات دیگر، فرم را تکمیل کنید. سپس، روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.
جای آگهی جدید شما آماده است. برای مشاهده جزئیات یکپارچه‌سازی آن، روی دکمه アプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.
パブリッシャーID (شناسه ناشر)، メディアID (شناسه رسانه)، و スポットID (شناسه نقطه) را یادداشت کنید. بعداً هنگام پیکربندی i-mobile برای میانجی‌گری در «میانای کاربر Ad Manager» به این پارامترها نیاز خواهید داشت.
Android
iOS
به‌روزرسانی app-ads.txt
«فروشندگان مجاز برای برنامه‌ها» app-ads.txt ابتکار IAB Tech Lab است که کمک می‌کند مطمئن شوید
فضای آگهی برنامه شما فقط ازطریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از
کاهش قابل‌توجه درآمد آگهی، باید فایل app-ads.txt را پیاده‌سازی کنید.
اگر قبلاً این کار را انجام نداده‌اید،
فایل app-ads.txt برای Ad Manager ایجاد کنید.
برای پیاده‌سازی app-ads.txt برای i-mobile، به
پرسشگان آن‌ها مراجعه کنید.
مرحله ۲: راه‌اندازی تقاضای i-mobile در «واسط کاربر Ad Manager»
پیکربندی تنظیمات واسطه‌گری برای واحد آگهی
Android
برای دستورالعمل‌ها، مرحله ۲ را در راهنمای Android ببینید.
iOS
برای دستورالعمل‌ها، مرحله ۲ را در راهنمای iOS ببینید.
مرحله ۳: وارد کردن کیت توسعه نرم‌افزار و آداپتور i-mobile
یکپارچه‌سازی ازطریق pub.dev
(فقط Android) مخزن‌های زیر را به فایل build.gradle در
دایرکتوری android پروژه خود اضافه کنید:
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
وابستگی زیر را با جدیدترین نسخه‌های کیت توسعه نرم‌افزار i-mobile و آداپتور در فایل pubspec.yaml بسته خود اضافه کنید:
dependencies:
gma_mediation_imobile: ^1.0.6
یکپارچه‌سازی دستی
جدیدترین نسخه افزایه میانجی‌گری Google Mobile Ads را برای
i-mobile بارگیری کنید،
فایل بارگیری‌شده را استخراج کنید، و پوشه افزایه استخراج‌شده
(و محتوای آن) را به پروژه Flutter خود اضافه کنید. سپس، با افزودن وابستگی زیر، به افزایه در فایل
pubspec.yaml خود ارجاع دهید:
dependencies:
gma_mediation_imobile:
path: path/to/local/package
مرحله ۴: کد اضافی لازم است
Android
برای ادغام i-mobile، کد اضافی لازم نیست.
iOS
یکپارچه‌سازی SKAdNetwork
برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه، مستندات i-mobile را دنبال کنید.
مرحله ۵: پیاده‌سازی‌تان را آزمایش کنید
فعال کردن آگهی‌های آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید. 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 که در «واسط کاربر Ad Manager» پیکربندی شده‌اند وجود ندارند یا نامعتبر هستند. |
| 103 | اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده i-mobile مطابقت ندارد. |
| 104 | کاربرگشتی موفقیت بار آگهی بومی i-mobile فهرست آگهی‌های بومی خالی را برگرداند. |
iOS
| کد خطا | استدلال |
|---|---|
| 0-10 | «کیت توسعه نرم‌افزار i-mobile» خطایی برگرداند. برای جزئیات بیشتر، کد را ببینید. |
| ۱۰۱ | پارامترهای سرور i-mobile که در «واسط کاربر Ad Manager» پیکربندی شده‌اند وجود ندارند یا نامعتبر هستند. |
| 102 | اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده i-mobile مطابقت ندارد. |
| 103 | i-mobile نتوانست آگهی ارائه دهد. |
| 104 | i-mobile آرایه آگهی بومی خالی برگرداند. |
| ۱۰۵ | i-mobile دارایی‌های آگهی بومی را بارگیری نکرد. |
| 106 | i-mobile از درخواست برای چندین آگهی بینابینی بااستفاده از یک «شناسه نقطه» پشتیبانی نمی‌کند. |
تغییر گزارش آداپتور میانجی‌گری i-mobile Flutter
نسخه ۱.۰.۶
- از نسخه ۲.۳.۲.۵ آداپتور Android مربوط به i-mobile پشتیبانی می‌کند.
- از نسخه ۲.۳.۴.۸ آداپتور i-mobile iOS پشتیبانی می‌کند.
- با نسخه 9.1.0 افزایه Google Mobile Ads Flutter ساخته و آزمایش شده است.
نسخه ۱.۰.۵
- برای پشتیبانی از نسخه ۹.۱.۰ «افزایه Google Mobile Ads Flutter» به‌روزرسانی شد.
- پشتیبانی از «مدیر بسته Swift» را اضافه کنید.
- از i-mobile Android adapter version 2.3.2.4 پشتیبانی می‌کند.
- از نسخه ۲.۳.۴.۸ آداپتور i-mobile iOS پشتیبانی می‌کند.
- با نسخه 9.1.0 افزایه Google Mobile Ads Flutter ساخته و آزمایش شده است.
نسخه ۱.۰.۴
- از نسخه ۲.۳.۲.۳ آداپتور Android مربوط به i-mobile پشتیبانی می‌کند.
- از نسخه ۲.۳.۴.۷ آداپتور i-mobile iOS پشتیبانی می‌کند.
- با نسخه ۸.۰.۰ افزایه Google Mobile Ads Flutter ساخته و آزمایش شده است.
نسخه ۱.۰.۳
- حداقل نسخه Flutter به 3.38.1 به‌روز شد
- برای پشتیبانی از نسخه ۸.۰.۰ «افزایه Google Mobile Ads Flutter» به‌روزرسانی شد
- از نسخه ۲.۳.۲.۳ آداپتور Android مربوط به i-mobile پشتیبانی می‌کند.
- از نسخه ۲.۳.۴.۶ آداپتور i-mobile iOS پشتیبانی می‌کند.
- با نسخه ۸.۰.۰ افزایه Google Mobile Ads Flutter ساخته و آزمایش شده است.
نسخه ۱.۰.۲
- از نسخه ۲.۳.۲.۱ آداپتور Android مربوط به i-mobile پشتیبانی می‌کند.
- از نسخه ۲.۳.۴.۳ آداپتور i-mobile iOS پشتیبانی می‌کند.
- با نسخه ۶.۰.۰ «افزایه Google Mobile Ads Flutter» ساخته و آزمایش شده است.
نسخه ۱.۰.۱
- از نسخه ۲.۳.۲.۱ آداپتور Android مربوط به i-mobile پشتیبانی می‌کند.
- از نسخه ۲.۳.۴.۲ آداپتور i-mobile iOS پشتیبانی می‌کند.
- با نسخه ۶.۰.۰ «افزایه Google Mobile Ads Flutter» ساخته و آزمایش شده است.
نسخه ۱.۰.۰
- نسخهٔ پخش اولیه.
- از نسخه ۲.۳.۲.۰ آداپتور Android i-mobile پشتیبانی می‌کند.
- از نسخه ۲.۳.۴.۱ آداپتور i-mobile iOS پشتیبانی می‌کند.
- با نسخه ۵.۳.۱ «افزایه Google Mobile Ads Flutter» ساخته و آزمایش شده است.