This guide shows you how to use Google Mobile Ads SDK to load and display ads from PubMatic using mediation , covering bidding integrations. It covers how to add PubMatic OpenWrap SDK to an ad unit's mediation configuration, and how to integrate the PubMatic OpenWrap SDK and adapter into an Android app.
ادغامها و قالبهای تبلیغاتی پشتیبانیشده
آداپتور میانجیگری برای PubMatic دارای قابلیتهای زیر است:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | |
| قالبها | |
| برنامه باز است | |
| بنر | |
| بینابینی | ۱ |
| پاداش داده شده | ۱ |
| تبلیغات بینابینی پاداشدار | |
| بومی | ۱ |
۱ این قالب در مرحله بتا است. برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
الزامات
- اندروید API سطح ۲۳ یا بالاتر
جدیدترین Google Mobile Ads SDK
راهنمای شروع میانجیگری را تکمیل کنید.
مرحله ۱: تنظیمات را در رابط کاربری PubMatic انجام دهید
وارد حساب کاربری PubMatic خود شوید و کارت SDK مربوط به OpenWrap را انتخاب کنید.
افزودن یک برنامه جدید
به برگه برنامهها بروید و روی دکمه افزودن برنامه کلیک کنید.
پلتفرم (Platform ) و همچنین آدرس اینترنتی اپ استور (App Store URL) و نام اپ (App Name) را برای اپلیکیشن خود انتخاب کنید.
Under Integration Path , select Android (Java / Kotlin) and select AdMob - SDK Bidding as the Sub-integration Path . Then, click the Add App button.
فایل 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 مراجعه کنید.
شناسه پروفایل
پس از ایجاد برنامه، به برگه برنامهها بروید و شناسه پروفایل برنامه تازه ایجاد شده خود را یادداشت کنید.
ایجاد واحد تبلیغاتی
در زیر تب واحدهای تبلیغاتی (Ad Units )، برنامهای را که در بخش قبلی ایجاد کردهاید انتخاب کنید و روی دکمهی ایجاد واحد تبلیغاتی (Create Ad Unit) کلیک کنید.
فرم را با جزئیات واحد تبلیغاتی خود پر کنید و روی ذخیره کلیک کنید.
شناسه واحد تبلیغاتی OpenWrap که به تازگی ایجاد کردهاید را یادداشت کنید.
شناسه ناشر خود را دریافت کنید
به داشبورد آنالیتیکس بروید. نشانگر ماوس را روی آیکون پروفایل نگه دارید و شناسه خود را یادداشت کنید.
Step 2: Set up PubMatic demand in Ad Manager UI
وارد حساب مدیر تبلیغات خود شوید.
فعال کردن اشتراکگذاری امن سیگنال
به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراکگذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.
سیگنال امن را در درخواستهای پیشنهاد به اشتراک بگذارید
Navigate to Inventory > Secure Signals . Under Secure signals , search for PubMatic OpenWrap SDK and toggle on Enable app integration .
روی ذخیره کلیک کنید.
امکان اشتراکگذاری امن سیگنال برای مناقصه SDK
به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیشفرض ، گزینه «اجازه اشتراکگذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.
روی ذخیره کلیک کنید.
Configure PubMatic bidding
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
روی پیشنهاددهنده جدید کلیک کنید.
Select PubMatic OpenWrap SDK as the bidder.
برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.
روی انجام شد کلیک کنید.
پیکربندی نگاشت واحد تبلیغات
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
Select the company for PubMatic OpenWrap SDK.
به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.
Choose Specific ad unit . Select an ad unit and format, Mobile app as the Inventory type , and your Mobile application . Then, enter OpenWrap Ad Unit ID obtained in the previous section.
If you are configuring ad unit mapping for a rewarded interstitial ad within the Ad Manager UI, choose the Rewarded format and use the rewarded interstitial placement ID.
در نهایت، روی ذخیره کلیک کنید.
اضافه کردن PubMatic به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده
Follow the steps in European regulations settings and US state regulations settings to add PubMatic to the European and US state regulations ad partners list in the Ad Manager UI.
مرحله 3: SDK و آداپتور PubMatic OpenWrap را وارد کنید
ادغام با اندروید استودیو (توصیه میشود)
در فایل settings.gradle.kts در سطح پروژه، مخازن زیر را اضافه کنید:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://repo.pubmatic.com/artifactory/public-repos")
}
}
}
Then, in your app-level build.gradle.kts file, add the following implementation dependencies and configurations. Use the latest versions of the PubMatic OpenWrap SDK SDK and adapter:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.9.0")
implementation("com.google.ads.mediation:pubmatic:4.12.0.0")
}
مرحله ۴: تنظیمات حریم خصوصی را در PubMatic اعمال کنید
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره میانجیگری خود هستید.
PubMatic به طور خودکار رضایت GDPR تنظیم شده توسط پلتفرمهای مدیریت رضایت که از مشخصات رضایت اضافی گوگل ، از جمله UMP SDK ، پشتیبانی میکنند را میخواند. برای اطلاعات بیشتر، به Pass GDPR و رضایت GDPR مراجعه کنید.
قوانین حفظ حریم خصوصی ایالتهای آمریکا
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
PubMatic به طور خودکار رضایتنامه GPP تنظیمشده توسط پلتفرمهای مدیریت رضایتنامه که از مشخصات رضایتنامه اضافی گوگل ، از جمله UMP SDK، پشتیبانی میکنند را میخواند. برای اطلاعات بیشتر، به بخش «پذیرش رضایتنامه GPP» مراجعه کنید.
مرحله ۵: اضافه کردن کد مورد نیاز
No additional code needed for PubMatic OpenWrap SDK integration.
مرحله ۶: پیادهسازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کردهاید .
تأیید تبلیغات آزمایشی
برای تأیید اینکه تبلیغات آزمایشی را از PubMatic OpenWrap SDK دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی PubMatic (مناقصه ) فعال کنید.
مراحل اختیاری
تبلیغات بومی
رندرینگ آگهی
The PubMatic adapter returns its native ads as NativeAd objects. It populates the following fields for a NativeAd .
| میدان | داراییها همیشه توسط آداپتور PubMatic گنجانده میشوند |
|---|---|
| تیتر | |
| تصویر | |
| بدن | |
| آیکون | |
| فراخوان برای اقدام | |
| رتبهبندی ستارهای | |
| فروشگاه | |
| قیمت | |
| تبلیغ کننده |
کدهای خطا
If the adapter fails to receive an ad from PubMatic, you can check the underlying error from the ad response using ResponseInfo.getAdapterResponses() under the following classes:
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
در اینجا کدها و پیامهای همراه که توسط آداپتور PubMatic هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آمده است:
| کد خطا | دامنه | دلیل |
|---|---|---|
| ۱۰۱ | com.google.ads.mediation.pubmatic | پیکربندی سرور فاقد شناسه ناشر مورد نیاز است. |
| ۱۰۲ | com.google.ads.mediation.pubmatic | پیکربندی تبلیغ نامعتبر برای بارگذاری یک تبلیغ. |
| ۱۰۳ | com.google.ads.mediation.pubmatic | Failed to present an ad because the ad was not ready. |
| ۱۰۰۱-۵۰۰۲ | ارسال شده توسط PubMatic SDK | PubMatic SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات PubMatic مراجعه کنید. |
PubMatic Android Mediation Adapter Changelog
نسخه ۴.۱۲.۰.۰
- Verified compatibility with Pubmatic SDK 4.12.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۹.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.12.0
نسخه ۴.۱۱.۰.۱
- Added support for forwarding the
tagForUnderAgeOfConsentGoogle Mobile Ads SDK parameter to the PubMatic SDK.
ساخته و آزمایش شده با:
- نسخه ۲۴.۹.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.11.0
نسخه ۴.۱۱.۰.۰
- Verified compatibility with Pubmatic SDK 4.11.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۹.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.11.0
Version 4.10.0.1
- Added list of assets for waterfall native ad format.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.10.0
نسخه ۴.۱۰.۰.۰
- Verified compatibility with Pubmatic SDK 4.10.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.10.0
نسخه ۴.۹.۱.۰
- Verified compatibility with Pubmatic SDK 4.9.1.
ساخته و آزمایش شده با:
- نسخه ۲۴.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.9.1
Version 4.8.0.1
- Adds support for waterfall interstitial ads.
- Adds support for waterfall rewarded ads.
- Adds support for waterfall banner ads.
- Adds support for waterfall native ads.
- Verified compatibility with Pubmatic SDK 4.8.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.8.0
نسخه ۴.۸.۰.۰
- Verified compatibility with Pubmatic SDK 4.8.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.8.0.
Version 4.7.1.1
- Fixed size of AdChoices Icon
ساخته و آزمایش شده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.7.1.
نسخه ۴.۷.۱.۰
- Verified compatibility with Pubmatic SDK 4.7.1.
ساخته و آزمایش شده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.7.1.
Version 4.7.0.1
- Fixed internal dependencies.
ساخته و آزمایش شده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.7.0.
نسخه ۴.۷.۰.۰
- انتشار اولیه.
- Added bidding support for banner, interstitial, rewarded and native ad formats.
- Verified compatibility with Pubmatic SDK 4.7.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- Pubmatic SDK version 4.7.0.