این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از PubMatic با استفاده از میانجیگری استفاده کنید که ادغام‌های مناقصه را پوشش می‌دهد. نحوه افزودن PubMatic به پیکربندی میانجی واحد تبلیغات و نحوه ادغام PubMatic و آداپتور در یک برنامه iOS را پوشش می دهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای PubMatic دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | |
| فرمت ها | |
| برنامه باز شد | |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
| بینابینی پاداش | |
| بومی | |
الزامات
- هدف استقرار iOS 12.0 یا بالاتر
جدیدترین SDK تبلیغات موبایل گوگل.
راهنمای شروع میانجیگری را کامل کنید.
مرحله 1: تنظیمات را در PubMatic UI تنظیم کنید
وارد حساب PubMatic خود شوید و کارت OpenWrap SDK را انتخاب کنید.
یک برنامه جدید اضافه کنید
به تب Apps بروید و روی دکمه Add App کلیک کنید.
پلتفرم و همچنین URL فروشگاه App و نام برنامه را برای برنامه خود انتخاب کنید.
در قسمت Integration Path ، iOS (Objective-C / Swift) را انتخاب کنید و AdMob - SDK Bidding را به عنوان مسیر ادغام فرعی انتخاب کنید. سپس روی دکمه Add App کلیک کنید.
app-ads.txt خود را به روز کنید
فروشندگان مجاز برای برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا مطمئن شوید موجودی آگهی‌های برنامه شما فقط از طریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از ضرر قابل توجه در درآمد تبلیغات، باید فایل app-ads.txt را پیاده سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .
قبل از اینکه برنامه شما نهایی شود، ورودی های مناسب برای افزودن به app-ads.txt به شما ارائه می شود.
برای اطلاعات بیشتر در مورد نحوه اجرای app-ads.txt برای PubMatic، به نحوه پیاده سازی app-ads.txt مراجعه کنید.
شناسه پروفایل
پس از ایجاد برنامه، به برگه برنامه‌ها بروید و شناسه نمایه برنامه جدید ایجاد شده خود را یادداشت کنید.
یک واحد تبلیغاتی ایجاد کنید
در تب Units Ad ، برنامه‌ای را که در بخش قبلی ایجاد کرده‌اید انتخاب کنید و روی دکمه Create Ad Unit کلیک کنید.
فرم را با جزئیات واحد تبلیغاتی خود پر کنید و روی ذخیره کلیک کنید.
شناسه واحد تبلیغات OpenWrap تازه ایجاد شده خود را یادداشت کنید.
شناسه ناشر خود را دریافت کنید
به داشبورد Analytics بروید. نشانگر را روی نماد نمایه نگه دارید و شناسه خود را یادداشت کنید.
مرحله 2: تقاضای PubMatic را در رابط کاربری Ad Manager تنظیم کنید
به حساب Ad Manager خود وارد شوید.
اشتراک گذاری سیگنال ایمن را فعال کنید
به Admin > تنظیمات جهانی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری ایمن سیگنال را بررسی کرده و آن را تغییر دهید. روی ذخیره کلیک کنید.
سیگنال ایمن را در درخواست های پیشنهاد به اشتراک بگذارید
به Inventory > Secure Signals بروید. در قسمت Secure signals ، PubMatic را جستجو کنید و گزینه Enable app integration را فعال کنید.
روی ذخیره کلیک کنید.
اشتراک‌گذاری سیگنال ایمن برای مناقصه SDK مجاز است
به Delivery > تنظیمات کانال درخواستی بروید. در برگه تنظیمات پیش‌فرض ، اجازه دادن به اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK را تغییر دهید.
روی ذخیره کلیک کنید.
مناقصه PubMatic را پیکربندی کنید
به Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
روی مناقصه جدید کلیک کنید.
PubMatic را به عنوان پیشنهاد دهنده انتخاب کنید.
برای فعال کردن پیشنهاد SDK برای این پیشنهاد دهنده، روی Continue کلیک کنید.
روی Done کلیک کنید.
پیکربندی نقشه واحد تبلیغات
به Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
شرکتی را برای PubMatic OpenWrap SDK انتخاب کنید.
به برگه نگاشت واحد آگهی بروید و روی نقشه واحد آگهی جدید کلیک کنید.
واحد تبلیغات خاص را انتخاب کنید. یک واحد تبلیغات و قالب، برنامه موبایل را به عنوان نوع موجودی ، و برنامه تلفن همراه خود را انتخاب کنید. سپس، OpenWrap Unit Ad Unit ID را که در قسمت قبل به دست آمده است وارد کنید.
اگر در حال پیکربندی نگاشت واحد آگهی برای یک آگهی بین‌ستالی پاداش‌دار در رابط کاربری Ad Manager هستید، قالب Rewarded را انتخاب کنید و از شناسه مکان‌یابی بین‌بینی پاداش‌دار استفاده کنید.
در نهایت روی Save کلیک کنید.
PubMatic را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید
برای افزودن PubMatic به فهرست شرکای تبلیغات مقررات ایالتی اروپا و ایالات متحده در رابط کاربری Ad Manager، مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.
مرحله 3: SDK و آداپتور PubMatic را وارد کنید
CocoaPods (توصیه می شود)
خط زیر را به Podfile پروژه خود اضافه کنید:
pod 'GoogleMobileAdsMediationPubMatic'از خط فرمان اجرا کنید:
pod install --repo-update
ادغام دستی
آخرین نسخه PubMatic OpenWrap SDK برای iOS را دانلود کنید و همه فایل‌ها و بسته‌های
.xcframeworkرا در پروژه خود پیوند دهید.آخرین نسخه آداپتور PubMatic را از لینک دانلود در Changelog دانلود کنید و
PubMaticAdapter.xcframeworkرا در پروژه خود پیوند دهید.
مرحله 4: تنظیمات حریم خصوصی را در PubMatic SDK اجرا کنید
برای پیروی از خط‌مشی رضایت کاربر اتحادیه اروپا Google ، باید اطلاعات مشخصی را به کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس ارائه کنید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر فضای ذخیره‌سازی محلی در مواردی که از نظر قانونی لازم است، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات کسب کنید. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع آگهی در زنجیره میانجی شما هستید.
PubMatic به‌طور خودکار رضایت GDPR تنظیم شده توسط پلت‌فرم‌های مدیریت رضایت که از مشخصات رضایت اضافی Google ، از جمله UMP SDK، پشتیبانی می‌کنند، می‌خواند. برای اطلاعات بیشتر، به مجوز GDPR و GDPR مراجعه کنید.
قوانین حفظ حریم خصوصی ایالات متحده
قوانین حفظ حریم خصوصی ایالات ایالات متحده مستلزم اعطای حق انصراف به کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف از طریق پیوند برجسته "اطلاعات شخصی من را نفروشید" در صفحه اصلی طرف "فروشنده" ارائه می شود. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.
PubMatic به‌طور خودکار رضایت GPP تنظیم شده توسط پلت‌فرم‌های مدیریت رضایت را که از مشخصات رضایت اضافی Google ، از جمله UMP SDK، پشتیبانی می‌کنند، می‌خواند. برای اطلاعات بیشتر، به مجوز مجوز GPP مراجعه کنید.
مرحله 5: کد مورد نیاز را اضافه کنید
ادغام SKAdNetwork
مستندات PubMatic را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.
مرحله 6: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهی‌های آزمایشی را از PubMatic OpenWrap SDK دریافت می‌کنید، با استفاده از منبع(های ) آگهی PubMatic (مناقصه ) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
مراحل اختیاری
تبلیغات بومی
رندر آگهی
آداپتور PubMatic تبلیغات بومی خود را به عنوان اشیاء GADNativeAd برمی گرداند. فیلدهای زیر را برای GADNativeAd پر می کند.
| میدان | دارایی ها همیشه توسط آداپتور PubMatic گنجانده شده است |
|---|---|
| تیتر | |
| تصویر | |
| بدن | |
| نماد | |
| فراخوان به اقدام | |
| امتیاز ستاره | |
| فروشگاه | |
| قیمت | |
| تبلیغ کننده |
کدهای خطا
اگر آداپتور نتواند تبلیغی را از PubMatic دریافت کند، می‌توانید با استفاده از GADResponseInfo.adNetworkInfoArray در کلاس‌های زیر، خطای اساسی را از پاسخ آگهی بررسی کنید:
GADMediationAdapterPubMatic
در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور PubMatic هنگام بارگیری نشدن آگهی ارسال می‌شوند:
| کد خطا | دامنه | دلیل |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | پیکربندی سرور فاقد شناسه ناشر مورد نیاز است. |
| 102 | com.google.ads.mediation.pubmatic | درخواست جمع آوری سیگنال مناقصه ناموفق بود زیرا چندین قالب، بدون قالب یا قالب پشتیبانی نشده در پارامترهای درخواست مشخص شده بود. |
| 103 | com.google.ads.mediation.pubmatic | پیکربندی تبلیغ نامعتبر برای بارگیری آگهی. |
| 104 | com.google.ads.mediation.pubmatic | به دلیل آماده نبودن آگهی، تبلیغ بینابینی ارائه نشد. |
| 105 | com.google.ads.mediation.pubmatic | به دلیل آماده نبودن آگهی، تبلیغ با پاداش ارائه نشد. |
| 106 | com.google.ads.mediation.pubmatic | یکی از منابع تصویر تبلیغاتی بومی بارگیری نشد. |
| 1001-5002 | ارسال شده توسط PubMatic SDK | PubMatic SDK یک خطا برگرداند. برای جزئیات بیشتر به مستندات PubMatic مراجعه کنید. |
تغییرات آداپتور میانجیگری PubMatic iOS
نسخه 4.9.0.0
- پشتیبانی از آبشار برای قالب‌های تبلیغاتی بنر، بینابینی، پاداش و بومی اضافه شد.
- رفع اشکالی که در آن نمایندگان تبلیغات بومی به درستی تنظیم نشده بودند.
- یک ویژگی حالت تست را در کلاس
GADMediationAdapterPubMaticExtrasاضافه کنید. - سازگاری تایید شده با PubMatic OpenWrap SDK نسخه 4.9.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.12.0.
- PubMatic OpenWrap SDK نسخه 4.9.0.
نسخه 4.8.1.0
- سازگاری تایید شده با PubMatic OpenWrap SDK نسخه 4.8.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.9.0.
- PubMatic OpenWrap SDK نسخه 4.8.1.
نسخه 4.8.0.0
- سازگاری تایید شده با PubMatic OpenWrap SDK نسخه 4.8.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.8.0.
- PubMatic OpenWrap SDK نسخه 4.8.0.
نسخه 4.7.0.0
- انتشار اولیه
- از مناقصه برای قالب های تبلیغاتی بنر، بینابینی، پاداش و بومی پشتیبانی می کند.
- سازگاری تایید شده با PubMatic OpenWrap SDK نسخه 4.7.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.6.0.
- PubMatic OpenWrap SDK نسخه 4.7.0.