این راهنما به شما نشان می دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Pangle با استفاده از میانجیگری و پوشش استفاده کنید. مناقصه ادغام ها نحوه افزودن Pangle به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Pangle SDK و آداپتور را در یک Unity برنامه
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
را Ad Manager آداپتور میانجی برای Pangle دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | 1 |
| فرمت ها | |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
| بینابینی پاداش | |
الزامات
- جدیدترین SDK تبلیغات موبایل گوگل
- یونیتی 5.6 یا بالاتر
- [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی‌شده در مناقصه، از افزونه میانجیگری تبلیغات موبایل Google برای Pangle 2.4.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
- برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک کار Unity پروژه با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در Pangle UI تنظیم کنید
ثبت نام کنید یا به حساب Pangle خود وارد شوید .
یک برنامه جدید اضافه کنید
به تب Applications رفته و روی دکمه Add App کلیک کنید.
سیستم عاملی را که می خواهید برای آن برنامه ایجاد کنید انتخاب کنید و بقیه فرم را پر کنید. سپس، روی ارسال کلیک کنید.
اندروید
iOS
شناسه برنامه برنامه خود را یادداشت کنید.
اندروید
iOS
یک مکان تبلیغاتی ایجاد کنید
هنگامی که برنامه شما ایجاد شد، روی دکمه افزودن کلیک کنید تا مکان تبلیغات شما ایجاد شود.
اندروید
iOS
مناقصه
قالب تبلیغ و نام مکان تبلیغ خود را انتخاب کنید و مناقصه درون برنامه ای را به عنوان نوع قیمت گذاری انتخاب کنید. بقیه فرم را پر کنید و روی ارسال کلیک کنید.
پس از ایجاد آگهی شما، شناسه قرار دادن آگهی را یادداشت کنید.
اندروید
iOS
آبشار
قالب تبلیغ و نام مکان تبلیغ و CPM جهانی خود را به عنوان نوع قیمت گذاری انتخاب کنید. بقیه فرم را پر کنید و روی ارسال کلیک کنید.
پس از ایجاد آگهی شما، شناسه قرار دادن آگهی را یادداشت کنید.
اندروید
iOS
حالت تست را روشن کنید
دستورالعمل‌های Pangle's How to add a Test Ad Guide را در مورد نحوه فعال کردن تبلیغات آزمایشی Pangle دنبال کنید.
مرحله 2: تقاضای Pangle را در آن تنظیم کنید Ad Manager UI
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعمل‌ها، به مرحله 2 در راهنمای Android مراجعه کنید.
iOS
برای دستورالعمل‌ها، مرحله 2 را در راهنمای iOS ببینید.
مرحله 3: Pangle SDK و آداپتور را وارد کنید
OpenUPM-CLI
اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای دستور زیر از دایرکتوری اصلی پروژه، افزونه Google Mobile Ads Pangle Mediation for Unity را در پروژه خود نصب کنید:
openupm add com.google.ads.mobile.mediation.pangleOpenUPM
در ویرایشگر پروژه Unity خود، Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.
در برگه Scoped Registries ، OpenUPM را به عنوان یک رجیستری محدوده با جزئیات زیر اضافه کنید:
- نام:
OpenUPM - آدرس اینترنتی:
https://package.openupm.com - محدوده (ها):
com.google
سپس به مسیر Window > Package Manager بروید تا Unity Package Manager را باز کنید و My Registries را از منوی کشویی انتخاب کنید.
بسته Google Mobile Ads Pangle Mediation را انتخاب کنید و روی Install کلیک کنید.
پکیج یونیتی
آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل برای Pangle را از لینک دانلود در Changelog دانلود کنید و GoogleMobileAdsPangleMediation.unitypackage را از فایل فشرده استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsPangleMediation.unitypackage را که دانلود کرده اید پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.
سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تفکیک وابستگی را از ابتدا انجام می دهد و وابستگی های اعلام شده را در فهرست Assets/Plugins/Android برنامه Unity شما کپی می کند.
مرحله 4: کد مورد نیاز را اضافه کنید
اندروید
هیچ کد اضافی برای ادغام Pangle مورد نیاز نیست.
iOS
ادغام SKAdNetwork
مستندات Pangle را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید و حالت تست را در 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 Unity Mediation Plugin Changelog
نسخه 4.4.2
- از آداپتور Pangle Android نسخه 6.3.0.4.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.3.1.0.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.4.0.
نسخه 4.4.1
- از آداپتور Pangle Android نسخه 6.3.0.4.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.3.0.8.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 9.3.0 ساخته و آزمایش شده است.
نسخه 4.4.0
- از آداپتور Pangle Android نسخه 6.3.0.2.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.3.0.6.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 9.3.0 ساخته و آزمایش شده است.
نسخه 4.3.3
- از آداپتور Pangle Android نسخه 6.2.0.7.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.2.0.9.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.1.
نسخه 4.3.2
- از آداپتور Pangle Android نسخه 6.2.0.6.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.2.0.8.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.
نسخه 4.3.1
- از آداپتور Pangle Android نسخه 6.2.0.5.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.2.0.7.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.
نسخه 4.3.0
- از آداپتور Pangle Android نسخه 6.2.0.4.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.2.0.5.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.
نسخه 4.2.1
- از آداپتور Pangle Android نسخه 6.1.0.7.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.1.0.6.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.
نسخه 4.2.0
-
DummyClientبهPlaceholderClientتغییر نام داد. - از آداپتور Pangle Android نسخه 6.1.0.6.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.1.0.5.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.
نسخه 4.1.0
- از آداپتور Pangle Android نسخه 6.0.0.8.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.1.0.5.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.1.
نسخه 4.0.1
- از آداپتور Pangle Android نسخه 6.0.0.5.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.0.0.6.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 4.0.0
- از آداپتور Pangle Android نسخه 6.0.0.5.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 6.0.0.5.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 3.0.0
- از آداپتور Pangle Android نسخه 6.0.0.3.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 5.9.0.9.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 2.8.1
- از آداپتور Pangle Android نسخه 5.9.0.6.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 5.9.0.8.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 2.8.0
- از آداپتور Pangle Android نسخه 5.9.0.4.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 5.9.0.7.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 2.7.0
- از آداپتور Pangle Android نسخه 5.9.0.2.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 5.8.0.8.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.
نسخه 2.6.0
- از آداپتور Pangle Android نسخه 5.8.0.9.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 5.8.0.8.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.0.0.
نسخه 2.5.0
- از آداپتور Pangle Android نسخه 5.7.0.1.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 5.7.0.7.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 8.6.0 ساخته و آزمایش شده است.
نسخه 2.4.0
- از آداپتور Pangle Android نسخه 5.5.0.9.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 5.5.0.9.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 8.6.0.
نسخه 2.3.0
- از آداپتور Pangle Android نسخه 5.3.0.6.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 5.3.1.2.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 8.4.1 ساخته و آزمایش شده است.
نسخه 2.2.0
- از آداپتور Pangle Android نسخه 5.2.0.6.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 5.2.0.9.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 8.3.0 ساخته و آزمایش شده است.
نسخه 2.1.0
- از آداپتور Pangle Android نسخه 5.1.0.9.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 5.1.1.0.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 8.1.0 ساخته و آزمایش شده است.
نسخه 2.0.0
- محتوای آداپتور به
GoogleMobileAds/Mediation/Pangle/منتقل شد. - فضای نام آداپتور برای استفاده از
GoogleMobileAds.Mediation.Pangleبازسازی شد. - از آداپتور Pangle Android نسخه 5.0.0.7.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 5.0.0.6.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 7.4.1.
نسخه 1.5.1
- از آداپتور Pangle Android نسخه 4.9.0.7.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 4.9.0.8.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 7.4.0 ساخته و آزمایش شده است.
نسخه 1.5.0
- از آداپتور Pangle Android نسخه 4.9.0.6.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 4.9.0.7.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 7.3.1 ساخته و آزمایش شده است.
نسخه 1.4.0
- از آداپتور Pangle Android نسخه 4.8.1.0.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 4.8.1.0.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 7.3.1.
نسخه 1.3.1
- از آداپتور Pangle Android نسخه 4.7.0.6.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 4.7.0.6.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 7.2.0 ساخته و آزمایش شده است.
نسخه 1.3.0
- متدهای زیر را در کلاس
Pangleتغییر نام داد:-
SetGDPR()->SetGDPRConsent() -
SetCCPA()->SetDoNotSell()
-
- از آداپتور Pangle Android نسخه 4.7.0.5.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 4.7.0.5.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 7.2.0 ساخته و آزمایش شده است.
نسخه 1.2.0
- از آداپتور Pangle Android نسخه 4.5.0.6.1 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 4.5.2.8.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 7.1.0.
نسخه 1.1.0
- از آداپتور Pangle Android نسخه 4.5.0.3.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 4.5.1.3.0 پشتیبانی می کند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 7.0.2.
نسخه 1.0.0
- انتشار اولیه!
- از آداپتور Pangle Android نسخه 4.3.0.8.0 پشتیبانی می کند.
- از آداپتور Pangle iOS نسخه 4.3.0.5.0 پشتیبانی می کند.
- با افزونه Google Mobile Ads Unity نسخه 7.0.0 ساخته و آزمایش شده است.