این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگذاری و نمایش تبلیغات از Pangle با استفاده از AdMob Mediation استفاده کنید، که شامل ادغام آبشاری و مناقصهای میشود. این راهنما نحوه اضافه کردن Pangle به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور Pangle در یک برنامه iOS را پوشش میدهد.
آداپتور میانجیگری برای Pangle دارای قابلیتهای زیر است:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | |
| قالبها | |
| برنامه باز است | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
| تبلیغات بینابینی پاداشدار | |
| بومی | |
هدف استقرار iOS 13.0 یا بالاتر
[برای پیشنهاد قیمت]: برای ادغام تمام قالبهای تبلیغاتی پشتیبانیشده در پیشنهاد قیمت، از آداپتور Pangle نسخه ۵.۴.۱.۱.۰ یا بالاتر استفاده کنید ( آخرین نسخه توصیه میشود )
جدیدترین Google Mobile Ads SDK
راهنمای شروع میانجیگری را تکمیل کنید
ثبت نام کنید یا وارد حساب کاربری Pangle خود شوید .
به برگه برنامهها بروید و روی دکمه افزودن برنامه کلیک کنید.
سیستم عاملی را که میخواهید برای آن درخواست ایجاد کنید انتخاب کنید و بقیه فرم را پر کنید. سپس، روی ارسال کلیک کنید.
شناسه برنامه (App ID) خود را یادداشت کنید.
پس از ایجاد برنامه، روی دکمه افزودن کلیک کنید تا جایگاه تبلیغ شما ایجاد شود.
قالب تبلیغ و نام محل قرارگیری تبلیغ خود را انتخاب کنید و در قسمت نوع قیمتگذاری ، پیشنهاد قیمت درونبرنامهای را انتخاب کنید. بقیه فرم را پر کنید و روی ارسال کلیک کنید.
پس از ایجاد جایگاه تبلیغ، شناسه جایگاه تبلیغ را یادداشت کنید.
قالب تبلیغ و نام محل تبلیغ و CPM جهانی را به عنوان نوع قیمتگذاری انتخاب کنید. بقیه فرم را پر کنید و روی ارسال کلیک کنید.
پس از ایجاد جایگاه تبلیغ، شناسه جایگاه تبلیغ را یادداشت کنید.
این مرحله برای ادغامهای پیشنهاد قیمت لازم نیست.
به شناسه کاربری در گوشه پایین سمت چپ صفحه توجه کنید.
روی Integrations > SDK & API > Pangle Reporting API 2.0 کلیک کنید. به شناسه نقش و کلید امنیتی توجه کنید.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .
برای پیادهسازی app-ads.txt برای Pangle، به نحوه اضافه کردن Pangle به فایل app-ads.txt خود مراجعه کنید.
برای فعال کردن تبلیغات آزمایشی Pangle، دستورالعملهای موجود در راهنمای «نحوه اضافه کردن تبلیغ آزمایشی» Pangle را دنبال کنید.
شما باید Pangle را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.
ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که میخواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به مرحله Add Pangle as an ad source بروید.
برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.
قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی ادامه کلیک کنید.
به گروه میانجیگری خود یک نام بدهید و مکانهایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.
این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.
اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کردهاید پر شده است:
در قسمت «منابع تبلیغات» ، زیر کارت پیشنهاد قیمت ، گزینه «افزودن منبع تبلیغات» را انتخاب کنید. سپس «پانگل» را انتخاب کنید.
روی نحوه امضای قرارداد مشارکت و تنظیم مشارکت در مناقصه با Pangle کلیک کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر از قبل نگاشتی برای Pangle دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.
در مرحله بعد، شناسه برنامه و شناسه قرارگیری تبلیغ (Ad Placement ID) که در بخش قبل به دست آوردهاید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.
در زیر کارت Waterfall در بخش Ad Sources ، گزینه Add Ad Source را انتخاب کنید.
Pangle را انتخاب کنید. سپس مقدار eCPM را برای Pangle وارد کنید و روی ادامه کلیک کنید.
اگر از قبل نگاشتی برای Pangle دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.
در مرحله بعد، شناسه برنامه و شناسه قرارگیری تبلیغ (Ad Placement ID) که در بخش قبل به دست آوردهاید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.
برای افزودن Pangle DSP به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
قبل از ادامه، باید حداقل نسخه آداپتور پشتیبانی شده ۷.۶.۰.۶.۰ را داشته باشید.
برای اضافه کردن یک وابستگی پکیج به پروژه خود، مراحل زیر را دنبال کنید:
در Xcode، به مسیر File > Add Package Dependencies... بروید.
در اعلانی که ظاهر میشود، آدرس بستهی زیر را جستجو کنید:
https://github.com/googleads/googleads-mobile-ios-mediation-pangle.gitدر بخش «قانون وابستگی» ، شاخه (Branch) را انتخاب کنید.
در فیلد متن،
mainرا وارد کنید.
خط زیر را به Podfile پروژه خود اضافه کنید:
pod 'GoogleMobileAdsMediationPangle'از خط فرمان اجرا کنید:
pod install --repo-update
- آخرین نسخه Pangle SDK را برای iOS دانلود کنید و تمام فایلهای
.frameworkو بستههای نرمافزاری را در پروژه خود پیوند دهید. - آخرین نسخه آداپتور Pangle را از لینک دانلود موجود در Changelog دانلود کنید و
PangleAdapter.xcframeworkرا در پروژه خود لینک دهید.
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطهگری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکههایی منتقل کند.
با شروع از نسخه ۷.۹.۰.۶ کیت توسعه نرمافزار Pangle، Pangle بهطور خودکار رضایتنامه GDPR تنظیمشده توسط پلتفرمهای مدیریت رضایتنامه که از مشخصات رضایتنامه اضافی گوگل ، از جمله UMP SDK ، پشتیبانی میکنند را میخواند.
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
آداپتور Pangle متد +setPAConsent: را ارائه میدهد که اطلاعات رضایت را به آداپتور Pangle و سپس به Pangle SDK ارسال میکند. کد نمونه زیر نحوه ارسال اطلاعات رضایت به Pangle SDK را نشان میدهد. قبل از مقداردهی اولیه Google Mobile Ads SDK اطلاعات رضایت را تنظیم کنید تا از ارسال صحیح آنها به Pangle SDK اطمینان حاصل شود.
GADMediationAdapterPangle.setPAConsent(PAGPAConsentType.consent.rawValue)
[GADMediationAdapterPangle setPAConsent:PAGPAConsentTypeConsent];
برای جزئیات بیشتر و مقادیری که میتوان در هر روش ارائه داد، به راهنمای ادغام iOS پنگل مراجعه کنید.
برای افزودن شناسههای SKAdNetwork به فایل Info.plist پروژه خود ، مستندات Pangle را دنبال کنید.
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کردهاید و حالت آزمایشی را در Pangle UI فعال کردهاید . برای تأیید اینکه تبلیغات آزمایشی را از Pangle دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های) تبلیغاتی Pangle (Bidding) و Pangle (Waterfall) فعال کنید. آداپتور Pangle تبلیغات بومی خود را به عنوان اشیاء آداپتور Pangle دسترسی مستقیم به تصویر اصلی برای تبلیغات بومی خود را فراهم نمیکند. در عوض، آداپتور اگر آداپتور نتواند تبلیغی از Pangle دریافت کند، میتوانید خطای اساسی را از پاسخ تبلیغ با استفاده از در اینجا کدها و پیامهای همراه که توسط آداپتور Pangle هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آمده است: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با: ساخته و آزمایش شده با:GADNativeAd برمیگرداند. این آداپتور فیلدهای زیر را برای یک GADNativeAd پر میکند. میدان داراییها همیشه توسط آداپتور Pangle گنجانده شدهاند تیتر تصویر ۱ بدن آیکون فراخوان برای اقدام رتبهبندی ستارهای فروشگاه قیمت تبلیغ کننده GADMediaView را با یک ویدیو یا تصویر پر میکند.GADResponseInfo.adNetworkInfoArray تحت کلاسهای زیر بررسی کنید:GADMediationAdapterPangle
کد خطا دامنه دلیل ۱۰۱ com.google.ads.mediation.pangle پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه قرارگیری وجود ندارد). ۱۰۲ com.google.ads.mediation.pangle اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط Pangle مطابقت ندارد. ۱-۶۰۰۰۰ ارسال شده توسط Pangle SDK Pangle SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Pangle مراجعه کنید. 13.0 بهروزرسانی شد.GADMediationAdapterPangle بهروزرسانی شدند:+setCOPPA: حذف شد.+setDoNotSell:(NSInteger) به +setPAConsent:(NSInteger) تغییر یافت.-fobjc-arc و -fstack-protector-all فعال شدند.Info.plist در چارچوبهای موجود در PangleAdapter.xcframework گنجانده شده است.adConfiguration.childDirectedTreatment با ویژگی جدید GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment ، متد +setCOPPA را بازسازی کرد.GADPangleNetworkExtras با پروتکل GADAdNetworkExtras مطابقت نداشته باشد، برطرف شد.adDidShowFail در تبلیغات بینابینی، پاداشی و تبلیغات باز برنامه پیادهسازی شد.arm64 اضافه شد.armv7 حذف شد.setGDPR() و setCCPA() از کلاس GADMediationAdapterPangle را به ترتیب به setGDPRConsent() و setDoNotSell تغییر نام دادیم.didRewardUser بهروزرسانی شد.