این راهنما به شما نشان میدهد که چگونه Google Mobile Ads Flutter Plugin برای بارگذاری و نمایش تبلیغات از Pangle با استفاده از میانجیگری استفاده کنید، که شامل ادغام آبشاری و مناقصهای میشود. این راهنما نحوه اضافه کردن Pangle به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام Pangle SDK و آداپتور در یک برنامه Flutter را پوشش میدهد.
آداپتور میانجیگری AdMob برای Pangle دارای قابلیتهای زیر است:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | |
| قالبها | |
| برنامه باز است | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
| تبلیغات بینابینی پاداشدار | |
| بومی | |
- آخرین Google Mobile Ads Flutter Plugin
- فلاتر ۳.۷.۰ یا بالاتر
- [برای پیشنهاد قیمت]: برای ادغام تمام قالبهای تبلیغاتی پشتیبانیشده در پیشنهاد قیمت، از افزونهی میانجیگری تبلیغات موبایلی گوگل برای Pangle 2.4.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه میشود )
- برای نصب روی اندروید
- اندروید API سطح ۲۳ یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 13.0 یا بالاتر
- یک پروژه Flutter فعال که با Google Mobile Ads Flutter Plugin پیکربندی شده است. برای جزئیات بیشتر به بخش راهاندازی Google Mobile Ads Flutter Plugin مراجعه کنید.
- میانجیگری AdMob را راهاندازی کنید .
ثبت نام کنید یا وارد حساب کاربری 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 را دنبال کنید.
برای دستورالعملها، به مرحله ۲ در راهنمای اندروید مراجعه کنید.
برای دستورالعملها، به مرحله ۲ در راهنمای iOS مراجعه کنید.
برای افزودن Pangle DSP به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
(فقط اندروید) مخازن زیر را به فایل build.gradle در پوشه android پروژه خود اضافه کنید:
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
وابستگی زیر را به همراه آخرین نسخههای Pangle SDK و آداپتور آن در فایل pubspec.yaml پکیج خود اضافه کنید:
dependencies:
gma_mediation_pangle: ^3.5.3
آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای Pangle را دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با اضافه کردن وابستگی زیر، افزونه را در فایل pubspec.yaml خود ارجاع دهید:
dependencies:
gma_mediation_pangle:
path: path/to/local/package
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطهگری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکههایی منتقل کند.
با شروع از افزونه میانجیگری تبلیغات موبایلی گوگل برای Pangle نسخه ۵.۹.۰، Pangle به طور خودکار رضایت GDPR تنظیم شده توسط پلتفرمهای مدیریت رضایت که از مشخصات رضایت اضافی گوگل ، از جمله UMP SDK ، پشتیبانی میکنند را میخواند.
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
افزونه میانجیگری تبلیغات موبایل گوگل برای Pangle شامل متد Pangle.SetPAConsent() است. نمونه کد زیر نحوه ارسال اطلاعات رضایت به Pangle SDK را نشان میدهد. قبل از راهاندازی Google Mobile Ads Flutter Plugin اطلاعات رضایت را تنظیم کنید تا از ارسال صحیح آنها به Pangle SDK اطمینان حاصل شود.
using GoogleMobileAds.Api.Mediation.Pangle;
// ...
Pangle.SetPAConsent(0);
برای جزئیات بیشتر و مقادیری که میتوان در هر روش ارائه داد، به راهنمای ادغام Pangle مراجعه کنید.
هیچ کد اضافی برای ادغام Pangle لازم نیست.
برای افزودن شناسههای SKAdNetwork به فایل Info.plist پروژه خود ، مستندات Pangle را دنبال کنید.
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کردهاید و حالت آزمایشی را در Pangle UI فعال کردهاید . برای تأیید اینکه تبلیغات آزمایشی را از Pangle دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های) تبلیغاتی Pangle (Bidding) و Pangle (Waterfall) فعال کنید. اگر آداپتور نتواند تبلیغی از Pangle دریافت کند، ناشران میتوانند خطای اساسی را از پاسخ تبلیغ با استفاده در اینجا کدها و پیامهای همراه که توسط آداپتور Pangle هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آمده است: ResponseInfo تحت کلاسهای زیر بررسی کنند: com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
GADMediationAdapterPangle
کد خطا دامنه دلیل ۱۰۱ com.google.ads.mediation.pangle پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه قرارگیری وجود ندارد). ۱۰۲ com.google.ads.mediation.pangle اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط Pangle مطابقت ندارد. ۱۰۳ com.google.ads.mediation.pangle پاسخ پیشنهاد نامعتبر یا مفقود است. ۱-۶۰۰۰۰ com.pangle.ads Pangle SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Pangle مراجعه کنید. کد خطا دامنه دلیل ۱۰۱ com.google.ads.mediation.pangle پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه قرارگیری وجود ندارد). ۱۰۲ com.google.ads.mediation.pangle اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط Pangle مطابقت ندارد. ۱-۶۰۰۰۰ ارسال شده توسط Pangle SDK Pangle SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Pangle مراجعه کنید.