این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بار کردن و نمایش آگهیهای PubMatic بااستفاده از میانجیگری استفاده کنید و ادغامهای آبشاری و مناقصه را پوشش میدهد. این راهنما نحوه افزودن PubMatic OpenWrap SDK به پیکربندی میانجیگری واحد آگهی و نحوه ادغام کردن PubMatic OpenWrap SDK و آداپتور در برنامه iOS را پوشش میدهد.
یکپارچهسازیها و قالبهای آگهی پشتیبانیشده
آداپتور میانجیگری برای PubMatic قابلیتهای زیر را دارد:
| یکپارچهسازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | ۱ |
| قالبها | |
| صفحه باز شدن برنامه | |
| برنما | |
| بینابینی | |
| پاداش | |
| بینابینی پاداشدار | |
| بومی | |
۱ یکپارچهسازی آبشاری در نسخه آلفا است.
پیشنیازها
قبلاز ادامه دادن، موارد زیر را تأیید کنید:
- هدف استقرار iOS نسخه ۱۳.۰ یا جدیدتر.
جدیدترین نسخه Google Mobile Ads SDK.
مرحله ۱: راهاندازی پیکربندیها در میانای کاربر PubMatic
در حساب PubMatic خود ثبتنام کنید یا به سیستم وارد شوید و کارت کیت توسعه نرمافزار OpenWrap را انتخاب کنید.
افزودن برنامه جدید
به برگه برنامهها بروید و روی دکمه افزودن برنامه کلیک کنید.
پلاتفرم و همچنین نشانی وب «فروشگاه برنامهها» و نام برنامه را برای برنامه خود انتخاب کنید.
در بخش مسیر یکپارچهسازی، iOS (Objective-C / Swift) را انتخاب کنید و AdMob - پیشنهاد قیمت کیت توسعه نرمافزار را بهعنوان مسیر یکپارچهسازی فرعی انتخاب کنید. سپس روی دکمه افزودن برنامه کلیک کنید.
بهروزرسانی app-ads.txt
«فروشندگان مجاز برای برنامهها» app-ads.txt ابتکار IAB Tech Lab است که کمک میکند مطمئن شوید
فضای آگهی برنامه شما فقط ازطریق کانالهایی که بهعنوان مجاز شناسایی کردهاید فروخته میشود. برای جلوگیری از
کاهش قابلتوجه درآمد آگهی، باید فایل app-ads.txt را پیادهسازی کنید.
اگر قبلاً این کار را انجام ندادهاید،
فایل app-ads.txt برای Ad Manager ایجاد کنید.
قبلاز نهایی شدن برنامهتان، ورودیهای مناسب برای افزودن به app-ads.txt به شما ارائه خواهد شد.
برای کسب اطلاعات بیشتر درباره نحوه پیادهسازی app-ads.txt برای PubMatic،
به نحوه پیادهسازی app-ads.txt مراجعه کنید.
شناسه نمایه
پساز ایجاد برنامه، به برگه برنامهها پیمایش کنید و شناسه نمایه برنامه جدیدتان را یادداشت کنید.
ایجاد واحد آگهی
در برگه واحدهای آگهی، برنامهای را که در بخش قبلی ایجاد کردید انتخاب کنید و روی دکمه ایجاد واحد آگهی کلیک کنید.
فرم را با جزئیات واحد آگهیتان تکمیل کنید و روی ذخیره کلیک کنید.
شناسه واحد آگهی OpenWrap را که بهتازگی ایجاد کردهاید یادداشت کنید.
دریافت شناسه ناشر
به داشبورد Analytics بروید. نشانگر را روی نماد نمایه نگه دارید و شناسه خود را یادداشت کنید.
مرحله ۲: راهاندازی تقاضای PubMatic در «میانای کاربری Ad Manager»
به سیستم حساب Ad Manager خود وارد شوید.
افزودن PubMatic OpenWrap SDK در شرکتها
پیشنهاد قیمت
این مرحله برای ادغامهای پیشنهاد قیمت الزامی نیست.
آبشار
به سرپرست > شرکتها بروید، سپس روی دکمه شرکت جدید در برگه همه شرکتها کلیک کنید. شبکه آگهی را انتخاب کنید.

PubMatic OpenWrap SDK را بهعنوان شبکه آگهی انتخاب کنید، نام یکتایی وارد کنید، و میانجیگری را فعال کنید.
نیازی نیست نام کاربری یا گذرواژه وارد کنید. پساز اتمام روی ذخیره کلیک کنید.

فعال کردن همرسانی سیگنال ایمن
پیشنهاد قیمت
به سرپرست > تنظیمات سراسری پیمایش کنید. به برگه تنظیمات حساب Ad Exchange بروید و همرسانی سیگنال امن را مرور و روشن کنید. روی ذخیره کلیک کنید.

آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
همرسانی نشان امن در درخواستهای پیشنهاد قیمت
پیشنهاد قیمت
به موجودی > سیگنالهای امن پیمایش کنید. در بخش سیگنالهای امن، PubMatic را جستجو کنید و فعال کردن ادغام برنامه را روشن کنید.

روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری الزامی نیست.
اجازه دادن به همرسانی سیگنال امن برای «پیشنهاد قیمت کیت توسعه نرمافزار»
پیشنهاد قیمت
به ارسال > تنظیمات کانال تقاضا پیمایش کنید. در برگه تنظیمات پیشفرض، اجازه همرسانی سیگنال ایمن را برای پیشنهاد قیمت کیت توسعه نرمافزار روشن کنید.

روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
پیکربندی پیشنهاد قیمت PubMatic OpenWrap SDK
پیشنهاد قیمت
به تحویل > پیشنهاددهندگان بروید و روی رفتن به پیشنهاد قیمت کیت توسعه نرمافزار کلیک کنید.

روی پیشنهاددهنده قیمت جدید کلیک کنید.

PubMatic OpenWrap SDK را بهعنوان پیشنهاددهنده قیمت انتخاب کنید.

برای فعال کردن «پیشنهاد قیمت کیت توسعه نرمافزار» برای این پیشنهاددهنده، روی ادامه کلیک کنید.

روی تمام کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری الزامی نیست.
پیکربندی تخصیص واحد آگهی
پیشنهاد قیمت
به تحویل > پیشنهاددهندگان بروید و روی رفتن به پیشنهاد قیمت کیت توسعه نرمافزار کلیک کنید.

شرکت را برای PubMatic OpenWrap SDK انتخاب کنید.

به برگه تخصیص واحد آگهی بروید و روی تخصیص واحد آگهی جدید کلیک کنید.

واحد آگهی خاص را انتخاب کنید. واحد تبلیغات و قالب، برنامه تلفن همراه بهعنوان نوع موجودی، و برنامه تلفن همراه خود را انتخاب کنید. سپس، شناسه واحد آگهی OpenWrap را که در بخش قبلی دریافت کردید وارد کنید.
در آخر، روی ذخیره کردن کلیک کنید.

آبشار
به ارائه > گروههای بازدهی پیمایش کنید و روی دکمه گروه بازدهی جدید کلیک کنید. فضای آگهی و برنامه خود را انتخاب کنید.

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

شرکتی را که در بخش قبلی برای PubMatic OpenWrap SDK ایجاد کردید انتخاب کنید. میانجیگری کیت توسعه نرمافزار تلفن همراه را بهعنوان نوع ادغام، iOS را بهعنوان پلاتفرم، و فعال را بهعنوان وضعیت انتخاب کنید.
شناسه واحد آگهی OpenWrap دریافتشده در بخش قبلی و مقدار «هزارظهوربهای پیشفرض» را وارد کنید. روی ذخیره کلیک کنید.

افزودن PubMatic به فهرست شرکای آگهی «مقررات کلی حفاظت از داده» و مقررات ایالتی ایالات متحده
مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالتهای امریکا را دنبال کنید تا PubMatic را به فهرست شرکای آگهی مقررات اروپا و ایالتهای امریکا در «میانای کاربری Ad Manager» اضافه کنید.
مرحله ۳: وارد کردن کیت توسعه نرمافزار و آداپتور PubMatic OpenWrap
استفاده از Swift Package Manager
قبلاز ادامه دادن، باید حداقل نسخه آداپتور پشتیبانیشده 4.10.0.0 را داشته باشید.
برای افزودن وابستگی بسته به پروژهتان، این مراحل را دنبال کنید:
در Xcode، به File > Add Package Dependencies… پیمایش کنید.
در پیاموارهای که ظاهر میشود، نشانی وب بسته زیر را جستجو کنید:
https://github.com/googleads/googleads-mobile-ios-mediation-pubmatic.gitدر قانون وابستگی، شاخه را انتخاب کنید.
در فیلد نوشتاری،
mainرا وارد کنید.
استفاده از CocoaPods
خط زیر را به Podfile پروژهتان اضافه کنید:
pod 'GoogleMobileAdsMediationPubMatic'از خط فرمان، این دستور را اجرا کنید:
pod install --repo-update
یکپارچهسازی دستی
جدیدترین نسخه PubMatic OpenWrap SDK ویژه iOS را بارگیری کنید و همه فایلها و بستههای
.xcframeworkرا در پروژهتان پیوند دهید.جدیدترین نسخه آداپتور PubMatic را از پیوند بارگیری در Changelog بارگیری کنید و آن را در پروژه خود پیوند دهید
PubMaticAdapter.xcframework.
مرحله ۴: پیادهسازی تنظیمات حریم خصوصی در PubMatic
برای رعایت کردن «خطمشی Google درخصوص موافقت کاربر اتحادیه اروپا»، باید شفافسازیهای خاصی را برای کاربران ساکن منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس انجام دهید و موافقت آنها را برای استفاده از کوکیها یا دیگر فضاهای ذخیرهسازی محلی در جاهایی که قانون الزام میکند، و برای جمعآوری، همرسانی، و استفاده از دادههای شخصی برای شخصیسازی آگهیها کسب کنید. این خطمشی منعکسکننده الزامات «آییننامه حریم خصوصی الکترونیکی اتحادیه اروپا» و «مقررات کلی حفاظت از دادهها» (GDPR) است. شما مسئولید که تأیید کنید رضایت به هر منبع آگهی در زنجیره میانجیگری شما منتقل شده است.
PubMatic بهطور خودکار رضایت با GDPR را که توسط پلاتفرمهای مدیریت رضایت پشتیبانیکننده از مشخصات رضایت تکمیلی Google تنظیم شده است میخواند، ازجمله کیت توسعه نرمافزار UMP. برای اطلاعات بیشتر، گذراندن «مقررات کلی حفاظت از داده» و کسب رضایت «مقررات کلی حفاظت از داده» را ببینید.
قوانین حریم خصوصی ایالتی در ایالات متحده
قوانین حریم خصوصی ایالتهای امریکا ملزم میکند که به کاربران حق انصراف از «فروش» «اطلاعات شخصی» آنها (طبق تعریف قانون از این اصطلاحات) داده شود و این انصراف ازطریق پیوند برجسته «اطلاعات شخصی من فروخته نشود» در صفحه اصلی طرف «فروشنده» ارائه شود. راهنمای رعایت قوانین حریم خصوصی ایالتهای ایالات متحده امکان فعال کردن پردازش محدود دادهها را برای آگهیرسانی Google فراهم میکند، اما Google نمیتواند این تنظیم را برای هر شبکه آگهی در زنجیره میانجیگری شما اعمال کند. بنابراین، باید هریک از شبکههای آگهی را که ممکن است در فروش اطلاعات شخصی مشارکت داشته باشند در زنجیره میانجیگریتان شناسایی کنید و برای اطمینان از رعایت مقررات، از راهنماییهای هریک از آن شبکهها پیروی کنید.
PubMatic بهطور خودکار موافقت GPP را که توسط پلاتفرمهای مدیریت رضایتها تنظیم شده است میخواند. این پلاتفرمها از مشخصات «موافقت تکمیلی» Google پشتیبانی میکنند، ازجمله کیت توسعه نرمافزار UMP. برای اطلاعات بیشتر، به ارسال رضایت GPP مراجعه کنید.
مرحله ۵: افزودن کد الزامی
پیادهسازی SKAdNetwork
برای افزودن شناسههای SKAdNetwork به فایل Info.plist پروژه، مستندات PubMatic
را دنبال کنید.
مرحله ۶: آزمایش پیادهسازی
فعال کردن آگهیهای آزمایشی
مطمئن شوید دستگاه آزمایشی خود را برای Ad Manager ثبت کنید.
درستیسنجی آگهیهای آزمایشی
برای درستیسنجی اینکه آگهیهای آزمایشی را از کیت توسعه نرمافزار PubMatic OpenWrap دریافت میکنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع(های) آگهی PubMatic OpenWrap فعال کنید.
مراحل اختیاری
آگهیهای بومی
پرداز آگهی
آداپتور PubMatic آگهیهای بومی خود را بهصورت
GADNativeAd
شیء برمیگرداند. این فیلدها را برای
GADNativeAd
پر میکند.
| فیلد | داراییهایی که همیشه توسط آداپتور PubMatic اضافه میشود |
|---|---|
| Headline | |
| تصویر | |
| بدن | |
| نماد | |
| دعوت به اقدام | |
| ردهبندی با ستاره | |
| فروشگاه | |
| قیمت | |
| آگهیدهنده |
کدهای خطا
اگر این آداپتور نتواند آگهی را از PubMatic دریافت کند، میتوانید خطای زیرین را از پاسخ آگهی بااستفاده از
GADResponseInfo.adNetworkInfoArray
در کلاسهای زیر بررسی کنید:
GADMediationAdapterPubMatic
در اینجا کدها و پیامهای همراهی که توسط آداپتور PubMatic وقتی آگهی بار نمیشود ارائه میشود آورده شده است:
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱۰۱ | com.google.ads.mediation.pubmatic | پیکربندی سرور فاقد شناسه ناشر الزامی است. |
| 102 | com.google.ads.mediation.pubmatic | درخواست جمعآوری سیگنال پیشنهاد قیمت ناموفق بود زیرا چند قالب، هیچ قالب، یا قالب پشتیبانینشدهای در پارامترهای درخواست مشخص شده بود. |
| 103 | com.google.ads.mediation.pubmatic | پیکربندی آگهی برای بار کردن آگهی نامعتبر است. |
| 104 | com.google.ads.mediation.pubmatic | آگهی بینابینی ارائه نشد چون آگهی آماده نبود. |
| ۱۰۵ | com.google.ads.mediation.pubmatic | آگهی پاداشدار ارائه نشد زیرا آگهی آماده نبود. |
| 106 | com.google.ads.mediation.pubmatic | یکی از منابع تصویر آگهی بومی بار نشد. |
| 107 | com.google.ads.mediation.pubmatic | پیکربندی آگهی فاقد شناسه ناشر است. |
| 108 | com.google.ads.mediation.pubmatic | پیکربندی آگهی فاقد شناسه نمایه است. |
| ۱۰۹ | com.google.ads.mediation.pubmatic | پیکربندی آگهی حاوی شناسه نمایهای غیرعددی است. |
| 110 | com.google.ads.mediation.pubmatic | پیکربندی آگهی فاقد شناسه واحد آگهی است. |
| 111 | com.google.ads.mediation.pubmatic | کیت توسعه نرمافزار PubMatic OpenWrap نتوانست نمونه اندازه آگهی را نمونهسازی کند. |
| 1001-5002 | ارسالشده توسط PubMatic SDK | کیت توسعه نرمافزار PubMatic خطایی برگرداند. برای جزئیات بیشتر، به اسناد PubMatic مراجعه کنید. |
PubMatic iOS Mediation Adapter Changelog
نسخه ۵.۴.۱.۰
- سازگاری با PubMatic OpenWrap SDK نسخه ۵.۴.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۱۰.۰.
- PubMatic OpenWrap SDK نسخه ۵.۴.۱.
نسخه ۵.۴.۰.۰
- سازگاری با نسخه ۵.۴.۰ «کیت توسعه نرمافزار PubMatic OpenWrap» تأیید شد.
ساخته و آزمایششده با:
- نسخه Google Mobile Ads SDK 13.9.0.
- نسخه ۵.۴.۰ کیت توسعه نرمافزار PubMatic OpenWrap.
نسخه ۵.۳.۰.۰
- سازگاری با نسخه ۵.۳.۰ «کیت توسعه نرمافزار PubMatic OpenWrap» تأیید شد.
ساخته و آزمایششده با:
- نسخه 13.8.0 کیت توسعه نرمافزار «آگهیهای تلفن همراه Google».
- نسخه PubMatic OpenWrap SDK 5.3.0.
نسخه ۵.۲.۰.۰
- سازگاری با PubMatic OpenWrap SDK نسخه ۵.۲.۰ تأیید شد.
- اکنون به «کیت توسعه نرمافزار تبلیغات تلفن همراه Google» نسخه
13.6یا بالاتر نیاز دارد. - پشتیبانی از دارایی ویدیویی در آگهیهای بومی بااستفاده از میانای برنامهسازی کاربردی mediaView اضافه شد.
ساخته و آزمایششده با:
- نسخه 13.7.0 کیت توسعه نرمافزار آگهی تلفن همراه Google.
- PubMatic OpenWrap SDK نسخه ۵.۲.۰.
نسخه ۵.۱.۱.۰
- سازگاری با PubMatic OpenWrap SDK نسخه ۵.۱.۱ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۱۳.۴.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- PubMatic OpenWrap SDK نسخه ۵.۱.۱.
نسخه ۵.۱.۰.۱
- اکنون «آداپتور» پرچم «کیت توسعه نرمافزار آگهیهای تلفن همراه Google»
ageRestrictedTreatmentرا به «میانای برنامهسازی کاربردی COPPA کیت توسعه نرمافزار PutMatic OpenWrap» بازارسال میکند.
ساخته و آزمایششده با:
- نسخه ۱۳.۳.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- PubMatic OpenWrap SDK نسخه ۵.۱.۰.
نسخه ۵.۱.۰.۰
- سازگاری با PubMatic OpenWrap SDK نسخه ۵.۱.۰ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۱۳.۳.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۵.۱.۰ کیت توسعه نرمافزار PubMatic OpenWrap.
نسخه 5.0.1.0
- سازگاری با PubMatic OpenWrap SDK نسخه ۵.۰.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۲.۰.
- PubMatic OpenWrap SDK نسخه ۵.۰.۱.
نسخه ۵.۰.۰.۰
- سازگاری با PubMatic OpenWrap SDK نسخه ۵.۰.۰ تأیید شد.
ساخته و آزمایششده با:
- نسخه 13.1.0 کیت توسعه نرمافزار آگهی تلفن همراه Google.
- PubMatic OpenWrap SDK نسخه ۵.۰.۰.
نسخه ۴.۱۲.۰.۰
- سازگاری با PubMatic OpenWrap SDK نسخه ۴.۱۲.۰ تأیید شد.
- وابستگی کیت توسعه نرمافزار تبلیغات تلفن همراه Google به نسخه ۱۳.۰.۰ بهروز شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۰.۰.
- PubMatic OpenWrap SDK نسخه ۴.۱۲.۰.
نسخه ۴.۱۱.۰.۲
- حداقل نسخه iOS برای CocoaPods به
13.0بهروزرسانی شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۰.۰.
- PubMatic OpenWrap SDK نسخه ۴.۱۱.۰.
نسخه 4.11.0.1
- پشتیبانی از بازارسال پارامترهای کیت توسعه نرمافزار Google Mobile Ads
tagForChildDirectedTreatmentوtagForUnderAgeOfConsentبه کیت توسعه نرمافزار PubMatic OpenWrap اضافه شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۱۴.۰.
- نسخه کیت توسعه نرمافزار PubMatic OpenWrap 4.11.0.
نسخه ۴.۱۱.۰.۰
- سازگاری با نسخه ۴.۱۱.۰ «کیت توسعه نرمافزار PubMatic OpenWrap» تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۱۴.۰.
- PubMatic OpenWrap SDK نسخه ۴.۱۱.۰.
نسخه ۴.۱۰.۰.۰
- سازگاری با PubMatic OpenWrap SDK نسخه ۴.۱۰.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۱۲.۰.
- نسخه ۴.۱۰.۰ کیت توسعه نرمافزار PubMatic OpenWrap.
نسخه ۴.۹.۰.۰
- پشتیبانی آبشاری برای قالبهای آگهی بومی، پاداشدار، بینابینی، و برنما اضافه شد.
- اشکالی که در آن نمایندگان آگهی بومی بهدرستی تنظیم نشده بودند برطرف شد.
- یک ویژگی حالت آزمایشی در کلاس
GADMediationAdapterPubMaticExtrasاضافه کنید. - سازگاری با PubMatic OpenWrap SDK نسخه ۴.۹.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۱۲.۰.
- نسخه کیت توسعه نرمافزار PubMatic OpenWrap 4.9.0.
نسخه ۴.۸.۱.۰
- سازگاری با نسخه ۴.۸.۱ «کیت توسعه نرمافزار PubMatic OpenWrap» تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۹.۰.
- PubMatic OpenWrap SDK نسخه ۴.۸.۱.
نسخه ۴.۸.۰.۰
- سازگاری با PubMatic OpenWrap SDK نسخه ۴.۸.۰ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۱۲.۸.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه کیت توسعه نرمافزار PubMatic OpenWrap 4.8.0.
نسخه 4.7.0.0
- نسخهٔ پخش اولیه.
- از پیشنهاد قیمت برای قالبهای آگهی برنما، بینابینی، پاداشدار، و بومی پشتیبانی میکند.
- سازگاری با نسخه ۴.۷.۰ کیت توسعه نرمافزار PubMatic OpenWrap تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۶.۰.
- PubMatic OpenWrap SDK نسخه ۴.۷.۰.