این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از PubMatic با استفاده از AdMob Mediation استفاده کنید. نحوه افزودن 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 برای برنامه خود تنظیم کنید .
قبل از اینکه برنامه شما نهایی شود، ورودی های مناسب برای افزودن به app-ads.txt به شما ارائه می شود.
برای اطلاعات بیشتر در مورد نحوه اجرای app-ads.txt برای PubMatic، به نحوه پیاده سازی app-ads.txt مراجعه کنید.
شناسه پروفایل
پس از ایجاد برنامه، به برگه برنامه‌ها بروید و شناسه نمایه برنامه جدید ایجاد شده خود را یادداشت کنید.
یک واحد تبلیغاتی ایجاد کنید
در تب Units Ad ، برنامه‌ای را که در بخش قبلی ایجاد کرده‌اید انتخاب کنید و روی دکمه Create Ad Unit کلیک کنید.
فرم را با جزئیات واحد تبلیغاتی خود پر کنید و روی ذخیره کلیک کنید.
شناسه واحد تبلیغات OpenWrap تازه ایجاد شده خود را یادداشت کنید.
شناسه ناشر خود را دریافت کنید
به داشبورد Analytics بروید. نشانگر را روی نماد نمایه نگه دارید و شناسه خود را یادداشت کنید.
مرحله 2: تقاضای PubMatic را در رابط کاربری AdMob تنظیم کنید
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
باید PubMatic OpenWrap SDK را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.
ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر گروه میانجی موجودی دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید، و به افزودن PubMatic OpenWrap SDK به‌عنوان منبع آگهی بروید.
برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.
قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی Continue کلیک کنید.
به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.
این گروه میانجی را با یک یا چند واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید.
اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کرده‌اید مشاهده کنید:
PubMatic OpenWrap SDK را به عنوان منبع تبلیغ اضافه کنید
در زیر کارت مناقصه در بخش منابع آگهی ، افزودن منبع آگهی را انتخاب کنید. سپس PubMatic OpenWrap SDK را انتخاب کنید.روی نحوه امضای قرارداد مشارکت و تنظیم یک مشارکت در مناقصه با PubMatic OpenWrap SDK کلیک کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر قبلاً نقشه‌برداری برای PubMatic OpenWrap SDK دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.
در مرحله بعد، شناسه واحد تبلیغات OpenWrap را که در بخش قبل به دست آمده است وارد کنید. سپس روی Done کلیک کنید.
PubMatic را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید
برای افزودن PubMatic به فهرست شرکای تبلیغات مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.
مرحله 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: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهی‌های آزمایشی را از 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.