این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از PubMatic با استفاده از میانجیگری استفاده کنید که ادغام‌های مناقصه را پوشش می‌دهد. نحوه افزودن PubMatic به پیکربندی میانجی واحد تبلیغات و نحوه ادغام PubMatic و آداپتور در یک برنامه Android را پوشش می‌دهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای PubMatic دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | |
| فرمت ها | |
| برنامه باز شد | |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
| بینابینی پاداش | |
| بومی | |
الزامات
- Android API سطح 23 یا بالاتر
جدیدترین SDK تبلیغات موبایل گوگل.
راهنمای شروع میانجیگری را کامل کنید.
مرحله 1: تنظیمات را در PubMatic UI تنظیم کنید
وارد حساب PubMatic خود شوید و کارت OpenWrap SDK را انتخاب کنید.
یک برنامه جدید اضافه کنید
به تب Apps بروید و روی دکمه Add App کلیک کنید.
پلتفرم و همچنین URL فروشگاه App و نام برنامه را برای برنامه خود انتخاب کنید.
در قسمت Integration Path ، Android (Java/Kotlin) را انتخاب کنید و 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 را وارد کنید
ادغام Android Studio (توصیه می شود)
در فایل settings.gradle.kts سطح پروژه خود، مخازن زیر را اضافه کنید:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://repo.pubmatic.com/artifactory/public-repos")
}
}
}
سپس، در فایل build.gradle.kts در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه‌های PubMatic SDK و آداپتور استفاده کنید:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.7.0")
implementation("com.google.ads.mediation:pubmatic:4.9.1.0")
}
مرحله 4: تنظیمات حریم خصوصی را در PubMatic SDK اجرا کنید
برای پیروی از خط‌مشی رضایت کاربر اتحادیه اروپا Google ، باید اطلاعات مشخصی را به کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس ارائه کنید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر فضای ذخیره‌سازی محلی در مواردی که از نظر قانونی لازم است، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات کسب کنید. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع آگهی در زنجیره میانجی شما هستید.
PubMatic به‌طور خودکار رضایت GDPR تنظیم شده توسط پلت‌فرم‌های مدیریت رضایت که از مشخصات رضایت اضافی Google ، از جمله UMP SDK، پشتیبانی می‌کنند، می‌خواند. برای اطلاعات بیشتر، به مجوز GDPR و GDPR مراجعه کنید.
قوانین حفظ حریم خصوصی ایالات متحده
قوانین حفظ حریم خصوصی ایالات ایالات متحده مستلزم اعطای حق انصراف به کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف از طریق پیوند برجسته "اطلاعات شخصی من را نفروشید" در صفحه اصلی طرف "فروشنده" ارائه می شود. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.
PubMatic به‌طور خودکار رضایت GPP تنظیم شده توسط پلت‌فرم‌های مدیریت رضایت را که از مشخصات رضایت اضافی Google ، از جمله UMP SDK، پشتیبانی می‌کنند، می‌خواند. برای اطلاعات بیشتر، به مجوز مجوز GPP مراجعه کنید.
مرحله 5: کد مورد نیاز را اضافه کنید
هیچ کد اضافی برای ادغام PubMatic مورد نیاز نیست.
مرحله 6: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهی‌های آزمایشی را از PubMatic OpenWrap SDK دریافت می‌کنید، با استفاده از منبع(های ) آگهی PubMatic (مناقصه ) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
مراحل اختیاری
تبلیغات بومی
رندر آگهی
آداپتور PubMatic تبلیغات بومی خود را به عنوان اشیاء NativeAd برمی گرداند. فیلدهای زیر را برای NativeAd پر می کند.
| میدان | دارایی ها همیشه توسط آداپتور PubMatic گنجانده شده است |
|---|---|
| تیتر | |
| تصویر | |
| بدن | |
| نماد | |
| فراخوان به اقدام | |
| امتیاز ستاره | |
| فروشگاه | |
| قیمت | |
| تبلیغ کننده |
کدهای خطا
اگر آداپتور نتواند تبلیغی را از PubMatic دریافت کند، می‌توانید با استفاده از ResponseInfo.getAdapterResponses() در کلاس‌های زیر، خطای اساسی مربوط به پاسخ آگهی را بررسی کنید:
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور PubMatic هنگام بارگیری نشدن آگهی ارسال می‌شوند:
| کد خطا | دامنه | دلیل |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | پیکربندی سرور فاقد شناسه ناشر مورد نیاز است. |
| 102 | com.google.ads.mediation.pubmatic | پیکربندی تبلیغ نامعتبر برای بارگیری آگهی. |
| 103 | com.google.ads.mediation.pubmatic | به دلیل آماده نبودن آگهی، تبلیغ ارائه نشد. |
| 1001-5002 | ارسال شده توسط PubMatic SDK | PubMatic SDK یک خطا برگرداند. برای جزئیات بیشتر به مستندات PubMatic مراجعه کنید. |
تغییرات آداپتور میانجی اندروید PubMatic
نسخه 4.9.1.0
- سازگاری تایید شده با Pubmatic SDK 4.9.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.6.0.
- Pubmatic SDK نسخه 4.9.1
نسخه 4.8.0.1
- پشتیبانی از تبلیغات بینابینی آبشاری را اضافه می کند.
- پشتیبانی از تبلیغات با پاداش آبشار را اضافه می کند.
- پشتیبانی از تبلیغات بنری آبشاری را اضافه می کند.
- پشتیبانی از تبلیغات بومی آبشار را اضافه می کند.
- سازگاری تایید شده با Pubmatic SDK 4.8.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.6.0.
- Pubmatic SDK نسخه 4.8.0
نسخه 4.8.0.0
- سازگاری تایید شده با Pubmatic SDK 4.8.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.4.0.
- Pubmatic SDK نسخه 4.8.0.
نسخه 4.7.1.1
- اندازه ثابت نماد AdChoices
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.4.0.
- Pubmatic SDK نسخه 4.7.1.
نسخه 4.7.1.0
- سازگاری تایید شده با Pubmatic SDK 4.7.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.4.0.
- Pubmatic SDK نسخه 4.7.1.
نسخه 4.7.0.1
- وابستگی های داخلی ثابت شده است.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.4.0.
- Pubmatic SDK نسخه 4.7.0.
نسخه 4.7.0.0
- انتشار اولیه
- پشتیبانی از مناقصه برای قالب های تبلیغاتی بنر، بینابینی، پاداش و بومی اضافه شده است.
- سازگاری تایید شده با Pubmatic SDK 4.7.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.4.0.
- Pubmatic SDK نسخه 4.7.0.