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

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

رابط داشبورد maio از متن ژاپنی برای برچسب‌ها، دکمه‌ها و توضیحات خود استفاده می‌کند و تصاویر موجود در این راهنما ترجمه نشده‌اند. با این حال، در توضیحات و دستورالعمل‌های اینجا، به برچسب‌ها و دکمه‌ها با معادل انگلیسی آنها اشاره شده است. به عنوان مثال، "URL スキーム" به معنای "طرح URL" است.

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

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

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

الزامات

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

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

ابتدا، وارد حساب کاربری maio خود شوید یا ثبت نام کنید. روی دکمه مدیریت برنامه در نوار کناری سمت چپ کلیک کنید و روی برنامه جدید کلیک کنید.

برگه مربوط به نوع تبلیغ مورد نظر خود را انتخاب کنید.

بینابینی

نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و آدرس اینترنتی برنامه خود را ارائه دهید. نوع تبلیغ را بینابینی ویدیویی انتخاب کنید و سپس روی به‌روزرسانی کلیک کنید.

اندروید

آی‌او‌اس

پاداش داده شده

نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و آدرس اینترنتی برنامه خود را ارائه دهید. نوع تبلیغ را Video Rewards انتخاب کنید و سپس روی به‌روزرسانی کلیک کنید.

اندروید

آی‌او‌اس

در صفحه مدیریت برنامه ، شناسه رسانه را یادداشت کنید. این شناسه برای تنظیم واحد تبلیغاتی Ad Manager شما در بخش بعدی مورد نیاز است.

اندروید

آی‌او‌اس

در صفحه مدیریت منطقه ، شناسه منطقه را یادداشت کنید. همچنین برای تنظیم واحد تبلیغاتی Ad Manager شما در بخش بعدی مورد نیاز خواهد بود.

اندروید

آی‌او‌اس

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

مرحله ۲: تنظیم درخواست خرید در رابط کاربری مدیریت تبلیغات

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

اندروید

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

آی‌او‌اس

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

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

رابط خط فرمان OpenUPM

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید افزونه Google Mobile Ads maio Mediation را برای Unity با اجرای دستور زیر از دایرکتوری ریشه پروژه خود، روی پروژه خود نصب کنید:

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

اوپن‌یو‌پی‌ام

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

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

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

جزئیات OpenUPM

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

رجیستری‌های یونیتی

بسته Google Mobile Ads Maio Mediation را انتخاب کرده و روی نصب کلیک کنید.

نصب از OpenUPM

بسته یونیتی

آخرین نسخه افزونه Google Mobile Ads mediation برای maio را از لینک دانلود موجود در Changelog دانلود کنید و GoogleMobileAdsMaioMediation.unitypackage را از فایل زیپ استخراج کنید.

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

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

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

عزم راسخ

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

اندروید

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

آی‌او‌اس

ادغام شبکه SKAd

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات maio را دنبال کنید.

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

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

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

ناشرانی که از نسخه ۷.۲۶.۰ یا بالاتر SDK تبلیغات موبایلی گوگل استفاده می‌کنند، هنگام درخواست، به‌طور خودکار تبلیغات آزمایشی را از maio روی تلفن‌ها و تبلت‌هایی که به‌عنوان دستگاه‌های آزمایشی ثبت شده‌اند، دریافت خواهند کرد.

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

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

کدهای خطا

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

اندروید

قالب نام کلاس
بینابینی jp.maio.sdk.android.mediation.admob.adapter.interstitial
پاداش داده شده jp.maio.sdk.android.mediation.admob.adapter.Rewarded

آی‌او‌اس

قالب نام کلاس
بینابینی آداپتور بینابینی GADMMaio
پاداش داده شده آداپتور پاداشی GADMMaio

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

اندروید

کد خطا دلیل
۰-۱۰ maio یک خطای مختص SDK را برگرداند. برای جزئیات بیشتر به کد و مستندات maio مراجعه کنید.
۱۰۱ مایو هیچ تبلیغی در دسترس ندارد.
۱۰۲ پارامترهای سرور نامعتبر است (مثلاً شناسه قرارگیری وجود ندارد).
۱۰۳ زمینه‌ای که برای بارگذاری یک تبلیغ استفاده شده، نمونه‌ای از «فعالیت» نبوده است.

آی‌او‌اس

کد خطا دلیل
۰-۱۰ maio یک خطای مختص SDK را برگرداند. برای جزئیات بیشتر به کد maio مراجعه کنید.
۱۰۱ maio هنوز تبلیغی در دسترس ندارد.
۱۰۲ پارامترهای سرور نامعتبر است (مثلاً شناسه قرارگیری وجود ندارد).
۱۰۳ آداپتور maio از قالب تبلیغاتی که درخواست شده است پشتیبانی نمی‌کند.
۱۰۴ یک تبلیغ از قبل برای این پیکربندی شبکه بارگذاری شده است.

تغییرات افزونه میانجیگری maio Unity

نسخه ۳.۱.۱

نسخه ۳.۱.۰

نسخه ۳.۰.۲

نسخه ۳.۰.۱

نسخه ۳.۰.۰

نسخه ۲.۰.۴

نسخه ۲.۰.۳

نسخه ۲.۰.۲

نسخه ۲.۰.۱

نسخه ۲.۰.۰

نسخه ۱.۴.۳

نسخه ۱.۴.۲

نسخه ۱.۴.۱

نسخه ۱.۴.۰

نسخه ۱.۳.۶

نسخه ۱.۳.۵

نسخه ۱.۳.۴

نسخه ۱.۳.۳

نسخه ۱.۳.۲

نسخه ۱.۳.۱

نسخه ۱.۳.۰

نسخه ۱.۲.۳

  • افزونه برای پشتیبانی از API جدید Rewarded به‌روزرسانی شد.
  • از آداپتور اندروید maio نسخه ۱.۱.۷.۰ پشتیبانی می‌کند.
  • از آداپتور maio iOS نسخه ۱.۴.۶.۰ پشتیبانی می‌کند.

نسخه ۱.۲.۲

  • از آداپتور اندروید maio نسخه ۱.۱.۶.۰ پشتیبانی می‌کند.
  • از آداپتور maio iOS نسخه ۱.۴.۲.۰ پشتیبانی می‌کند.

نسخه ۱.۲.۱

  • از آداپتور اندروید maio نسخه ۱.۱.۶.۰ پشتیبانی می‌کند.
  • از آداپتور maio iOS نسخه ۱.۴.۱.۰ پشتیبانی می‌کند.

نسخه ۱.۲.۰

  • از آداپتور اندروید maio نسخه ۱.۱.۴.۱ پشتیبانی می‌کند.
  • از آداپتور maio iOS نسخه ۱.۴.۰.۰ پشتیبانی می‌کند.

نسخه ۱.۱.۳

  • از آداپتور اندروید maio نسخه ۱.۱.۳.۱ پشتیبانی می‌کند.
  • از آداپتور maio iOS نسخه ۱.۳.۲.۰ پشتیبانی می‌کند.

نسخه ۱.۱.۲

  • از آداپتور اندروید maio نسخه ۱.۱.۳.۰ پشتیبانی می‌کند.
  • از آداپتور maio iOS نسخه ۱.۳.۲.۰ پشتیبانی می‌کند.

نسخه ۱.۱.۱

  • از آداپتور اندروید maio نسخه ۱.۱.۱.۰ پشتیبانی می‌کند.
  • از آداپتور maio iOS نسخه ۱.۳.۱.۱ پشتیبانی می‌کند.

نسخه ۱.۱.۰

  • از آداپتور اندروید maio نسخه ۱.۱.۰.۰ پشتیبانی می‌کند.
  • از آداپتور maio iOS نسخه ۱.۳.۰.۰ پشتیبانی می‌کند.

نسخه ۱.۰.۲

  • از نسخه ۱.۰.۸ کیت توسعه نرم‌افزار اندروید (SDK) پشتیبانی می‌کند.
  • از کیت توسعه نرم‌افزار iOS نسخه ۱.۲.۱۹ پشتیبانی می‌کند.

نسخه ۱.۰.۱

  • از نسخه ۱.۰.۷ کیت توسعه نرم‌افزار اندروید (SDK) پشتیبانی می‌کند.
  • از کیت توسعه نرم‌افزار iOS نسخه ۱.۲.۱۹ پشتیبانی می‌کند.

نسخه ۱.۰.۰

  • اولین انتشار!
  • از نسخه ۱.۰.۶ کیت توسعه نرم‌افزار اندروید (SDK) پشتیبانی می‌کند.
  • از کیت توسعه نرم‌افزار iOS نسخه ۱.۲.۱۸ پشتیبانی می‌کند.