این راهنما به شما نشان می‌دهد که چگونه از 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 API سطح ۲۴ یا بالاتر.
- برای استقرار در iOS
- هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.
- پروژه Flutter فعال پیکربندی‌شده با Google Mobile Ads Flutter Plugin. برای جزئیات، راه‌اندازی Google Mobile Ads Flutter Plugin را ببینید.
مرحله ۱: راه‌اندازی پیکربندی‌ها در میانای کاربری i-mobile
در حساب i-mobile خود ثبت‌نام کنید یا وارد سیستم شوید.
با کلیک کردن روی برگه サイト／アプリ管理 (مدیریت سایت/برنامه) و دکمه مربوط به پلاتفرم برنامه، برنامه‌تان را به داشبورد i-mobile اضافه کنید.
Android
iOS
فرم را تکمیل کنید و روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.
Android
iOS
برای ایجاد «جایگاه آگهی» جدید، برنامه‌تان را در برگه サイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.
Android
iOS
به برگه 広告スポット管理 (مدیریت جای آگهی) پیمایش کنید و روی دکمه 新規広告スポット (جای آگهی جدید) کلیک کنید.
سپس با ارائه 広告スポット名 (نام جای آگهی)، 広告スポットサイズ (اندازه جای آگهی)، و جزئیات دیگر، فرم را تکمیل کنید. سپس، روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.
جایگاه آگهی جدیدتان آماده است. برای مشاهده جزئیات یکپارچه‌سازی آن، روی دکمه アプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.
パブリッシャーID (شناسه ناشر)، メディアID (شناسه رسانه)، و スポットID (شناسه نقطه) را یادداشت کنید. بعداً هنگام پیکربندی i-mobile برای میانجی‌گری در میانای کاربری Ad Manager به این پارامترها نیاز خواهید داشت.
Android
iOS
فایل app-ads.txt خود را به‌روز کنید
Authorized Sellers for Apps 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 برای آزمایش، شناسه Spot، شناسه رسانه، و شناسه ناشر آزمایشی ارائه می‌دهد، می‌توانید آن‌ها را اینجا پیدا کنید.
درستی‌سنجی آگهی‌های آزمایشی
برای تأیید اینکه از 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 UI وجود ندارد یا نامعتبر است. |
| 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 «افزونه Flutter تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.
نسخه ۱.۰.۵
- برای پشتیبانی از نسخه ۹.۱.۰ «افزونه Flutter تبلیغات Google در تلفن همراه» به‌روز شد.
- پشتیبانی از «مدیر بسته Swift» را اضافه کنید.
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۴ پشتیبانی می‌کند.
- از آداپتور i-mobile iOS نسخه ۲.۳.۴.۸ پشتیبانی می‌کند.
- با نسخه 9.1.0 افزایه Google Mobile Ads Flutter ساخته و آزمایش شده است.
نسخه ۱.۰.۴
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۳ پشتیبانی می‌کند.
- از آداپتور i-mobile iOS نسخه ۲.۳.۴.۷ پشتیبانی می‌کند.
- با نسخه ۸.۰.۰ افزونه Flutter برای Google Mobile Ads ساخته و آزمایش شده است.
نسخه ۱.۰.۳
- حداقل نسخه Flutter به ۳.۳۸.۱ به‌روز شد
- برای پشتیبانی از نسخه ۸.۰.۰ «افزایه Google Mobile Ads Flutter» به‌روزرسانی شد
- از نسخه ۲.۳.۲.۳ آداپتور Android مربوط به i-mobile پشتیبانی می‌کند.
- از آداپتور i-mobile iOS نسخه ۲.۳.۴.۶ پشتیبانی می‌کند.
- با نسخه ۸.۰.۰ افزایه Google Mobile Ads Flutter ساخته و آزمایش شده است.
نسخه ۱.۰.۲
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۱ پشتیبانی می‌کند.
- از نسخه ۲.۳.۴.۳ آداپتور i-mobile iOS پشتیبانی می‌کند.
- با نسخه ۶.۰.۰ «افزایه Google Mobile Ads Flutter» ساخته و آزمایش شده است.
نسخه ۱.۰.۱
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۱ پشتیبانی می‌کند.
- از آداپتور i-mobile iOS نسخه ۲.۳.۴.۲ پشتیبانی می‌کند.
- با نسخه ۶.۰.۰ «افزایه Google Mobile Ads Flutter» ساخته و آزمایش شده است.
نسخه ۱.۰.۰
- نسخهٔ پخش اولیه.
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۰ پشتیبانی می‌کند.
- از نسخه ۲.۳.۴.۱ آداپتور i-mobile iOS پشتیبانی می‌کند.
- بااستفاده از نسخه ۵.۳.۱ «افزونه Flutter تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.