Pangle را با میانجیگری ادغام کنید

توجه: به مستندات Pangle برای مناطقی که Pangle پشتیبانی می کند، مراجعه کنید.

این راهنما به شما نشان می دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Pangle با استفاده از میانجیگری و پوشش استفاده کنید. هم آبشار و هم مناقصه ادغام ها نحوه افزودن Pangle به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Pangle SDK و آداپتور را در یک Unity برنامه

ادغام ها و قالب های تبلیغاتی پشتیبانی شده

را AdMob آداپتور میانجی برای Pangle دارای قابلیت های زیر است:

یکپارچه سازی
مناقصه
آبشار
فرمت ها
بنر
بینابینی
پاداش داده شد
بینابینی پاداش

الزامات

• جدیدترین 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

کلید 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 در راهنمای Android مراجعه کنید.

iOS

برای دستورالعمل‌ها، مرحله 2 را در راهنمای iOS ببینید.

مرحله 3: Pangle SDK و آداپتور را وارد کنید

توجه: عدم ادغام نسخه‌های سازگار Pangle و Google Mobile Ads SDK ممکن است منجر به مشکلات ساخت شود.

OpenUPM-CLI

مهم: اگر از استفاده از .unitypackage به استفاده از OpenUPM-CLI مهاجرت می‌کنید، باید با حذف همه فایل‌ها از پوشه Assets/GoogleMobileAds/Mediation/Pangle دارایی‌ها را از محل قدیمی حذف نصب کنید.

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای دستور زیر از دایرکتوری اصلی پروژه، افزونه Google Mobile Ads Pangle Mediation for Unity را در پروژه خود نصب کنید:

openupm add com.google.ads.mobile.mediation.pangle

OpenUPM

مهم: اگر از استفاده از .unitypackage به استفاده از OpenUPM مهاجرت می‌کنید، باید با حذف همه فایل‌ها از پوشه Assets/GoogleMobileAds/Mediation/Pangle دارایی‌ها را از محل قدیمی حذف نصب کنید.

در ویرایشگر پروژه 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: اجرای خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید و حالت تست را در Pangle UI فعال کرده اید .

مهم: قبل از انتشار برنامه، حالت تست AdMob و Pangle را غیرفعال کنید.

تبلیغات آزمایشی را تأیید کنید

برای تأیید اینکه آگهی‌های آزمایشی را از 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.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 ساخته و آزمایش شده است.