این راهنما به شما نشان می دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Pangle با استفاده از میانجیگری و پوشش استفاده کنید. هم آبشار و هم مناقصه ادغام ها نحوه افزودن Pangle به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Pangle SDK و آداپتور را در یک Flutter برنامه
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
را AdMob آداپتور میانجی برای Pangle دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | |
آبشار | |
فرمت ها | |
بنر | |
بینابینی | |
پاداش داده شد | |
بینابینی پاداش | |
بومی |
الزامات
- جدیدترین SDK تبلیغات موبایل گوگل
- فلاتر 3.7.0 یا بالاتر
- برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک کار Flutter پروژه با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در Pangle UI تنظیم کنید
ثبت نام کنید یا به حساب Pangle خود وارد شوید .
یک برنامه جدید اضافه کنید
به تب Applications رفته و روی دکمه Add App کلیک کنید.
سیستم عاملی را که می خواهید برای آن برنامه ایجاد کنید انتخاب کنید و بقیه فرم را پر کنید. سپس روی ارسال کلیک کنید.
اندروید
iOS
شناسه برنامه برنامه خود را یادداشت کنید.
اندروید
iOS
یک مکان تبلیغاتی ایجاد کنید
هنگامی که برنامه شما ایجاد شد، روی دکمه افزودن کلیک کنید تا مکان تبلیغات شما ایجاد شود.
اندروید
iOS
مناقصه
قالب تبلیغ و نام مکان تبلیغ خود را انتخاب کنید و مناقصه درون برنامه ای را به عنوان نوع قیمت گذاری انتخاب کنید. بقیه فرم را پر کنید و روی ارسال کلیک کنید.
پس از ایجاد آگهی شما، شناسه قرار دادن آگهی را یادداشت کنید.
اندروید
iOS
آبشار
قالب تبلیغ و نام مکان تبلیغ و CPM جهانی خود را به عنوان نوع قیمت گذاری انتخاب کنید. بقیه فرم را پر کنید و روی ارسال کلیک کنید.
پس از ایجاد آگهی شما، شناسه قرار دادن آگهی را یادداشت کنید.
اندروید
iOS
کلید API گزارش Pangle را پیدا کنید
مناقصه
این مرحله برای ادغام پیشنهادها لازم نیست.
آبشار
شناسه کاربری در گوشه سمت چپ پایین صفحه را یادداشت کنید.
روی Integrations > SDK & API > Pangle Reporting API 2.0 کلیک کنید. شناسه نقش و کلید امنیتی را یادداشت کنید.
حالت تست را روشن کنید
دستورالعملهای Pangle's How to add a Test Ad Guide را در مورد نحوه فعال کردن تبلیغات آزمایشی Pangle دنبال کنید.
مرحله 2: تقاضای Pangle را در آن تنظیم کنید AdMob UI
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعملها، مرحله 2 را در راهنما ببینیداندروید .
iOS
برای دستورالعملها، مرحله 2 را در راهنما ببینیدiOS .
مرحله 3: Pangle SDK و آداپتور را وارد کنید
ادغام از طریق pub.dev
(فقط اندروید) مخازن زیر را به فایل build.gradle
داخل فهرست android
پروژه خود اضافه کنید:
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
وابستگی زیر را با آخرین نسخه های آن اضافه کنیدPangle SDK و آداپتور در فایل pubspec.yaml
بسته شما:
dependencies:
gma_mediation_pangle: ^1.0.0
ادغام دستی
دانلود آخرین نسخه افزونه میانجی تبلیغات موبایل گوگل برایPangle ، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه فلاتر خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml
خود مراجعه کنید:
dependencies:
gma_mediation_pangle:
path: path/to/local/package
ادغام از طریق pub.dev
(فقط اندروید) مخازن زیر را به فایل build.gradle
داخل فهرست android
پروژه خود اضافه کنید:
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
وابستگی زیر را با آخرین نسخه های آن اضافه کنیدPangle SDK و آداپتور در فایل pubspec.yaml
بسته شما:
dependencies:
gma_mediation_pangle: ^1.0.0
ادغام دستی
دانلود آخرین نسخه افزونه میانجی تبلیغات موبایل گوگل برایPangle ، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه فلاتر خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml
خود مراجعه کنید:
dependencies:
gma_mediation_pangle:
path: path/to/local/package
مرحله 4: کد مورد نیاز را اضافه کنید
اندروید
هیچ کد اضافی برای ادغام Pangle مورد نیاز نیست.
iOS
ادغام SKAdNetwork
مستندات Pangle را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist
پروژه خود اضافه کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید و حالت تست را در Pangle UI فعال کرده اید .
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را از Pangle دریافت میکنید، با استفاده از منبع(های) آگهی Pangle (مناقصه) و Pangle (آبشار) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از Pangle دریافت کند، ناشران میتوانند با استفاده ResponseInfo
در کلاسهای زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:
اندروید
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
در اینجا کدها و پیامهای همراهی هستند که توسط آداپتور Pangle هنگام بارگیری نشدن آگهی ارسال میشوند:
اندروید
کد خطا | دامنه | دلیل |
---|---|---|
101 | com.google.ads.mediation.pangle | پارامترهای سرور نامعتبر (مثلاً شناسه برنامه یا شناسه مکان وجود ندارد). |
102 | com.google.ads.mediation.pangle | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از Pangle مطابقت ندارد. |
103 | com.google.ads.mediation.pangle | پاسخ پیشنهادی موجود نیست یا نامعتبر است. |
-1-60000 | com.pangle.ads | Pangle SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Pangle مراجعه کنید. |
iOS
کد خطا | دامنه | دلیل |
---|---|---|
101 | com.google.ads.mediation.pangle | پارامترهای سرور نامعتبر (مثلاً شناسه برنامه یا شناسه مکان وجود ندارد). |
102 | com.google.ads.mediation.pangle | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از Pangle مطابقت ندارد. |
-1-60000 | ارسال شده توسط Pangle SDK | Pangle SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Pangle مراجعه کنید. |
تغییرات آداپتور Pangle Flutter Mediation
نسخه بعدی
- ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.
2.0.0
- سازگاری تأیید شده با آداپتور Pangle Android نسخه 6.1.0.9.0.
- سازگاری تأیید شده با آداپتور Pangle iOS نسخه 6.2.0.5.0.
- با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.
1.1.0
- سازگاری تأیید شده با آداپتور Pangle Android نسخه 5.9.0.4.0.
- سازگاری تأیید شده با آداپتور Pangle iOS نسخه 5.9.0.7.0.
- با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.
1.0.0
- انتشار اولیه
- سازگاری تأیید شده با آداپتور Pangle Android نسخه 5.8.0.9.0
- سازگاری تأیید شده با آداپتور Pangle iOS نسخه 5.8.0.8.0
- با افزونه Flutter Ads Google Mobile نسخه 5.0.0 ساخته و آزمایش شده است.