این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

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

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

ادغام
مناقصه
آبشار
فرمت ها
برنامه باز شد	¹
بنر
بینابینی
پاداش داده شد
بینابینی پاداش
بومی

¹ ادغام مناقصه برای این قالب در نسخه بتا بسته است.

الزامات

هدف استقرار iOS 10.0 یا بالاتر

جدیدترین SDK تبلیغات موبایل گوگل
راهنمای شروع میانجیگری را کامل کنید

مرحله 1: تنظیمات را در Pangle UI تنظیم کنید

ثبت نام کنید یا به حساب Pangle خود وارد شوید .

یک برنامه جدید اضافه کنید

به تب Applications رفته و روی دکمه Add App کلیک کنید.

سیستم عاملی را که می خواهید برای آن برنامه ایجاد کنید انتخاب کنید و بقیه فرم را پر کنید. سپس، روی ارسال کلیک کنید.

شناسه برنامه برنامه خود را یادداشت کنید.

یک مکان تبلیغاتی ایجاد کنید

هنگامی که برنامه شما ایجاد شد، روی دکمه افزودن کلیک کنید تا مکان تبلیغات شما ایجاد شود.

مناقصه

قالب تبلیغ و نام مکان تبلیغ خود را انتخاب کنید و مناقصه درون برنامه ای را به عنوان نوع قیمت گذاری انتخاب کنید. بقیه فرم را پر کنید و روی ارسال کلیک کنید.

پس از ایجاد آگهی شما، شناسه قرار دادن آگهی را یادداشت کنید.

آبشار

قالب تبلیغ و نام مکان تبلیغ و CPM جهانی خود را به عنوان نوع قیمت گذاری انتخاب کنید. بقیه فرم را پر کنید و روی ارسال کلیک کنید.

پس از ایجاد آگهی شما، شناسه قرار دادن آگهی را یادداشت کنید.

کلید API گزارش Pangle را پیدا کنید

مناقصه

این مرحله برای ادغام پیشنهادها لازم نیست.

آبشار

شناسه کاربری در گوشه سمت چپ پایین صفحه را یادداشت کنید.

روی Integrations > SDK & API > Pangle Reporting API 2.0 کلیک کنید. شناسه نقش و کلید امنیتی را یادداشت کنید.

حالت تست را روشن کنید

دستورالعمل‌های Pangle's How to add a Test Ad Guide را در مورد نحوه فعال کردن تبلیغات آزمایشی Pangle دنبال کنید.

مرحله 2: تقاضای Pangle را در UI AdMob تنظیم کنید

تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید

باید Pangle به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.

ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر گروه میانجی موجودی دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید، و به افزودن Pangle به عنوان منبع آگهی بروید.

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی Continue کلیک کنید.

به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغاتی موجودAdMob مرتبط کنید. سپس روی Done کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کرده‌اید مشاهده کنید:

Pangle به عنوان منبع آگهی اضافه کنید

مناقصه

در زیر کارت مناقصه در بخش منابع آگهی ، افزودن منبع آگهی را انتخاب کنید. سپس Pangle انتخاب کنید.

روی نحوه امضای قرارداد مشارکت و تنظیم شراکت در مناقصه باPangleکلیک کنید.

روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.

اگر قبلاً نقشه‌ای برای Pangleدارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.

در مرحله بعد، App ID and Ad Placement IDکه در قسمت قبل به دست آمد، وارد کنید. سپس روی Done کلیک کنید.

مهم: App ID باید مانند رابط کاربریPangle با برنامه مورد نظر مرتبط باشد.

در زیر کارت مناقصه در بخش منابع آگهی ، افزودن منبع آگهی را انتخاب کنید. سپس Pangle انتخاب کنید.

روی نحوه امضای قرارداد مشارکت و تنظیم شراکت در مناقصه باPangleکلیک کنید.

روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.

اگر قبلاً نقشه‌ای برای Pangleدارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.

در مرحله بعد، App ID and Ad Placement IDکه در قسمت قبل به دست آمد، وارد کنید. سپس روی Done کلیک کنید.

مهم: App ID باید مانند رابط کاربریPangle با برنامه مورد نظر مرتبط باشد.

آبشار

در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید. سپس Pangle انتخاب کنید.

Pangle را انتخاب کنید.سپس یک مقدار eCPM برایPangle وارد کنید و روی Continue کلیک کنید.

اگر قبلاً نقشه‌ای برای Pangleدارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.

در مرحله بعد، App ID and Ad Placement IDکه در بخش قبل به دست آمد، وارد کنید. سپس روی Done کلیک کنید.

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

استفاده از CocoaPods (توصیه می شود)

خط زیر را به Podfile پروژه خود اضافه کنید:
```
pod 'GoogleMobileAdsMediationPangle'
```
از خط فرمان اجرا کنید:
```
pod install --repo-update
```

ادغام دستی

آخرین نسخه Pangle SDK را برای iOS دانلود کنید و همه فایل‌ها و بسته‌های .framework را در پروژه خود پیوند دهید.
آخرین نسخه آداپتور Pangle را از لینک دانلود در Changelog دانلود کنید و PangleAdapter.xcframework را در پروژه خود پیوند دهید.

مرحله 4: کد مورد نیاز را اضافه کنید

ادغام SKAdNetwork

مستندات Pangle را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.

مرحله 5: اجرای خود را آزمایش کنید

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

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

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

برای تأیید اینکه آگهی‌های آزمایشی را ازPangleدریافت می‌کنید، با استفاده از منبع(های) آگهی Pangle (Bidding) and Pangle (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.

مراحل اختیاری

تبلیغات بومی

رندر آگهی

آداپتور Pangle تبلیغات بومی خود را به عنوان اشیاءGADNativeAdبرمی گرداند. فیلدهایزیر را پر می کندرا برایGADNativeAd .

رشته	دارایی ها همیشه توسط آداپتور Pangle گنجانده شده است
عنوان
تصویر	1
بدن
آیکون
فراخوانی برای اقدام
رتبه بندی ستاره ای
فروشگاه
قیمت
تبلیغ کننده

¹ آداپتور Pangle دسترسی مستقیم به دارایی تصویر اصلی را برای تبلیغات بومی خود فراهم نمی کند. در عوض، آداپتورGADMediaViewرا با یک ویدیو یا یک تصویر پر می کند.

کدهای خطا

اگر آداپتور نتواند تبلیغی را از Pangle دریافت کند، می‌توانید با استفاده ازGADResponseInfo.adNetworkInfoArray تحت کلاس های زیر:

GADMediationAdapterPangle

در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور Pangle هنگام بارگیری نشدن آگهی ارسال می‌شوند:

کد خطا	دامنه	دلیل
101	com.google.ads.mediation.pangle	پارامترهای سرور نامعتبر (مثلاً شناسه برنامه یا شناسه مکان وجود ندارد).
102	com.google.ads.mediation.pangle	اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از Pangle مطابقت ندارد.
-1-60000	ارسال شده توسط Pangle SDK	Pangle SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Pangle مراجعه کنید.

تغییرات آداپتور میانجیگری Pangle iOS

نسخه 5.9.0.7.0

سازگاری تایید شده با Pangle SDK نسخه 5.9.0.7.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 11.3.0.
Pangle SDK نسخه 5.9.0.7.

نسخه 5.8.0.8.0

سازگاری تایید شده با Pangle SDK نسخه 5.8.0.8.
آداپتور به‌روزرسانی شده برای استفاده از API جدید مجموعه سیگنال Pangle SDK.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 11.2.0.
Pangle SDK نسخه 5.8.0.8.

نسخه 5.8.0.7.0

سازگاری تایید شده با Pangle SDK نسخه 5.8.0.7.
اکنون به حداقل نسخه iOS 12.0 نیاز دارد.
اکنون به Google Mobile Ads SDK نسخه 11.0 یا بالاتر نیاز دارد.
شامل Info.plist در چارچوب های موجود در PangleAdapter.xcframework .

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 11.0.1.
Pangle SDK نسخه 5.8.0.7.

نسخه 5.7.0.7.0

سازگاری تایید شده با Pangle SDK نسخه 5.7.0.7.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.14.0.
Pangle SDK نسخه 5.7.0.7.

نسخه 5.7.0.6.0

سازگاری تایید شده با Pangle SDK نسخه 5.7.0.6.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.14.0.
Pangle SDK نسخه 5.7.0.6.

نسخه 5.6.0.8.0

سازگاری تایید شده با Pangle SDK نسخه 5.6.0.8.
با جایگزینی ویژگی منسوخ adConfiguration.childDirectedTreatment با ویژگی جدید GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment ، روش +setCOPPA را مجدداً تغییر داد.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.14.0.
Pangle SDK نسخه 5.6.0.8.

نسخه 5.5.0.9.0

سازگاری تایید شده با Pangle SDK نسخه 5.5.0.9.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.13.0.
Pangle SDK نسخه 5.5.0.9.

نسخه 5.5.0.7.0

سازگاری تایید شده با Pangle SDK نسخه 5.5.0.7.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.12.0.
Pangle SDK نسخه 5.5.0.7.

نسخه 5.5.0.5.0

سازگاری تایید شده با Pangle SDK نسخه 5.5.0.5.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.11.0.
Pangle SDK نسخه 5.5.0.5.

نسخه 5.4.1.1.0

پشتیبانی مناقصه برای قالب تبلیغات باز برنامه اضافه شد.
سازگاری تایید شده با Pangle SDK نسخه 5.4.1.1.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.10.0.
Pangle SDK نسخه 5.4.1.1.

نسخه 5.4.0.9.0

سازگاری تایید شده با Pangle SDK نسخه 5.4.0.9.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.9.0.
Pangle SDK نسخه 5.4.0.9.

نسخه 5.4.0.8.0

مشکلی که در آن GADPangleNetworkExtras با پروتکل GADAdNetworkExtras مطابقت نداشت برطرف شد.
روش پروتکل adDidShowFail را در تبلیغات بینابینی، پاداش و برنامه باز اجرا کرد.
سازگاری تایید شده با Pangle SDK نسخه 5.4.0.8.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.9.0.
Pangle SDK نسخه 5.4.0.8.

نسخه 5.3.1.2.0

سازگاری تایید شده با Pangle SDK نسخه 5.3.1.2.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.8.0.
Pangle SDK نسخه 5.3.1.2.

نسخه 5.3.1.0.0

سازگاری تایید شده با Pangle SDK نسخه 5.3.1.0.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.8.0.
Pangle SDK نسخه 5.3.1.0.

نسخه 5.2.1.1.0

سازگاری تایید شده با Pangle SDK نسخه 5.2.1.1.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.7.0.
Pangle SDK نسخه 5.2.1.1.

نسخه 5.2.0.9.0

سازگاری تایید شده با Pangle SDK نسخه 5.2.0.9.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.5.0.
Pangle SDK نسخه 5.2.0.9.

نسخه 5.2.0.8.0

سازگاری تایید شده با Pangle SDK نسخه 5.2.0.8.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.5.0.
Pangle SDK نسخه 5.2.0.8.

نسخه 5.2.0.7.0

پشتیبانی از آبشار برای باز کردن برنامه، بنر (شامل MREC)، فرمت های تبلیغاتی بینابینی، پاداش و بومی اضافه شد.
سازگاری تایید شده با Pangle SDK نسخه 5.2.0.7.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.5.0.
Pangle SDK نسخه 5.2.0.7.

نسخه 5.2.0.6.0

سازگاری تایید شده با Pangle SDK نسخه 5.2.0.6.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.5.0.
Pangle SDK نسخه 5.2.0.6.

نسخه 5.1.1.0.0

سازگاری تایید شده با Pangle SDK نسخه 5.1.1.0.
پشتیبانی از معماری شبیه ساز arm64 اضافه شده است.
اکنون به Google Mobile Ads SDK نسخه 10.4.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.4.0.
Pangle SDK نسخه 5.1.1.0.

نسخه 5.1.0.6.0

سازگاری تایید شده با Pangle SDK نسخه 5.1.0.6.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.3.0.
Pangle SDK نسخه 5.1.0.6.

نسخه 5.0.1.0.0

سازگاری تایید شده با Pangle SDK نسخه 5.0.1.0.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.2.0.
Pangle SDK نسخه 5.0.1.0.

نسخه 5.0.0.8.0

سازگاری تایید شده با Pangle SDK نسخه 5.0.0.8.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.2.0.
Pangle SDK نسخه 5.0.0.8.

نسخه 5.0.0.7.0

سازگاری تایید شده با Pangle SDK نسخه 5.0.0.7.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.1.0.
Pangle SDK نسخه 5.0.0.7.

نسخه 5.0.0.6.0

سازگاری تایید شده با Pangle SDK نسخه 5.0.0.6.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.1.0.
Pangle SDK نسخه 5.0.0.6.

نسخه 4.9.1.0.0

پشتیبانی از معماری armv7 حذف شد.
سازگاری تایید شده با Pangle SDK نسخه 4.9.1.0.
اکنون به حداقل نسخه iOS 12.0 نیاز دارد.
اکنون به Google Mobile Ads SDK نسخه 10.0.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 10.0.0.
Pangle SDK نسخه 4.9.1.0.

نسخه 4.9.0.8.0

سازگاری تایید شده با Pangle SDK نسخه 4.9.0.8.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 9.14.0.
Pangle SDK نسخه 4.9.0.8.

نسخه 4.9.0.7.0

سازگاری تایید شده با Pangle SDK نسخه 4.9.0.7.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 9.14.0.
Pangle SDK نسخه 4.9.0.7.

نسخه 4.9.0.6.0

سازگاری تایید شده با Pangle SDK نسخه 4.9.0.6.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 9.14.0.
Pangle SDK نسخه 4.9.0.6.

نسخه 4.8.1.0.0

سازگاری تایید شده با Pangle SDK نسخه 4.8.1.0.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 9.14.0.
Pangle SDK نسخه 4.8.1.0.

نسخه 4.8.0.9.0

سازگاری تایید شده با Pangle SDK نسخه 4.8.0.9.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 9.13.0.
Pangle SDK نسخه 4.8.0.9.

نسخه 4.8.0.7.0

سازگاری تایید شده با Pangle SDK نسخه 4.8.0.7.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 9.13.0.
Pangle SDK نسخه 4.8.0.7.

نسخه 4.8.0.6.0

سازگاری تایید شده با Pangle SDK نسخه 4.8.0.6.
رفع مشکلی که در آن رشته اصلی هنگام بارگیری تصویر نماد تبلیغات بومی مسدود شده بود.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 9.13.0.
Pangle SDK نسخه 4.8.0.6.

نسخه 4.7.0.7.0

سازگاری تایید شده با Pangle SDK نسخه 4.7.0.7.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 9.11.0.
Pangle SDK نسخه 4.7.0.7.

نسخه 4.7.0.6.0

سازگاری تایید شده با Pangle SDK نسخه 4.7.0.6.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 9.11.0.
Pangle SDK نسخه 4.7.0.6.

نسخه 4.7.0.5.0

سازگاری تایید شده با Pangle SDK نسخه 4.7.0.5.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 9.11.0.
Pangle SDK نسخه 4.7.0.5.

نسخه 4.7.0.4.0

سازگاری تایید شده با Pangle SDK نسخه 4.7.0.4.

ساخته و تست شده با:

Google Mobile Ads SDK نسخه 9.10.0.
Pangle SDK نسخه 4.7.0.4.

نسخه 4.6.2.2.0

متدهای setGDPR() و setCCPA() را از کلاس GADMediationAdapterPangle به ترتیب به setGDPRConsent() و setDoNotSell تغییر نام داد.
سازگاری تایید شده با Pangle SDK نسخه 4.6.2.2.

ساخته و تست شده با: