این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از PubMatic با استفاده از AdMob Mediation استفاده کنید، و ادغام‌های پیشنهاد قیمت را پوشش می‌دهد. این راهنما نحوه اضافه کردن SDK PubMatic OpenWrap به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور PubMatic OpenWrap را در یک برنامه اندروید پوشش می‌دهد.
ادغام‌ها و قالب‌های تبلیغاتی پشتیبانی‌شده
آداپتور میانجیگری برای PubMatic دارای قابلیت‌های زیر است:
| ادغام | |
|---|---|
| مناقصه | ۱ |
| آبشار | |
| قالب‌ها | |
| برنامه باز است | |
| بنر | |
| بینابینی | ۲ |
| پاداش داده شده | ۲ |
| تبلیغات بینابینی پاداش‌دار | |
| بومی | ۲ |
۱- ادغام پیشنهاد قیمت در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
۲ تمام قالب‌های تبلیغاتی پشتیبانی‌شده‌ی دیگر، علاوه بر بنرها، در مرحله‌ی آلفا هستند.
الزامات
- اندروید API سطح ۲۳ یا بالاتر
جدیدترین SDK تبلیغات موبایلی گوگل.
راهنمای شروع میانجیگری را تکمیل کنید.
مرحله ۱: تنظیمات را در رابط کاربری PubMatic انجام دهید
وارد حساب کاربری PubMatic خود شوید و کارت SDK مربوط به OpenWrap را انتخاب کنید.
افزودن یک برنامه جدید
به برگه برنامه‌ها بروید و روی دکمه افزودن برنامه کلیک کنید.
پلتفرم (Platform ) و همچنین آدرس اینترنتی اپ استور (App Store URL) و نام اپ (App Name) را برای اپلیکیشن خود انتخاب کنید.
در قسمت «مسیر ادغام» ، اندروید (جاوا / کاتلین) را انتخاب کنید و « مسیر ادغام فرعی» را «آدموب - پیشنهاد SDK» قرار دهید. سپس، روی دکمه «افزودن برنامه» کلیک کنید.
فایل app-ads.txt خود را به‌روزرسانی کنید.
فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .
قبل از نهایی شدن برنامه، ورودی‌های مناسب برای اضافه کردن به app-ads.txt به شما نمایش داده می‌شود.
برای اطلاعات بیشتر در مورد نحوه پیاده‌سازی app-ads.txt برای PubMatic، به نحوه پیاده‌سازی app-ads.txt مراجعه کنید.
شناسه پروفایل
پس از ایجاد برنامه، به برگه برنامه‌ها بروید و شناسه پروفایل برنامه تازه ایجاد شده خود را یادداشت کنید.
ایجاد واحد تبلیغاتی
در زیر تب واحدهای تبلیغاتی (Ad Units )، برنامه‌ای را که در بخش قبلی ایجاد کرده‌اید انتخاب کنید و روی دکمه‌ی ایجاد واحد تبلیغاتی (Create Ad Unit) کلیک کنید.
فرم را با جزئیات واحد تبلیغاتی خود پر کنید و روی ذخیره کلیک کنید.
شناسه واحد تبلیغاتی OpenWrap که به تازگی ایجاد کرده‌اید را یادداشت کنید.
شناسه ناشر خود را دریافت کنید
به داشبورد آنالیتیکس بروید. نشانگر ماوس را روی آیکون پروفایل نگه دارید و شناسه خود را یادداشت کنید.
مرحله ۲: تنظیم تقاضای PubMatic در رابط کاربری AdMob
تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید
شما باید PubMatic OpenWrap SDK را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.
ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به مرحله بعد بروید: افزودن PubMatic OpenWrap SDK به عنوان منبع تبلیغات .
برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.
قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی ادامه کلیک کنید.
به گروه میانجیگری خود یک نام بدهید و مکان‌هایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.
این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.
اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کرده‌اید پر شده است:
اضافه کردن PubMatic OpenWrap SDK به عنوان منبع تبلیغات
در قسمت «منابع تبلیغات» ، زیر کارت پیشنهاد قیمت ، گزینه «افزودن منبع تبلیغات» را انتخاب کنید. سپس «PubMatic OpenWrap SDK» را انتخاب کنید.روی نحوه امضای قرارداد مشارکت و تنظیم مشارکت در مناقصه با PubMatic OpenWrap SDK کلیک کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر از قبل نگاشتی برای PubMatic OpenWrap SDK دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.
سپس، شناسه واحد تبلیغاتی OpenWrap که در بخش قبل به دست آورده‌اید را وارد کنید. سپس روی «انجام شد» کلیک کنید.
اضافه کردن PubMatic به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده
برای افزودن PubMatic به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
مرحله 3: SDK و آداپتور PubMatic OpenWrap را وارد کنید
ادغام با اندروید استودیو (توصیه می‌شود)
در فایل 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:24.8.0")
implementation("com.google.ads.mediation:pubmatic:4.10.0.1")
}
مرحله ۴: تنظیمات حریم خصوصی را در PubMatic اعمال کنید
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر ذخیره‌سازی‌های محلی در صورت لزوم قانونی، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات، دریافت کنید. این سیاست منعکس‌کننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از داده‌ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره میانجیگری خود هستید.
PubMatic به طور خودکار رضایت GDPR تنظیم شده توسط پلتفرم‌های مدیریت رضایت که از مشخصات رضایت اضافی گوگل ، از جمله UMP SDK ، پشتیبانی می‌کنند را می‌خواند. برای اطلاعات بیشتر، به Pass GDPR و رضایت GDPR مراجعه کنید.
قوانین حفظ حریم خصوصی ایالت‌های آمریکا
قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف می‌کند) را می‌دهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه می‌شود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، امکان فعال کردن پردازش داده‌های محدود برای سرویس تبلیغات گوگل را ارائه می‌دهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطه‌گری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطه‌گری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنمایی‌های هر یک از این شبکه‌ها پیروی کنید.
PubMatic به طور خودکار رضایت‌نامه GPP تنظیم‌شده توسط پلتفرم‌های مدیریت رضایت‌نامه که از مشخصات رضایت‌نامه اضافی گوگل ، از جمله UMP SDK، پشتیبانی می‌کنند را می‌خواند. برای اطلاعات بیشتر، به بخش «پذیرش رضایت‌نامه GPP» مراجعه کنید.
مرحله ۵: اضافه کردن کد مورد نیاز
برای ادغام PubMatic OpenWrap SDK نیازی به کد اضافی نیست.
مرحله ۶: پیاده‌سازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده‌اید .
تأیید تبلیغات آزمایشی
برای تأیید اینکه تبلیغات آزمایشی را از PubMatic OpenWrap SDK دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی PubMatic (مناقصه ) فعال کنید.
مراحل اختیاری
تبلیغات بومی
رندرینگ آگهی
آداپتور PubMatic تبلیغات بومی خود را به عنوان اشیاء NativeAd برمی‌گرداند. این آداپتور فیلدهای زیر را برای NativeAd پر می‌کند.
| میدان | دارایی‌ها همیشه توسط آداپتور PubMatic گنجانده می‌شوند |
|---|---|
| تیتر | |
| تصویر | |
| بدن | |
| آیکون | |
| فراخوان برای اقدام | |
| رتبه‌بندی ستاره‌ای | |
| فروشگاه | |
| قیمت | |
| تبلیغ کننده |
کدهای خطا
اگر آداپتور نتواند تبلیغی از PubMatic دریافت کند، می‌توانید خطای اساسی را از پاسخ تبلیغ با استفاده ResponseInfo.getAdapterResponses() تحت کلاس‌های زیر بررسی کنید:
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
در اینجا کدها و پیام‌های همراه که توسط آداپتور PubMatic هنگام عدم بارگیری یک تبلیغ نمایش داده می‌شوند، آمده است:
| کد خطا | دامنه | دلیل |
|---|---|---|
| ۱۰۱ | com.google.ads.mediation.pubmatic | پیکربندی سرور فاقد شناسه ناشر مورد نیاز است. |
| ۱۰۲ | com.google.ads.mediation.pubmatic | پیکربندی تبلیغ نامعتبر برای بارگذاری یک تبلیغ. |
| ۱۰۳ | com.google.ads.mediation.pubmatic | به دلیل آماده نبودن آگهی، نتوانستم آن را ارائه دهم. |
| ۱۰۰۱-۵۰۰۲ | ارسال شده توسط PubMatic SDK | PubMatic SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات PubMatic مراجعه کنید. |
تغییرات آداپتور میانجیگری اندروید PubMatic
نسخه ۴.۱۰.۰.۱
- فهرست دارایی‌ها برای قالب تبلیغات بومی آبشاری اضافه شد.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
- نسخه ۴.۱۰.۰ کیت توسعه نرم‌افزار پابماتیک
نسخه ۴.۱۰.۰.۰
- سازگاری تأیید شده با Pubmatic SDK 4.10.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
- نسخه ۴.۱۰.۰ کیت توسعه نرم‌افزار پابماتیک
نسخه ۴.۹.۱.۰
- سازگاری تأیید شده با Pubmatic SDK 4.9.1.
ساخته و آزمایش شده با:
- نسخه ۲۴.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
- نسخه ۴.۹.۱ کیت توسعه نرم‌افزار پابماتیک
نسخه ۴.۸.۰.۱
- پشتیبانی از تبلیغات بینابینی آبشاری را اضافه می‌کند.
- پشتیبانی از تبلیغات پاداشی آبشاری را اضافه می‌کند.
- پشتیبانی از تبلیغات بنری آبشاری را اضافه می‌کند.
- پشتیبانی از تبلیغات بومی آبشاری را اضافه می‌کند.
- سازگاری تأیید شده با Pubmatic SDK 4.8.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
- نسخه ۴.۸.۰ کیت توسعه نرم‌افزار پابماتیک
نسخه ۴.۸.۰.۰
- سازگاری تأیید شده با Pubmatic SDK 4.8.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
- نسخه ۴.۸.۰ از کیت توسعه نرم‌افزاری پابماتیک.
نسخه ۴.۷.۱.۱
- اندازه ثابت آیکون AdChoices
ساخته و آزمایش شده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
- نسخه ۴.۷.۱ از کیت توسعه نرم‌افزار پابماتیک.
نسخه ۴.۷.۱.۰
- سازگاری تأیید شده با Pubmatic SDK 4.7.1.
ساخته و آزمایش شده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
- نسخه ۴.۷.۱ از کیت توسعه نرم‌افزار پابماتیک.
نسخه ۴.۷.۰.۱
- وابستگی‌های داخلی ثابت.
ساخته و آزمایش شده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
- نسخه ۴.۷.۰ از کیت توسعه نرم‌افزاری پابماتیک.
نسخه ۴.۷.۰.۰
- انتشار اولیه.
- پشتیبانی از پیشنهاد قیمت برای قالب‌های تبلیغات بنری، بینابینی، پاداشی و بومی اضافه شد.
- سازگاری تأیید شده با Pubmatic SDK 4.7.0.
ساخته و آزمایش شده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
- نسخه ۴.۷.۰ از کیت توسعه نرم‌افزاری پابماتیک.