این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از maio با استفاده از میانجیگری استفاده کنید که ادغامهای آبشار را پوشش میدهد. نحوه افزودن maio به پیکربندی میانجی واحد تبلیغات و نحوه ادغام maio SDK و آداپتور در یک برنامه Flutter را پوشش می دهد.
رابط داشبورد برای maio از متن ژاپنی برای برچسبها، دکمهها و توضیحات خود استفاده میکند و اسکرینشاتهای این راهنما ترجمه نشدهاند. با این حال، در توضیحات و دستورالعملهای اینجا، برچسبها و دکمهها با معادلهای زبان انگلیسی خود اشاره میکنند. برای مثال، "URL スキーム"، "URL Scheme" است.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای maio دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | |
آبشار | |
فرمت ها | |
بنر | |
بینابینی | |
پاداش داده شد | |
بومی |
الزامات
- جدیدترین SDK تبلیغات موبایل گوگل
- فلاتر 3.7.0 یا بالاتر
- برای استقرار در اندروید
- Android API سطح 23 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه Flutter در حال کار که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در maio UI تنظیم کنید
ابتدا ثبت نام کنید یا وارد حساب کاربری maio خود شوید . روی دکمه مدیریت برنامه در نوار کناری سمت چپ کلیک کنید و روی برنامه جدید کلیک کنید.
برگه مربوط به نوع تبلیغ دلخواه خود را انتخاب کنید.
بینابینی
نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و URL برنامه خود را ارائه دهید. Video interstitial را به عنوان نوع آگهی انتخاب کنید و سپس روی Update کلیک کنید.
اندروید
iOS
پاداش داده شد
نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و URL برنامه خود را ارائه دهید. Video Rewards را به عنوان نوع تبلیغ انتخاب کنید و سپس روی Update کلیک کنید.
اندروید
iOS
در صفحه مدیریت برنامه ، شناسه رسانه را یادداشت کنید. برای راهاندازی واحد تبلیغات AdMob خود در بخش بعدی لازم است.
اندروید
iOS
در صفحه مدیریت منطقه ، شناسه منطقه را یادداشت کنید. همچنین لازم است واحد تبلیغات AdMob خود را در بخش بعدی تنظیم کنید.
اندروید
iOS
مرحله 2: تقاضای maio را در رابط کاربری AdMob تنظیم کنید
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعملها، به مرحله 2 در راهنمای Android مراجعه کنید.
iOS
برای دستورالعملها، مرحله 2 را در راهنمای iOS ببینید.
مرحله 3: maio SDK و آداپتور را وارد کنید
ادغام از طریق pub.dev
وابستگی زیر را با آخرین نسخه maio SDK و آداپتور در فایل pubspec.yaml
بسته خود اضافه کنید:
dependencies:
gma_mediation_maio: ^
ادغام دستی
آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل را برای maio دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml
خود مراجعه کنید:
dependencies:
gma_mediation_maio:
path: path/to/local/package
مرحله 4: کد مورد نیاز را اضافه کنید
اندروید
هیچ کد اضافی برای ادغام maio مورد نیاز نیست.
iOS
ادغام SKAdNetwork
مستندات maio را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist
پروژه خود اضافه کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید.
ناشرانی که از نسخه 7.26.0 یا بالاتر از Google Mobile Ads SDK استفاده میکنند، هنگام درخواست، بهطور خودکار آگهیهای آزمایشی را از maio در تلفنها و رایانههای لوحی ثبتشده بهعنوان دستگاههای آزمایشی دریافت میکنند.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را از maio دریافت میکنید، با استفاده از منبع(های) آگهی maio (آبشار) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از maio دریافت کند، ناشران میتوانند با استفاده از ResponseInfo
در کلاسهای زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:
اندروید
قالب | نام کلاس |
---|---|
بینابینی | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
پاداش داده شد | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
قالب | نام کلاس |
---|---|
بینابینی | GADMMaioInterstitialAdapter |
پاداش داده شد | GADMMaioRewardedAdapter |
در اینجا کدها و پیامهای همراهی هستند که توسط آداپتور maio در هنگام بارگیری یک آگهی ارسال میشوند:
اندروید
کد خطا | دلیل |
---|---|
0-10 | maio یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به اسناد کد و maio مراجعه کنید. |
101 | Maio تبلیغی در دسترس ندارد. |
102 | پارامترهای سرور نامعتبر (به عنوان مثال شناسه مکان وجود ندارد). |
103 | زمینه مورد استفاده برای بارگیری آگهی، نمونه «فعالیت» نبود. |
iOS
کد خطا | دلیل |
---|---|
0-10 | maio یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به کد maio مراجعه کنید. |
101 | maio هنوز تبلیغی در دسترس ندارد. |
102 | پارامترهای سرور نامعتبر (به عنوان مثال شناسه مکان وجود ندارد). |
103 | آداپتور maio از قالب آگهی درخواستی پشتیبانی نمی کند. |
104 | یک آگهی قبلاً برای این پیکربندی شبکه بارگیری شده است. |
تغییرات آداپتور میانجی فلوتر maio
نسخه 1.0.1
- از آداپتور maio اندروید نسخه 2.0.3.1 پشتیبانی می کند.
- از آداپتور maio iOS نسخه 2.1.6.1 پشتیبانی می کند.
- با افزونه Flutter Ads Google Mobile نسخه 6.0.0 ساخته و آزمایش شده است.
نسخه 1.0.0
- انتشار اولیه
- از آداپتور maio اندروید نسخه 2.0.3.0 پشتیبانی می کند.
- از آداپتور maio iOS نسخه 2.1.6.0 پشتیبانی می کند.
- با افزونه Flutter تبلیغات موبایل Google نسخه 5.3.1 ساخته و آزمایش شده است.