این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از PubMatic با استفاده از AdMob Mediation استفاده کنید. نحوه افزودن PubMatic به پیکربندی میانجی واحد تبلیغات و نحوه ادغام PubMatic و آداپتور در یک برنامه iOS را پوشش می دهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای PubMatic دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | |
| فرمت ها | |
| برنامه باز شد | |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
| بینابینی پاداش | |
| بومی | |
الزامات
- هدف استقرار iOS 12.0 یا بالاتر
جدیدترین SDK تبلیغات موبایل گوگل.
راهنمای شروع میانجیگری را کامل کنید.
مرحله 1: تنظیمات را در PubMatic UI تنظیم کنید
وارد حساب PubMatic خود شوید و کارت OpenWrap SDK را انتخاب کنید.
یک برنامه جدید اضافه کنید
به تب Apps بروید و روی دکمه Add App کلیک کنید.
پلتفرم و همچنین URL فروشگاه App و نام برنامه را برای برنامه خود انتخاب کنید.
در قسمت Integration Path ، iOS (Objective-C / Swift) را انتخاب کنید و 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 را وارد کنید
CocoaPods (توصیه می شود)
خط زیر را به Podfile پروژه خود اضافه کنید:
pod 'GoogleMobileAdsMediationPubMatic'از خط فرمان اجرا کنید:
pod install --repo-update
ادغام دستی
آخرین نسخه PubMatic OpenWrap SDK برای iOS را دانلود کنید و همه فایل‌ها و بسته‌های
.xcframeworkرا در پروژه خود پیوند دهید.آخرین نسخه آداپتور PubMatic را از لینک دانلود در Changelog دانلود کنید و
PubMaticAdapter.xcframeworkرا در پروژه خود پیوند دهید.
مرحله 4: تنظیمات حریم خصوصی را در PubMatic SDK اجرا کنید
برای پیروی از خط‌مشی رضایت کاربر اتحادیه اروپا Google ، باید اطلاعات مشخصی را به کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس ارائه کنید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر فضای ذخیره‌سازی محلی در مواردی که از نظر قانونی لازم است، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات کسب کنید. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع آگهی در زنجیره میانجی شما هستید.
PubMatic به‌طور خودکار رضایت GDPR تنظیم شده توسط پلت‌فرم‌های مدیریت رضایت که از مشخصات رضایت اضافی Google ، از جمله UMP SDK، پشتیبانی می‌کنند، می‌خواند. برای اطلاعات بیشتر، به مجوز GDPR و GDPR مراجعه کنید.
قوانین حفظ حریم خصوصی ایالات متحده
قوانین حفظ حریم خصوصی ایالات ایالات متحده مستلزم اعطای حق انصراف به کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف از طریق پیوند برجسته "اطلاعات شخصی من را نفروشید" در صفحه اصلی طرف "فروشنده" ارائه می شود. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.
PubMatic به‌طور خودکار رضایت GPP تنظیم شده توسط پلت‌فرم‌های مدیریت رضایت را که از مشخصات رضایت اضافی Google ، از جمله UMP SDK، پشتیبانی می‌کنند، می‌خواند. برای اطلاعات بیشتر، به مجوز مجوز GPP مراجعه کنید.
مرحله 5: کد مورد نیاز را اضافه کنید
ادغام SKAdNetwork
مستندات PubMatic را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.
مرحله 6: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهی‌های آزمایشی را از PubMatic OpenWrap SDK دریافت می‌کنید، با استفاده از منبع(های ) آگهی PubMatic (مناقصه ) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
مراحل اختیاری
تبلیغات بومی
رندر آگهی
آداپتور PubMatic تبلیغات بومی خود را به عنوان اشیاء GADNativeAd برمی گرداند. فیلدهای زیر را برای GADNativeAd پر می کند.
| میدان | دارایی ها همیشه توسط آداپتور PubMatic گنجانده شده است |
|---|---|
| تیتر | |
| تصویر | |
| بدن | |
| نماد | |
| فراخوان به اقدام | |
| امتیاز ستاره | |
| فروشگاه | |
| قیمت | |
| تبلیغ کننده |
کدهای خطا
اگر آداپتور نتواند تبلیغی را از PubMatic دریافت کند، می‌توانید با استفاده از GADResponseInfo.adNetworkInfoArray در کلاس‌های زیر، خطای اساسی را از پاسخ آگهی بررسی کنید:
GADMediationAdapterPubMatic
در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور PubMatic هنگام بارگیری نشدن آگهی ارسال می‌شوند:
| کد خطا | دامنه | دلیل |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | پیکربندی سرور فاقد شناسه ناشر مورد نیاز است. |
| 102 | com.google.ads.mediation.pubmatic | درخواست جمع آوری سیگنال مناقصه ناموفق بود زیرا چندین قالب، بدون قالب یا قالب پشتیبانی نشده در پارامترهای درخواست مشخص شده بود. |
| 103 | com.google.ads.mediation.pubmatic | پیکربندی تبلیغ نامعتبر برای بارگیری آگهی. |
| 104 | com.google.ads.mediation.pubmatic | به دلیل آماده نبودن آگهی، تبلیغ بینابینی ارائه نشد. |
| 105 | com.google.ads.mediation.pubmatic | به دلیل آماده نبودن آگهی، تبلیغ با پاداش ارائه نشد. |
| 106 | com.google.ads.mediation.pubmatic | یکی از منابع تصویر تبلیغاتی بومی بارگیری نشد. |
| 1001-5002 | ارسال شده توسط PubMatic SDK | PubMatic SDK یک خطا برگرداند. برای جزئیات بیشتر به مستندات PubMatic مراجعه کنید. |
تغییرات آداپتور میانجیگری PubMatic iOS
نسخه 4.8.1.1 (در حال انجام)
- از فرمت آگهی بینابینی آبشاری پشتیبانی می کند.
- از فرمت تبلیغاتی با جایزه آبشاری پشتیبانی می کند.
- از فرمت تبلیغاتی بنر آبشاری پشتیبانی می کند.
- از فرمت تبلیغات بومی آبشار پشتیبانی می کند.
- رفع اشکالی که نماینده تبلیغات بومی به درستی تنظیم نشده بود.
- شامل Info.plist در فریمورک ها می باشد.
نسخه 4.8.1.0
- سازگاری تایید شده با PubMatic OpenWrap SDK نسخه 4.8.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.9.0.
- PubMatic OpenWrap SDK نسخه 4.8.1.
نسخه 4.8.0.0
- سازگاری تایید شده با PubMatic OpenWrap SDK نسخه 4.8.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.8.0.
- PubMatic OpenWrap SDK نسخه 4.8.0.
نسخه 4.7.0.0
- انتشار اولیه
- از مناقصه برای قالب های تبلیغاتی بنر، بینابینی، پاداش و بومی پشتیبانی می کند.
- سازگاری تایید شده با PubMatic OpenWrap SDK نسخه 4.7.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.6.0.
- PubMatic OpenWrap SDK نسخه 4.7.0.