این راهنما به شما نشان میدهد که چگونه از GMA Next-Gen SDK برای بارگذاری و نمایش تبلیغات از PubMatic با استفاده از میانجیگری استفاده کنید، که شامل ادغام آبشاری و مناقصهای میشود. این راهنما نحوه اضافه کردن PubMatic OpenWrap SDK به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام PubMatic OpenWrap SDK و آداپتور آن در یک برنامه اندروید را پوشش میدهد.
ادغامها و قالبهای تبلیغاتی پشتیبانیشده
آداپتور میانجیگری برای PubMatic دارای قابلیتهای زیر است:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | ۱ |
| قالبها | |
| برنامه باز است | |
| بنر | |
| بینابینی | ۲ |
| پاداش داده شده | ۲ |
| تبلیغات بینابینی پاداشدار | |
| بومی | ۲ |
۱- یکپارچهسازی آبشاری در مرحله آلفا است.
۲ تمام قالبهای تبلیغاتی پشتیبانیشدهی دیگر، علاوه بر بنرها، در مرحلهی آلفا هستند.
الزامات
- اندروید API سطح ۲۴ یا بالاتر
آخرین GMA Next-Gen 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 برای Ad Manager ایجاد کنید .
قبل از نهایی شدن برنامه، ورودیهای مناسب برای اضافه کردن به app-ads.txt به شما نمایش داده میشود.
برای اطلاعات بیشتر در مورد نحوه پیادهسازی app-ads.txt برای PubMatic، به نحوه پیادهسازی app-ads.txt مراجعه کنید.
شناسه پروفایل
پس از ایجاد برنامه، به برگه برنامهها بروید و شناسه پروفایل برنامه تازه ایجاد شده خود را یادداشت کنید.
ایجاد واحد تبلیغاتی
در زیر تب واحدهای تبلیغاتی (Ad Units )، برنامهای را که در بخش قبلی ایجاد کردهاید انتخاب کنید و روی دکمهی ایجاد واحد تبلیغاتی (Create Ad Unit) کلیک کنید.
فرم را با جزئیات واحد تبلیغاتی خود پر کنید و روی ذخیره کلیک کنید.
شناسه واحد تبلیغاتی OpenWrap که به تازگی ایجاد کردهاید را یادداشت کنید.
شناسه ناشر خود را دریافت کنید
به داشبورد آنالیتیکس بروید. نشانگر ماوس را روی آیکون پروفایل نگه دارید و شناسه خود را یادداشت کنید.
مرحله ۲: تنظیم تقاضای PubMatic در رابط کاربری Ad Manager
وارد حساب مدیر تبلیغات خود شوید.
افزودن PubMatic OpenWrap SDK به شرکتها
مناقصه
این مرحله برای ادغامهای پیشنهاد قیمت لازم نیست.
آبشار
به بخش مدیریت > شرکتها بروید، سپس در تب «همه شرکتها» روی دکمه «شرکت جدید» کلیک کنید. شبکه تبلیغاتی را انتخاب کنید.
PubMatic OpenWrap SDK را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید.
نیازی به وارد کردن نام کاربری یا رمز عبور نیست. پس از اتمام، روی ذخیره کلیک کنید.
اشتراکگذاری امن سیگنال را فعال کنید
مناقصه
به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراکگذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
سیگنال امن را در درخواستهای پیشنهاد به اشتراک بگذارید
مناقصه
به Inventory > Secure Signals بروید. در زیر Secure signals ، PubMatic را جستجو کنید و گزینه Enable app integration را فعال کنید.
روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
امکان اشتراکگذاری امن سیگنال برای مناقصه SDK
مناقصه
به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیشفرض ، گزینه «اجازه اشتراکگذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.
روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
پیکربندی مناقصه PubMatic OpenWrap SDK
مناقصه
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
روی پیشنهاددهنده جدید کلیک کنید.
PubMatic OpenWrap SDK را به عنوان پیشنهاد دهنده انتخاب کنید.
برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.
روی انجام شد کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
پیکربندی نگاشت واحد تبلیغات
مناقصه
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
شرکت PubMatic OpenWrap SDK را انتخاب کنید.
به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.
واحد تبلیغاتی خاص را انتخاب کنید. یک واحد تبلیغاتی و قالب آن، برنامه موبایل را به عنوان نوع موجودی و برنامه موبایل خود انتخاب کنید. سپس، شناسه واحد تبلیغاتی OpenWrap را که در بخش قبل به دست آوردهاید، وارد کنید.
در نهایت، روی ذخیره کلیک کنید.
آبشار
به بخش تحویل > گروههای بازده بروید و روی دکمهی گروه بازده جدید کلیک کنید. برنامهی موبایل خود را انتخاب کنید.
به پایین اسکرول کنید و روی افزودن شریک عملکرد کلیک کنید.
شرکتی را که برای PubMatic OpenWrap SDK در بخش قبل ایجاد کردید، انتخاب کنید. در قسمت Integration type گزینه Mobile SDK mediation ، در قسمت Platform گزینه Android و در قسمت Status گزینه Active را انتخاب کنید.
شناسه واحد تبلیغاتی OpenWrap که در بخش قبل به دست آوردید و مقدار پیشفرض CPM را وارد کنید. روی ذخیره کلیک کنید.
اضافه کردن PubMatic به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده
برای افزودن PubMatic به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری مدیریت تبلیغات، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
مرحله 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.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
implementation("com.google.ads.mediation:pubmatic:5.0.0.0")
}
configurations {
all {
exclude(group = "com.google.android.gms", module = "play-services-ads")
exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}
}
مرحله ۴: تنظیمات حریم خصوصی را در PubMatic اعمال کنید
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره میانجیگری خود هستید.
PubMatic به طور خودکار رضایت GDPR تنظیم شده توسط پلتفرمهای مدیریت رضایت که از مشخصات رضایت اضافی گوگل ، از جمله UMP SDK ، پشتیبانی میکنند را میخواند. برای اطلاعات بیشتر، به Pass GDPR و رضایت GDPR مراجعه کنید.
قوانین حفظ حریم خصوصی ایالتهای آمریکا
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
PubMatic به طور خودکار رضایتنامه GPP تنظیمشده توسط پلتفرمهای مدیریت رضایتنامه که از مشخصات رضایتنامه اضافی گوگل ، از جمله UMP SDK، پشتیبانی میکنند را میخواند. برای اطلاعات بیشتر، به بخش «پذیرش رضایتنامه GPP» مراجعه کنید.
مرحله ۵: اضافه کردن کد مورد نیاز
برای ادغام PubMatic OpenWrap SDK نیازی به کد اضافی نیست.
مرحله ۶: پیادهسازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کردهاید .
تأیید تبلیغات آزمایشی
برای تأیید اینکه تبلیغات آزمایشی را از PubMatic OpenWrap SDK دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های) تبلیغاتی PubMatic OpenWrap فعال کنید.
مراحل اختیاری
تبلیغات بومی
رندرینگ آگهی
آداپتور PubMatic تبلیغات بومی خود را به عنوان اشیاء NativeAd برمیگرداند. این آداپتور فیلدهای زیر را برای یک NativeAd پر میکند.
| میدان | داراییها همیشه توسط آداپتور PubMatic گنجانده میشوند |
|---|---|
| تیتر | |
| تصویر | |
| بدن | |
| آیکون | |
| فراخوان برای اقدام | |
| رتبهبندی ستارهای | |
| فروشگاه | |
| قیمت | |
| تبلیغ کننده |
کدهای خطا
اگر آداپتور نتواند تبلیغی از PubMatic دریافت کند، میتوانید خطای اصلی را از پاسخ تبلیغ با استفاده از ResponseInfo.getAdSourceResponses() تحت کلاسهای زیر بررسی کنید:
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 مراجعه کنید. |