این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Mintegral با استفاده از میانجیگری استفاده کنید، که هم ادغام آبشار و هم پیشنهاد قیمت را پوشش می‌دهد. نحوه افزودن Mintegral به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Mintegral SDK و آداپتور در یک برنامه Flutter را پوشش می دهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی AdMob برای Mintegral دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | |
| فرمت ها | |
| برنامه باز شود | 1 |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
| بینابینی پاداش | |
| بومی | 2 |
1 ادغام مناقصه و آبشار برای فرمت آگهی باز برنامه در بتای بسته هستند.
2 ادغام مناقصه و آبشار برای قالب تبلیغات بومی در بتا باز هستند.
الزامات
- جدیدترین SDK تبلیغات موبایل گوگل
- فلاتر 3.7.0 یا بالاتر
- [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی شده در مناقصه، از افزونه میانجیگری تبلیغات موبایلی Google برای Mintegral 1.4.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
- برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه Flutter در حال کار که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در Mintegral UI تنظیم کنید
ثبت نام کنید یا به حساب Mintegral خود وارد شوید .
کلید برنامه را پیدا کنید
به برگه تنظیمات برنامه بروید و کلید APP را یادداشت کنید.
یک برنامه جدید اضافه کنید
از تب APP Setting ، روی دکمه Add APP کلیک کنید.
پلتفرم را انتخاب کنید و بقیه فرم را پر کنید. سپس روی ذخیره کلیک کنید.
اندروید
iOS
به شناسه APP برنامه خود توجه داشته باشید.
اندروید
iOS
یک مکان تبلیغاتی ایجاد کنید
هنگامی که برنامه شما ایجاد شد، به برگه Placements & Units بروید و مطابق شکل زیر بر روی دکمه Add Placement کلیک کنید تا محل تبلیغات خود را ایجاد کنید.
اندروید
iOS
نام مکان و قالب آگهی را وارد کنید.
مناقصه
Header Bidding را به عنوان نوع مناقصه انتخاب کنید. بقیه فرم را پر کنید و روی ذخیره کلیک کنید.
آبشار
سنتی را به عنوان نوع مناقصه انتخاب کنید. بقیه فرم را پر کنید و روی ذخیره کلیک کنید.
پس از ایجاد آگهی شما، شناسه قرار دادن را یادداشت کنید.
اندروید
iOS
روی منوی کشویی 1 AD Units کلیک کنید و شناسه واحد AD را یادداشت کنید.
اندروید
iOS
کلید API گزارش Mintegral خود را پیدا کنید
مناقصه
این مرحله برای ادغام پیشنهادها لازم نیست.
آبشار
برای تنظیم شناسه واحد تبلیغات AdMob خود به کلید API گزارش Mintegral نیاز دارید. به Account > API Tools بروید. از آسمان و راز خود یادداشت کنید.
مرحله 2: تقاضای Mintegral را در رابط کاربری AdMob تنظیم کنید
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعمل‌ها، به مرحله 2 در راهنمای Android مراجعه کنید.
iOS
برای دستورالعمل‌ها، مرحله 2 را در راهنمای iOS ببینید.
Mobvista/Mintegral را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید
برای افزودن Mobvista/Mintegral به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.
مرحله 3: Mintegral SDK و آداپتور را وارد کنید
ادغام از طریق pub.dev
وابستگی زیر را با آخرین نسخه های Mintegral SDK و آداپتور در فایل pubspec.yaml بسته خود اضافه کنید:
dependencies:
gma_mediation_mintegral: ^1.0.0
ادغام دستی
آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل را برای Mintegral دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml خود مراجعه کنید:
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
مرحله 4: کد مورد نیاز را اضافه کنید
اندروید
هیچ کد اضافی برای ادغام Mintegral مورد نیاز نیست.
iOS
ادغام SKAdNetwork
مستندات Mintegral را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید.
Mintegral برای دریافت آگهی‌های آزمایشی Mintegral برای بنرها، قالب‌های تبلیغاتی با پاداش و بومی، توصیه می‌کند از کلیدهای برنامه، شناسه‌های برنامه، شناسه‌های مکان و شناسه‌های واحد آگهی ارائه شده در صفحه شناسه آزمون Mintegral استفاده کنید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهی‌های آزمایشی را از Mintegral دریافت می‌کنید، با استفاده از منبع(های) آگهی Mintegral (مناقصه) و Mintegral (آبشار) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از Mintegral دریافت کند، ناشران می‌توانند با استفاده ResponseInfo در کلاس‌های زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:
اندروید
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور Mintegral هنگام بارگیری نشدن آگهی ارسال می‌شوند:
اندروید
| کد خطا | دامنه | دلیل |
|---|---|---|
| 101 | com.google.ads.mediation.mintegral | پارامترهای سرور نامعتبر (مثلاً شناسه برنامه یا شناسه مکان وجود ندارد). |
| 102 | com.google.ads.mediation.mintegral | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده Mintegral مطابقت ندارد. |
| 103 | com.google.ads.mediation.mintegral | پاسخ پیشنهادی موجود نیست یا نامعتبر است. |
| 104 | com.google.ads.mediation.mintegral | Mintegral SDK یک خطای عدم پر کردن را برگرداند. |
iOS
| کد خطا | دامنه | دلیل |
|---|---|---|
| 101 | com.google.mediation.mintegral | پارامترهای سرور نامعتبر (مثلاً شناسه برنامه یا شناسه مکان وجود ندارد). |
| 102 | com.google.mediation.mintegral | Mintegral SDK یک خطای عدم پر کردن را برگرداند. |
| 103 | com.google.mediation.mintegral | Mintegral SDK نتوانست تبلیغی را نشان دهد. |
| 104 | com.google.mediation.mintegral | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده Mintegral مطابقت ندارد. |
تغییرات آداپتور میانجی فلوتر Mintegral
نسخه بعدی
- ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.
1.1.0
- سازگاری تایید شده با آداپتور اندروید Mintegral نسخه 16.8.31.0.
- سازگاری تأیید شده با آداپتور iOS Mintegral نسخه 7.7.1.0.
- با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.
1.0.0
- انتشار اولیه
- سازگاری تایید شده با آداپتور اندروید Mintegral نسخه 16.7.21.0.
- سازگاری تأیید شده با آداپتور iOS Mintegral نسخه 7.6.3.0.
- با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.