PubMatic را با میانجیگری ادغام کنید

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از PubMatic با استفاده از AdMob Mediation استفاده کنید. نحوه افزودن PubMatic به پیکربندی میانجی واحد تبلیغات و نحوه ادغام PubMatic SDK و آداپتور در یک برنامه Unity را پوشش می دهد.

ادغام ها و قالب های تبلیغاتی پشتیبانی شده

آداپتور میانجی AdMob برای PubMatic دارای قابلیت های زیر است:

یکپارچه سازی
مناقصه
آبشار
فرمت ها
برنامه باز شود
بنر
بینابینی
پاداش داده شد
بینابینی پاداش

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل
  • یونیتی 2019.4 یا بالاتر
  • برای استقرار در اندروید
    • Android API سطح 23 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

مرحله 1: تنظیمات را در PubMatic UI تنظیم کنید

وارد حساب PubMatic خود شوید و کارت OpenWrap SDK را انتخاب کنید.

یک برنامه جدید اضافه کنید

به تب Apps بروید و روی دکمه Add App کلیک کنید.

داشبورد برنامه ها

پلتفرم و همچنین URL فروشگاه App و نام برنامه را برای برنامه خود انتخاب کنید.

اندروید

در قسمت Integration Path ، Unity را انتخاب کنید و AdMob - SDK Bidding را به عنوان Sub-integration Path انتخاب کنید. سپس روی دکمه Add App کلیک کنید.

فرم جدید اپلیکیشن

iOS

در قسمت Integration Path ، Unity را انتخاب کنید و AdMob - SDK Bidding را به عنوان Sub-integration Path انتخاب کنید. سپس روی دکمه Add App کلیک کنید.

فرم جدید اپلیکیشن

app-ads.txt خود را به روز کنید

فروشندگان مجاز برای برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا مطمئن شوید موجودی آگهی‌های برنامه شما فقط از طریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از ضرر قابل توجه در درآمد تبلیغات، باید فایل app-ads.txt را پیاده سازی کنید. اگر قبلاً این کار را انجام نداده اید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .

قبل از اینکه برنامه شما نهایی شود، ورودی های مناسب برای افزودن به app-ads.txt به شما ارائه می شود.

app-aps.txt

برای اطلاعات بیشتر در مورد نحوه اجرای app-ads.txt برای PubMatic، به نحوه پیاده سازی app-ads.txt مراجعه کنید.

شناسه پروفایل

پس از ایجاد برنامه، به برگه برنامه‌ها بروید و شناسه نمایه برنامه جدید ایجاد شده خود را یادداشت کنید.

شناسه نمایه برنامه

یک واحد تبلیغاتی ایجاد کنید

در تب Units Ad ، برنامه‌ای را که در بخش قبلی ایجاد کرده‌اید انتخاب کنید و روی دکمه Create Ad Unit کلیک کنید.

ایجاد واحد تبلیغات

فرم را با جزئیات واحد تبلیغاتی خود پر کنید و روی ذخیره کلیک کنید.

ایجاد فرم واحد تبلیغات

شناسه واحد تبلیغات OpenWrap تازه ایجاد شده خود را یادداشت کنید.

شناسه واحد تبلیغات برنامه

شناسه ناشر خود را دریافت کنید

به داشبورد Analytics بروید. نشانگر را روی نماد نمایه نگه دارید و شناسه خود را یادداشت کنید.

شناسه ناشر

مرحله 2: تقاضای PubMatic را در رابط کاربری AdMob تنظیم کنید

تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید

اندروید

برای دستورالعمل‌ها، به مرحله 2 در راهنمای Android مراجعه کنید.

iOS

برای دستورالعمل‌ها، مرحله 2 را در راهنمای iOS ببینید.

PubMatic را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید

برای افزودن PubMatic به فهرست شرکای تبلیغات مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

مرحله 3: SDK و آداپتور PubMatic را وارد کنید

OpenUPM-CLI

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای دستور زیر از دایرکتوری ریشه پروژه خود، پلاگین میانجی‌گری PubMatic OpenWrap SDK SDK برای Unity را در پروژه خود نصب کنید:

openupm add com.google.ads.mobile.mediation.pubmatic

OpenUPM

در ویرایشگر پروژه Unity خود، Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.

در برگه Scoped Registries ، OpenUPM را به عنوان یک رجیستری محدوده با جزئیات زیر اضافه کنید:

  • نام: OpenUPM
  • آدرس اینترنتی: https://package.openupm.com
  • محدوده (ها): com.google

جزئیات OpenUPM

سپس به مسیر Window > Package Manager بروید تا Unity Package Manager را باز کنید و My Registries را از منوی کشویی انتخاب کنید.

ثبت واحدها

بسته میانجیگری PubMatic Ads Google Mobile را انتخاب کنید و روی Install کلیک کنید.

از OpenUPM نصب کنید

پکیج یونیتی

آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای PubMatic OpenWrap SDK را از لینک دانلود در Changelog دانلود کنید و GoogleMobileAdsPubMaticMediation.unitypackage را از فایل فشرده استخراج کنید.

در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsPubMaticMediation.unitypackage را که دانلود کرده اید پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.

واردات از یونیتی

سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تفکیک وابستگی را از ابتدا انجام می دهد و وابستگی های اعلام شده را در فهرست Assets/Plugins/Android برنامه Unity شما کپی می کند.

اجباری حل و فصل

مرحله 4: تنظیمات حریم خصوصی را در PubMatic SDK اجرا کنید

برای پیروی از خط‌مشی رضایت کاربر اتحادیه اروپا Google ، باید اطلاعات مشخصی را به کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس ارائه کنید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر فضای ذخیره‌سازی محلی در مواردی که از نظر قانونی لازم است، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات کسب کنید. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع آگهی در زنجیره میانجی شما هستید. Google نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.

PubMatic به‌طور خودکار رضایت GDPR تنظیم شده توسط پلت‌فرم‌های مدیریت رضایت که از مشخصات رضایت اضافی Google ، از جمله UMP SDK، پشتیبانی می‌کنند، می‌خواند. برای اطلاعات بیشتر، به مجوز GDPR و GDPR مراجعه کنید.

قوانین حفظ حریم خصوصی ایالات متحده

قوانین حفظ حریم خصوصی ایالات ایالات متحده مستلزم اعطای حق انصراف به کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف از طریق پیوند برجسته "اطلاعات شخصی من را نفروشید" در صفحه اصلی طرف "فروشنده" ارائه می شود. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.

PubMatic به طور خودکار رضایت CCPA تنظیم شده توسط پلتفرم های مدیریت رضایت را که از مشخصات رضایت اضافی Google پشتیبانی می کنند، از جمله UMP SDK می خواند. برای اطلاعات بیشتر، به تنظیم رشته CCPA مراجعه کنید.

مرحله 5: کد مورد نیاز را اضافه کنید

اندروید

هیچ کد اضافی برای ادغام PubMatic لازم نیست.

iOS

ادغام SKAdNetwork

مستندات PubMatic را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.

مرحله 6: اجرای خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید.

تبلیغات آزمایشی را تأیید کنید

برای تأیید اینکه آگهی‌های آزمایشی را از PubMatic OpenWrap SDK دریافت می‌کنید، با استفاده از منبع(های ) آگهی PubMatic (مناقصه ) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.

کدهای خطا

اگر آداپتور نتواند تبلیغی را از PubMatic دریافت کند، ناشران می‌توانند با استفاده از ResponseInfo در کلاس‌های زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:

اندروید 

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

iOS 

GADMediationAdapterPubMatic

در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور 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 مراجعه کنید.

iOS

کد خطا دامنه دلیل
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 Unity Mediation

نسخه 1.1.0

نسخه 1.0.0