این راهنما نحوه استفاده از Google Mobile Ads SDK (Legacy) را برای بار کردن و نمایش آگهیهای PubMatic بااستفاده از واسطهگری AdMob نشان میدهد و هر دو یکپارچهسازی آبشاری و پیشنهاد قیمت را پوشش میدهد. این راهنما نحوه افزودن کیت توسعه نرمافزار PubMatic OpenWrap به پیکربندی واسطهگری واحد آگهی، و نحوه ادغام کیت توسعه نرمافزار و آداپتور PubMatic OpenWrap در برنامه Android را پوشش میدهد.
یکپارچهسازیها و قالبهای آگهی پشتیبانیشده
آداپتور میانجیگری برای PubMatic قابلیتهای زیر را دارد:
| یکپارچهسازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | ۱ |
| قالبها | |
| صفحه باز شدن برنامه | |
| برنما | |
| بینابینی | |
| پاداش | |
| بینابینی پاداشدار | |
| بومی | |
۱ یکپارچهسازی آبشاری در نسخه آلفا است.
پیشنیازها
قبلاز ادامه دادن، موارد زیر را درستیسنجی کنید:
- سطح میانای برنامه کاربردی Android 24 یا بالاتر.
جدیدترین نسخه Google Mobile Ads SDK (Legacy).
مرحله ۱: راهاندازی پیکربندیها در PubMatic UI
در حساب PubMatic خود ثبتنام کنید یا به سیستم وارد شوید و کارت کیت توسعه نرمافزار OpenWrap را انتخاب کنید.
افزودن برنامه جدید
به برگه برنامهها پیمایش کنید و روی دکمه افزودن برنامه کلیک کنید.
پلاتفرم و همچنین نشانی وب «فروشگاه برنامهها» و نام برنامه را برای برنامه خود انتخاب کنید.
در بخش مسیر یکپارچهسازی، Android (Java / Kotlin) را انتخاب کنید و AdMob - پیشنهاد قیمت کیت توسعه نرمافزار را بهعنوان مسیر یکپارچهسازی فرعی انتخاب کنید. سپس روی دکمه افزودن برنامه کلیک کنید.
بهروزرسانی app-ads.txt
«فروشندگان مجاز برای برنامهها» app-ads.txt ابتکار IAB Tech Lab است که کمک میکند مطمئن شوید
فضای آگهی برنامه شما فقط ازطریق کانالهایی که بهعنوان مجاز شناسایی کردهاید فروخته میشود. برای جلوگیری از
کاهش قابلتوجه درآمد آگهی، باید فایل app-ads.txt را پیادهسازی کنید.
اگر قبلاً این کار را نکردهاید،
فایل app-ads.txt را برای برنامهتان راهاندازی کنید.
پیشاز نهایی شدن برنامه، ورودیهای مناسب برای افزودن به app-ads.txt به شما ارائه خواهد شد.
برای کسب اطلاعات بیشتر درباره نحوه پیادهسازی app-ads.txt برای PubMatic،
به نحوه پیادهسازی app-ads.txt مراجعه کنید.
شناسه نمایه
پساز ایجاد برنامه، به برگه برنامهها پیمایش کنید و شناسه نمایه برنامه جدیدتان را یادداشت کنید.
ایجاد واحد آگهی
در برگه واحدهای آگهی، برنامهای را که در بخش قبلی ایجاد کردهاید انتخاب کنید و روی دکمه ایجاد واحد آگهی کلیک کنید.
فرم را با جزئیات واحد آگهیتان تکمیل کنید و روی ذخیره کردن کلیک کنید.
شناسه واحد آگهی OpenWrap تازه ایجادشده خود را یادداشت کنید.
دریافت شناسه ناشر
به داشبورد Analytics بروید. موشواره را روی نماد نمایه نگه دارید و شناسه خود را یادداشت کنید.
مرحله ۲: راهاندازی تقاضای PubMatic در «واسط کاربر AdMob»
پیکربندی تنظیمات واسطهگری برای واحد آگهی
باید «کیت توسعه نرمافزار PubMatic OpenWrap» را به پیکربندی میانجیگری برای واحد آگهیتان اضافه کنید.
ابتدا به سیستم حساب AdMob خود وارد شوید. سپس به برگه واسطهگری پیمایش کنید. اگر گروه واسطهگری موجودی دارید که میخواهید آن را تغییر دهید، روی نام آن گروه واسطهگری کلیک کنید تا آن را ویرایش کنید، و به افزودن کیت توسعه نرمافزار PubMatic OpenWrap بهعنوان منبع آگهی بروید.
برای ایجاد گروه واسطهگری جدید، ایجاد گروه واسطهگری را انتخاب کنید.

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

برای گروه واسطهگری خود نامی انتخاب کنید و مکانهایی را برای هدفیابی انتخاب کنید. سپس وضعیت گروه واسطهگری را روی فعال تنظیم کنید و روی افزودن واحدهای آگهی کلیک کنید.

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

اکنون باید کارت واحدهای آگهی را ببینید که با واحدهای آگهی انتخابی شما پر شده است:

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

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

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

سپس، شناسه واحد آگهی OpenWrap را که در بخش قبلی بهدست آوردهاید وارد کنید. سپس روی تمام کلیک کنید.

PubMatic را به فهرست شرکای آگهی «مقررات کلی حفاظت از داده» و مقررات ایالتی ایالات متحده اضافه کنید
مراحل مندرج در تنظیمات مقررات اروپا و تنظیمات مقررات ایالتهای امریکا را دنبال کنید تا PubMatic را به فهرست شرکای آگهی مقررات اروپا و ایالتهای امریکا در «میانای کاربری AdMob» اضافه کنید.
مرحله ۳: وارد کردن کیت توسعه نرمافزار و آداپتور PubMatic OpenWrap
یکپارچهسازی «استودیو Android» (توصیه میشود)
در فایل settings.gradle.kts سطح پروژه، مخزنهای زیر را اضافه کنید:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://repo.pubmatic.com/artifactory/public-repos")
}
}
}
سپس، در فایل build.gradle.kts سطح برنامه، وابستگیهای پیادهسازی و پیکربندیهای زیر را اضافه کنید. از جدیدترین نسخههای
کیت توسعه نرمافزار و آداپتور PubMatic OpenWrap SDK استفاده کنید:
dependencies {
implementation("com.google.android.gms:play-services-ads:25.5.0")
implementation("com.google.ads.mediation:pubmatic:5.4.1.0")
}
مرحله ۴: پیادهسازی تنظیمات حریم خصوصی در PubMatic
برای رعایت خطمشی Google درخصوص موافقت کاربر اتحادیه اروپا، باید شفافسازیهای خاصی را برای کاربران خود در منطقه اقتصادی اروپا (EEA)، پادشاهی متحد، و سوئیس انجام دهید و موافقت آنها را برای استفاده از کوکیها یا دیگر فضاهای ذخیرهسازی محلی در جاهایی که قانون الزام میکند، و برای جمعآوری، همرسانی، و استفاده از دادههای شخصی برای شخصیسازی آگهیها کسب کنید. این خطمشی منعکسکننده الزامات «آییننامه حریم خصوصی الکترونیکی اتحادیه اروپا» و «مقررات کلی حفاظت از دادهها» (GDPR) است. شما مسئول تأیید کردن این هستید که موافقت به هر منبع آگهی در زنجیره واسطهگری شما منتقل شده است.
PubMatic بهطور خودکار موافقت GDPR را که پلاتفرمهای مدیریت موافقت تنظیم کردهاند میخواند. این پلاتفرمها از مشخصات «موافقت اضافی Google» پشتیبانی میکنند، ازجمله کیت توسعه نرمافزار UMP. برای اطلاعات بیشتر، گذراندن «مقررات کلی حفاظت از داده» و کسب رضایت «مقررات کلی حفاظت از داده» را ببینید.
قوانین حریم خصوصی ایالتی در ایالات متحده
قوانین حریم خصوصی ایالتهای امریکا ملزم میکند به کاربران حق داده شود که از «فروش» «اطلاعات شخصی» خود (طبق تعریف قانون از این اصطلاحات) انصراف دهند، و این انصراف ازطریق پیوند برجسته «اطلاعات شخصی من فروخته نشود» در صفحه اصلی طرف «فروشنده» ارائه شود. راهنمای رعایت قوانین حریم خصوصی ایالات متحده امکان فعال کردن پردازش دادههای محدودشده را برای ارائه آگهی Google فراهم میکند، اما Google نمیتواند این تنظیم را برای هر شبکه آگهی در زنجیره واسطهگری شما اعمال کند. بنابراین، باید هر شبکه آگهی را در زنجیره واسطهگریتان که ممکن است در فروش اطلاعات شخصی شرکت کند شناسایی کنید و برای اطمینان از رعایت قوانین، از دستورالعملهای هریک از آن شبکهها پیروی کنید.
PubMatic بهطور خودکار موافقت GPP را که پلاتفرمهای مدیریت موافقت تنظیم کردهاند و از مشخصات «موافقت اضافی Google» پشتیبانی میکنند، ازجمله کیت توسعه نرمافزار UMP، میخواند. برای اطلاعات بیشتر، به گذراندن موافقت GPP مراجعه کنید.
مرحله ۵: افزودن کد الزامی
برای یکپارچهسازی «کیت توسعه نرمافزار PubMatic OpenWrap»، به کد اضافی نیاز نیست.
مرحله ۶: پیادهسازیتان را آزمایش کنید
فعال کردن آگهیهای آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کردهاید.
درستیسنجی آگهیهای آزمایشی
برای درستیسنجی اینکه آگهیهای آزمایشی را از کیت توسعه نرمافزار PubMatic OpenWrap دریافت میکنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع(های) آگهی PubMatic OpenWrap فعال کنید.
مراحل اختیاری
آگهیهای بومی
پرداز آگهی
آداپتور PubMatic آگهیهای بومی خود را بهصورت
NativeAd
برمیگرداند. این ویژگی
فیلدهای
زیر را برای
NativeAd پر میکند.
| فیلد | داراییهایی که همیشه توسط آداپتور PubMatic اضافه میشود |
|---|---|
| Headline | |
| تصویر | |
| بدن | |
| نماد | |
| دعوت به اقدام | |
| ردهبندی با ستاره | |
| فروشگاه | |
| قیمت | |
| آگهیدهنده |
کدهای خطا
اگر این آداپتور نتواند آگهی را از PubMatic دریافت کند، میتوانید خطای زیربنایی را از پاسخ آگهی بااستفاده از
ResponseInfo.getAdapterResponses()
در کلاسهای زیر بررسی کنید:
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
در اینجا کدها و پیامهای همراهی که توسط آداپتور PubMatic وقتی آگهی بار نمیشود ارائه میشود آورده شده است:
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱۰۱ | com.google.ads.mediation.pubmatic | پیکربندی سرور فاقد شناسه ناشر الزامی است. |
| 102 | com.google.ads.mediation.pubmatic | قالب آگهی توسط PubMatic پشتیبانی نمیشود یا در دادههای سیگنال RTB وجود ندارد. |
| 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 | اندازه آگهی برنمای نامعتبر. |
| 1001-5002 | ارسالشده توسط PubMatic SDK | «کیت توسعه نرمافزار PubMatic» خطایی برگرداند. برای جزئیات بیشتر، مستندات PubMatic را ببینید. |
تغییر گزارش میانجیگری PubMatic Android
نسخه ۵.۴.۱.۰
- حداقل سطح میانای برنامهسازی کاربردی Android موردنیاز به ۲۴ بهروز شد.
- سازگاری با «کیت توسعه نرمافزار Pubmatic» نسخه ۵.۴.۱ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۵.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۵.۰ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه ۵.۴.۱ کیت توسعه نرمافزار Pubmatic
نسخه ۵.۴.۰.۰
- سازگاری با «کیت توسعه نرمافزار Pubmatic» نسخه ۵.۴.۰ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۴.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۴.۰ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه ۵.۴.۰ کیت توسعه نرمافزار Pubmatic
نسخه ۵.۳.۰.۱
- وابستگی Kotlin آداپتور را به 1.9.0 (حداقل نسخه Kotlin پشتیبانیشده توسط کیت توسعه نرمافزار GMA NextGen) سنجاق کنید.
ساخته و آزمایششده با:
- نسخه ۲۵.۴.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۴.۰ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه ۵.۳.۰ کیت توسعه نرمافزار Pubmatic
نسخه ۵.۳.۰.۰
- سازگاری با Pubmatic SDK نسخه ۵.۳.۰ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۴.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۴.۰ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه ۵.۳.۰ کیت توسعه نرمافزار Pubmatic
نسخه ۵.۲.۰.۰
- سازگاری با «کیت توسعه نرمافزار Pubmatic» نسخه ۵.۲.۰ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۴.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۳.۰ «کیت توسعه نرمافزار نسل بعدی آگهیهای تلفن همراه Google».
- نسخه ۵.۲.۰ کیت توسعه نرمافزار Pubmatic
نسخه ۵.۱.۲.۲
- Maps
AgeRestrictedTreatmentبه PubMatic's COPPA API.
ساخته و آزمایششده با:
- نسخه ۲۵.۴.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۲.۱ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه ۵.۱.۲ کیت توسعه نرمافزار Pubmatic
نسخه ۵.۱.۲.۱
- پشتیبانی از ویدیو آگهی بومی(VAST) بااستفاده از PubMatic OpenWrapSDK MediaView API اضافه شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۲.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۲.۱ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه ۵.۱.۲ کیت توسعه نرمافزار Pubmatic
نسخه ۵.۱.۲.۰
- سازگاری با «کیت توسعه نرمافزار Pubmatic» نسخه ۵.۱.۲ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۲.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۱.۰ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه ۵.۱.۲ کیت توسعه نرمافزار Pubmatic
نسخه ۵.۱.۱.۰
- سازگاری با Pubmatic SDK نسخه ۵.۱.۱ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۲.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۰.۱ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه ۵.۱.۱ کیت توسعه نرمافزار Pubmatic
نسخه ۵.۱.۰.۰
- سازگاری با «کیت توسعه نرمافزار Pubmatic» نسخه ۵.۱.۰ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۲.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۵.۱.۰ کیت توسعه نرمافزار Pubmatic
نسخه ۵.۰.۰.۱
- دارایی برای ساختن آداپتور با وابستگی «کیت توسعه نرمافزار نسل بعدی GMA» اضافه شد.
- اشکالی که باعث میشد شیء
mediationUtilsمقداردهی اولیه نشود برطرف شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۱.۰ کیت توسعه نرمافزار آگهی تلفن همراه Google.
- نسخه ۵.۰.۰ کیت توسعه نرمافزار Pubmatic
نسخه ۵.۰.۰.۰
- سازگاری با Pubmatic SDK 5.0.0 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۰.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۵.۰.۰ کیت توسعه نرمافزار Pubmatic
نسخه 4.12.0.0
- سازگاری با Pubmatic SDK 4.12.0 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۹.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه کیت توسعه نرمافزار Pubmatic 4.12.0
نسخه ۴.۱۱.۰.۱
- پشتیبانی از بازارسال پارامتر
tagForUnderAgeOfConsentGoogle Mobile Ads SDK به PubMatic SDK اضافه شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۹.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۴.۱۱.۰ کیت توسعه نرمافزار Pubmatic
نسخه 4.11.0.0
- سازگاری با Pubmatic SDK 4.11.0 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۹.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۴.۱۱.۰ کیت توسعه نرمافزار Pubmatic
نسخه ۴.۱۰.۰.۱
- فهرست داراییها برای قالب آگهی بومی آبشاری اضافه شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۷.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه کیت توسعه نرمافزار Pubmatic 4.10.0
نسخه ۴.۱۰.۰.۰
- سازگاری با «کیت توسعه نرمافزار Pubmatic» نسخه ۴.۱۰.۰ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۷.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه کیت توسعه نرمافزار Pubmatic 4.10.0
نسخه ۴.۹.۱.۰
- سازگاری با «کیت توسعه نرمافزار Pubmatic» نسخه ۴.۹.۱ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۶.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۴.۹.۱ کیت توسعه نرمافزار Pubmatic
نسخه ۴.۸.۰.۱
- پشتیبانی از آگهیهای بینابینی آبشاری را اضافه میکند.
- پشتیبانی از آگهیهای پاداشدار آبشاری را اضافه میکند.
- پشتیبانی از آگهیهای برنمای آبشاری را اضافه میکند.
- پشتیبانی از آگهیهای بومی آبشاری را اضافه میکند.
- سازگاری با Pubmatic SDK 4.8.0 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۶.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۴.۸.۰ کیت توسعه نرمافزار Pubmatic
نسخه ۴.۸.۰.۰
- سازگاری با Pubmatic SDK 4.8.0 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزار آگهی تلفن همراه Google.
- نسخه کیت توسعه نرمافزار Pubmatic 4.8.0.
نسخه 4.7.1.1
- اندازه ثابت نماد AdChoices
ساخته و آزمایششده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزار آگهی تلفن همراه Google.
- نسخه کیت توسعه نرمافزار Pubmatic 4.7.1.
نسخه ۴.۷.۱.۰
- سازگاری با «کیت توسعه نرمافزار Pubmatic» نسخه ۴.۷.۱ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزار آگهی تلفن همراه Google.
- نسخه کیت توسعه نرمافزار Pubmatic 4.7.1.
نسخه ۴.۷.۰.۱
- وابستگیهای داخلی ثابت شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزار آگهی تلفن همراه Google.
- نسخه کیت توسعه نرمافزار Pubmatic 4.7.0.
نسخه ۴.۷.۰.۰
- نسخهٔ پخش اولیه.
- پشتیبانی پیشنهاد قیمت برای قالبهای آگهی برنمایی، بینابینی، پاداشدار، و بومی اضافه شد.
- سازگاری با Pubmatic SDK 4.7.0 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزار آگهی تلفن همراه Google.
- نسخه کیت توسعه نرمافزار Pubmatic 4.7.0.