ادغام Moloco با میانجیگری

پلتفرم مورد نظر: اندروید، iOS، یونیتی ، فلاتر

این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از Moloco با استفاده از میانجیگری استفاده کنید، و ادغام‌های پیشنهاد قیمت را پوشش می‌دهد. این راهنما نحوه اضافه کردن Moloco به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور Moloco در یک برنامه Flutter را پوشش می‌دهد.

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

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

ادغام
مناقصه
آبشار
قالب‌ها
برنامه باز است
بنر
بینابینی
پاداش داده شده
تبلیغات بینابینی پاداش‌دار
بومی

الزامات

  • جدیدترین SDK تبلیغات موبایلی گوگل
  • فلاتر ۳.۷.۰ یا بالاتر
  • برای نصب روی اندروید
    • اندروید API سطح ۲۳ یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه فلاترِ در حال کار که با SDK تبلیغات موبایلی گوگل پیکربندی شده است. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
  • راهنمای شروع میانجیگری را تکمیل کنید

مرحله ۱: تنظیمات را در رابط کاربری Moloco انجام دهید

وارد پورتال ناشران Moloco شوید .

به تب Overview > Apps بروید، سپس برای ایجاد یک برنامه جدید، روی دکمه Add App کلیک کنید.

تنظیمات سیستم عامل و حریم خصوصی را برای برنامه خود انتخاب کنید، بقیه فرم را پر کنید و سپس روی ایجاد کلیک کنید.

اندروید

آی‌او‌اس

پس از ایجاد برنامه، آن را از تب برنامه‌ها انتخاب کنید تا جزئیات را مشاهده کنید و کلید برنامه (App Key) را یادداشت کنید.

اندروید

آی‌او‌اس

به برگه «نمای کلی» > «واحدهای تبلیغاتی» بروید، برنامه را از منوی کشویی انتخاب کنید و سپس روی «واحد تبلیغاتی جدید» کلیک کنید.

روش مزایده را با انتخاب «قیمت‌گذاری درون‌برنامه‌ای» (In-app bidding) انتخاب کنید و بقیه فرم را پر کنید. سپس روی «ایجاد» (Create) کلیک کنید.

برای مشاهده جزئیات واحد تبلیغاتی تازه ایجاد شده خود، به تب واحدهای تبلیغاتی بروید. شناسه واحد تبلیغاتی (Ad Unit ID) را یادداشت کنید.

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

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

اندروید

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

آی‌او‌اس

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

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

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

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

ادغام از طریق pub.dev

وابستگی زیر را به همراه آخرین نسخه‌های Moloco Ads SDK و آداپتور آن در فایل pubspec.yaml پکیج خود اضافه کنید:

dependencies:
  gma_mediation_moloco: ^2.0.0

ادغام دستی

آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل را برای Moloco Ads SDK دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با اضافه کردن وابستگی زیر، افزونه را در فایل pubspec.yaml خود ارجاع دهید:

dependencies:
  gma_mediation_moloco:
    path: path/to/local/package

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

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

مرحله ۵: پیاده‌سازی خود را آزمایش کنید

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

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

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

برای تأیید اینکه تبلیغات آزمایشی را از Moloco Ads SDK دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در ad inspector با استفاده از منبع(های ) تبلیغاتی Moloco (پیشنهاد ) فعال کنید.

کدهای خطا

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

اندروید 

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

آی‌او‌اس 

MolocoSDK.MolocoError
GADMediationAdapterMoloco

در اینجا کدها و پیام‌های همراه که توسط آداپتور Moloco هنگام عدم بارگیری یک تبلیغ نمایش داده می‌شوند، آمده است:

اندروید

کد خطا دامنه دلیل
۱۰۱ com.google.ads.mediation.moloco کلید برنامه Moloco موجود نیست یا نامعتبر است.
۱۰۲ com.google.ads.mediation.moloco شناسه واحد تبلیغات Moloco موجود نیست یا نامعتبر است.
۱۰۳ com.google.ads.mediation.moloco شیء تبلیغاتی Moloco بازگردانده شده تهی (null) بود.
۱- تا ۵۰۰۰ com.moloco.sdk Moloco SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Moloco مراجعه کنید.

آی‌او‌اس

کد خطا دامنه دلیل
۱۰۱ com.google.ads.mediation.moloco Moloco SDK از نمایش تبلیغات در iOS 12 و پایین‌تر پشتیبانی نمی‌کند.
۱۰۲ com.google.ads.mediation.moloco کلید برنامه Moloco موجود نیست یا نامعتبر است.
۱۰۳ com.google.ads.mediation.moloco شناسه واحد تبلیغات Moloco موجود نیست یا نامعتبر است.
۱۰۴ com.google.ads.mediation.moloco آگهی آماده نمایش نیست.
۱۰۵ com.google.ads.mediation.moloco تبلیغ نمایش داده نشد.
۱۰۶ com.google.ads.mediation.moloco داده‌های رندر برای رندر کردن تبلیغ در دسترس نیست.
۱- تا ۵۰۰۰ ارسال شده توسط Moloco SDK Moloco SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Moloco مراجعه کنید.

تأیید سمت سرور با پاداش

اگر فراخوانی‌های تأیید سمت سرور (SSV) را اعتبارسنجی کنید ، شناسه منبع تبلیغات برای Moloco 8267622065755668722 خواهد بود.

تغییرات آداپتور میانجیگری Moloco Flutter

نسخه ۲.۰.۰ (در حال انجام)

نسخه ۱.۶.۰

نسخه ۱.۵.۰

نسخه ۱.۴.۰

نسخه ۱.۳.۱

نسخه ۱.۳.۰

نسخه ۱.۲.۰

نسخه ۱.۱.۰

نسخه ۱.۰.۰

،
پلتفرم مورد نظر: اندروید، iOS، یونیتی ، فلاتر

این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از Moloco با استفاده از میانجیگری استفاده کنید، و ادغام‌های پیشنهاد قیمت را پوشش می‌دهد. این راهنما نحوه اضافه کردن Moloco به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور Moloco در یک برنامه Flutter را پوشش می‌دهد.

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

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

ادغام
مناقصه
آبشار
قالب‌ها
برنامه باز است
بنر
بینابینی
پاداش داده شده
تبلیغات بینابینی پاداش‌دار
بومی

الزامات

  • جدیدترین SDK تبلیغات موبایلی گوگل
  • فلاتر ۳.۷.۰ یا بالاتر
  • برای نصب روی اندروید
    • اندروید API سطح ۲۳ یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه فلاترِ در حال کار که با SDK تبلیغات موبایلی گوگل پیکربندی شده است. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
  • راهنمای شروع میانجیگری را تکمیل کنید

مرحله ۱: تنظیمات را در رابط کاربری Moloco انجام دهید

وارد پورتال ناشران Moloco شوید .

به تب Overview > Apps بروید، سپس برای ایجاد یک برنامه جدید، روی دکمه Add App کلیک کنید.

تنظیمات سیستم عامل و حریم خصوصی را برای برنامه خود انتخاب کنید، بقیه فرم را پر کنید و سپس روی ایجاد کلیک کنید.

اندروید

آی‌او‌اس

پس از ایجاد برنامه، آن را از تب برنامه‌ها انتخاب کنید تا جزئیات را مشاهده کنید و کلید برنامه (App Key) را یادداشت کنید.

اندروید

آی‌او‌اس

به برگه «نمای کلی» > «واحدهای تبلیغاتی» بروید، برنامه را از منوی کشویی انتخاب کنید و سپس روی «واحد تبلیغاتی جدید» کلیک کنید.

روش مزایده را با انتخاب «قیمت‌گذاری درون‌برنامه‌ای» (In-app bidding) انتخاب کنید و بقیه فرم را پر کنید. سپس روی «ایجاد» (Create) کلیک کنید.

برای مشاهده جزئیات واحد تبلیغاتی تازه ایجاد شده خود، به تب واحدهای تبلیغاتی بروید. شناسه واحد تبلیغاتی (Ad Unit ID) را یادداشت کنید.

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

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

اندروید

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

آی‌او‌اس

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

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

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

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

ادغام از طریق pub.dev

وابستگی زیر را به همراه آخرین نسخه‌های Moloco Ads SDK و آداپتور آن در فایل pubspec.yaml پکیج خود اضافه کنید:

dependencies:
  gma_mediation_moloco: ^2.0.0

ادغام دستی

آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل را برای Moloco Ads SDK دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با اضافه کردن وابستگی زیر، افزونه را در فایل pubspec.yaml خود ارجاع دهید:

dependencies:
  gma_mediation_moloco:
    path: path/to/local/package

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

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

مرحله ۵: پیاده‌سازی خود را آزمایش کنید

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

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

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

برای تأیید اینکه تبلیغات آزمایشی را از Moloco Ads SDK دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در ad inspector با استفاده از منبع(های ) تبلیغاتی Moloco (پیشنهاد ) فعال کنید.

کدهای خطا

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

اندروید 

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

آی‌او‌اس 

MolocoSDK.MolocoError
GADMediationAdapterMoloco

در اینجا کدها و پیام‌های همراه که توسط آداپتور Moloco هنگام عدم بارگیری یک تبلیغ نمایش داده می‌شوند، آمده است:

اندروید

کد خطا دامنه دلیل
۱۰۱ com.google.ads.mediation.moloco کلید برنامه Moloco موجود نیست یا نامعتبر است.
۱۰۲ com.google.ads.mediation.moloco شناسه واحد تبلیغات Moloco موجود نیست یا نامعتبر است.
۱۰۳ com.google.ads.mediation.moloco شیء تبلیغاتی Moloco بازگردانده شده تهی (null) بود.
۱- تا ۵۰۰۰ com.moloco.sdk Moloco SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Moloco مراجعه کنید.

آی‌او‌اس

کد خطا دامنه دلیل
۱۰۱ com.google.ads.mediation.moloco Moloco SDK از نمایش تبلیغات در iOS 12 و پایین‌تر پشتیبانی نمی‌کند.
۱۰۲ com.google.ads.mediation.moloco کلید برنامه Moloco موجود نیست یا نامعتبر است.
۱۰۳ com.google.ads.mediation.moloco شناسه واحد تبلیغات Moloco موجود نیست یا نامعتبر است.
۱۰۴ com.google.ads.mediation.moloco آگهی آماده نمایش نیست.
۱۰۵ com.google.ads.mediation.moloco تبلیغ نمایش داده نشد.
۱۰۶ com.google.ads.mediation.moloco داده‌های رندر برای رندر کردن تبلیغ در دسترس نیست.
۱- تا ۵۰۰۰ ارسال شده توسط Moloco SDK Moloco SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Moloco مراجعه کنید.

تأیید سمت سرور با پاداش

اگر فراخوانی‌های تأیید سمت سرور (SSV) را اعتبارسنجی کنید ، شناسه منبع تبلیغات برای Moloco 8267622065755668722 خواهد بود.

تغییرات آداپتور میانجیگری Moloco Flutter

نسخه ۲.۰.۰ (در حال انجام)

نسخه ۱.۶.۰

نسخه ۱.۵.۰

نسخه ۱.۴.۰

نسخه ۱.۳.۱

نسخه ۱.۳.۰

نسخه ۱.۲.۰

نسخه ۱.۱.۰

نسخه ۱.۰.۰