این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads Flutter Plugin برای بار کردن و نمایش دادن آگهی‌های i-mobile بااستفاده از میانجی‌گری، که شامل ادغام‌های آبشاری می‌شود، استفاده کنید. این راهنما نحوه افزودن i-mobile به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کردن کیت توسعه نرم‌افزار و آداپتور i-mobile در برنامه 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 SDK و آداپتور در فایل 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
اسناد i-mobile را دنبال کنید
تا شناسه‌های SKAdNetwork را به فایل Info.plist پروژه‌تان اضافه کنید.
مرحله ۵: آزمایش پیاده‌سازی
فعال کردن آگهی‌های آزمایشی
مطمئن شوید دستگاه آزمایشی‌تان را برای 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 UI وجود ندارد یا نامعتبر است. |
| 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
نسخه ۱.۰.۶
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۵ پشتیبانی می‌کند.
- از آداپتور i-mobile iOS نسخه ۲.۳.۴.۸ پشتیبانی می‌کند.
- بااستفاده از نسخه 9.1.0 «افزونه Flutter تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.
نسخه ۱.۰.۵
- به‌روزرسانی‌شده برای پشتیبانی از نسخه ۹.۱.۰ افزونه Flutter تبلیغات تلفن همراه Google.
- پشتیبانی از Swift Package Manager را اضافه کنید.
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۴ پشتیبانی می‌کند.
- از آداپتور i-mobile iOS نسخه ۲.۳.۴.۸ پشتیبانی می‌کند.
- بااستفاده از نسخه 9.1.0 «افزونه Flutter تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.
نسخه ۱.۰.۴
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۳ پشتیبانی می‌کند.
- از آداپتور i-mobile iOS نسخه ۲.۳.۴.۷ پشتیبانی می‌کند.
- با نسخه ۸.۰.۰ افزونه Flutter برای Google Mobile Ads ساخته و آزمایش شده است.
نسخه ۱.۰.۳
- پایین‌ترین نسخه Flutter به ۳.۳۸.۱ به‌روز شد
- به‌روزرسانی‌شده برای پشتیبانی از نسخه ۸.۰.۰ «افزونه Flutter تبلیغات تلفن همراه Google»
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۳ پشتیبانی می‌کند.
- از آداپتور i-mobile iOS نسخه ۲.۳.۴.۶ پشتیبانی می‌کند.
- با نسخه ۸.۰.۰ افزونه Flutter برای Google Mobile Ads ساخته و آزمایش شده است.
نسخه ۱.۰.۲
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۱ پشتیبانی می‌کند.
- از آداپتور i-mobile iOS نسخه ۲.۳.۴.۳ پشتیبانی می‌کند.
- بااستفاده از نسخه 6.0.0 افزونه Flutter برای Google Mobile Ads ساخته و آزمایش شده است.
نسخه ۱.۰.۱
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۱ پشتیبانی می‌کند.
- از آداپتور i-mobile iOS نسخه ۲.۳.۴.۲ پشتیبانی می‌کند.
- بااستفاده از نسخه 6.0.0 افزونه Flutter برای Google Mobile Ads ساخته و آزمایش شده است.
نسخه ۱.۰.۰
- نسخهٔ پخش اولیه.
- از آداپتور i-mobile Android نسخه ۲.۳.۲.۰ پشتیبانی می‌کند.
- از آداپتور i-mobile iOS نسخه ۲.۳.۴.۱ پشتیبانی می‌کند.
- بااستفاده از نسخه ۵.۳.۱ «افزونه Flutter تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.