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

پلاتفرم را انتخاب کنید: Android iOS Unity Flutter Android (Legacy)

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads Unity Plugin برای بار کردن و نمایش دادن آگهی‌های maio بااستفاده از میانجی‌گری استفاده کنید، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن maio به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کیت توسعه نرم‌افزار و آداپتور maio در برنامه Unity را پوشش می‌دهد.

میانای داشبورد maio از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و شرح‌هایش استفاده می‌کند و نماگرفت‌های این راهنما ترجمه نشده است. بااین‌حال، در شرح‌ها و دستورالعمل‌های اینجا، برچسب‌ها و دکمه‌ها با معادل انگلیسی آن‌ها نام برده می‌شوند. "URL スキーム," for example, is "URL Scheme,".

یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده

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

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

پیش‌نیازها

قبل‌از ادامه دادن، موارد زیر را تأیید کنید:

  • جدیدترین نسخه Google Mobile Ads Unity Plugin.
  • نسخه ۴ یا بالاتر «ویرایشگر Unity».
  • برای استقرار در Android
    • Android API سطح ۲۴ یا بالاتر.
  • برای استقرار در iOS
    • هدف استقرار iOS نسخه ۱۵.۰ یا جدیدتر.
  • پروژه Unity فعال که با Google Mobile Ads Unity Plugin پیکربندی شده باشد. برای جزئیات، راه‌اندازی Google Mobile Ads Unity Plugin را ببینید.
  • میانجی‌گری را راه‌اندازی کنید.

    • مرحله ۱: راه‌اندازی پیکربندی‌ها در میانای کاربری maio

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

    زبانه مربوط به نوع آگهی ترجیحی‌تان را انتخاب کنید.

    بینابینی

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

    Android

    iOS

    پاداش

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

    Android

    iOS

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

    Android

    iOS

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

    Android

    iOS

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

    مرحله ۲: راه‌اندازی تقاضای maio در میانای کاربر Ad Manager

    پیکربندی تنظیمات میانجی‌گری برای واحد آگهی

    Android

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

    iOS

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

    مرحله ۳: وارد کردن کیت توسعه نرم‌افزار maio و آداپتور

    OpenUPM-CLI

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

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

    OpenUPM

    در ویرایشگر پروژه Unity، ویرایش > تنظیمات پروژه > مدیر بسته را انتخاب کنید تا تنظیمات مدیر بسته Unity باز شود.

    در برگه Scoped Registries،‏ OpenUPM را به‌عنوان یک scoped registry با جزئیات زیر اضافه کنید:

    • نام: OpenUPM
    • نشانی وب: https://package.openupm.com
    • حوزه(ها): com.google

    جزئیات OpenUPM

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

    ثبت‌های Unity

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

    نصب از OpenUPM

    بسته Unity

    جدیدترین نسخه افزونه میانجی‌گری «تبلیغات Google برای تلفن همراه» را برای maio از پیوند بارگیری در گزارش تغییرات بارگیری کنید و GoogleMobileAdsMaioMediation.unitypackage را از فایل zip استخراج کنید.

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

    وارد کردن از Unity

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

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

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

    Android

    برای ادغام maio به کد دیگری نیاز نیست.

    iOS

    یکپارچه‌سازی SKAdNetwork

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

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

    فعال کردن آگهی‌های آزمایشی

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

    ناشرانی که از نسخه ۷.۲۶.۰ یا بالاتر Google Mobile Ads Unity Plugin استفاده می‌کنند به‌طور خودکار آگهی‌های آزمایشی از maio در تلفن‌ها و رایانه‌های لوحی ثبت‌شده به‌عنوان دستگاه‌های آزمایشی هنگام درخواست دریافت خواهند کرد.

    درستی‌سنجی آگهی‌های آزمایشی

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

    کدهای خطا

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

    Android

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

    iOS

    قالب نام کلاس
    بینابینی GADMMaioInterstitialAdapter
    پاداش GADMMaioRewardedAdapter

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

    Android

    کد خطا استدلال
    0-10 ‫maio خطای مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، کد و اسناد maio را ببینید.
    ۱۰۱ Maio آگهی دردسترس ندارد.
    102 پارامترهای سرور نامعتبر است (برای نمونه، «شناسه جای آگهی» وجود ندارد).
    103 زمینه استفاده‌شده برای بار کردن آگهی نمونه `Activity` نبود.

    iOS

    کد خطا استدلال
    0-10 ‫maio خطای ویژه‌ای برای کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، کد maio را ببینید.
    ۱۰۱ ‫maio هنوز آگهی دردسترس ندارد.
    102 پارامترهای سرور نامعتبر است (برای نمونه، «شناسه جای آگهی» وجود ندارد).
    103 آداپتور maio از قالب آگهی درخواست‌شده پشتیبانی نمی‌کند.
    104 آگهی‌ای ازقبل برای این پیکربندی شبکه بار شده است.

    تغییر گزارش افزایه واسطه‌گری Unity maio

    نسخه ۳.۱.۱۱

    نسخه ۳.۱.۱۰

    نسخه ۳.۱.۹

    نسخه ۳.۱.۸

    نسخه ۳.۱.۷

    نسخه ۳.۱.۶

    نسخه ۳.۱.۵

    نسخه ۳.۱.۴

    نسخه ۳.۱.۳

    نسخه ۳.۱.۲

    نسخه ۳.۱.۱

    نسخه ۳.۱.۰

    نسخه ۳.۰.۲

    نسخه ۳.۰.۱

    نسخه ۳.۰.۰

    نسخه ۲.۰.۴

    نسخه ۲.۰.۳

    نسخه ۲.۰.۲

    نسخه ۲.۰.۱

    نسخه ۲.۰.۰

    نسخه ۱.۴.۳

    نسخه ۱.۴.۲

    نسخه ۱.۴.۱

    نسخه ۱.۴.۰

    نسخه ۱.۳.۶

    نسخه ۱.۳.۵

    نسخه ۱.۳.۴

    نسخه ۱.۳.۳

    نسخه ۱.۳.۲

    نسخه ۱.۳.۱

    نسخه ۱.۳.۰

    نسخه ۱.۲.۳

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

    نسخه ۱.۲.۲

    • از آداپتور maio Android نسخه 1.1.6.0 پشتیبانی می‌کند.
    • از نسخه 1.4.2.0 آداپتور maio iOS پشتیبانی می‌کند.

    نسخه ۱.۲.۱

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

    نسخه ۱.۲.۰

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

    نسخه ۱.۱.۳

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

    نسخه ۱.۱.۲

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

    نسخه ۱.۱.۱

    • از maio Android adapter نسخه 1.1.1.0 پشتیبانی می‌کند.
    • از نسخه 1.3.1.1 آداپتور maio iOS پشتیبانی می‌کند.

    نسخه ۱.۱.۰

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

    نسخه ۱.۰.۲

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

    نسخه ۱.۰.۱

    • از maio Android SDK نسخه 1.0.7 پشتیبانی می‌کند.
    • از نسخه ۱.۲.۱۹ کیت توسعه نرم‌افزار maio iOS پشتیبانی می‌کند.

    نسخه ۱.۰.۰

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