ادغام i-mobile با میانجی‌گری

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

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

میانای داشبورد i-mobile از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و شرح‌هایش استفاده می‌کند. نماگرفت‌های این راهنما ترجمه نشده‌اند. اما در توضیحات و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل انگلیسی‌شان در پرانتز ترجمه شده‌اند.

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

آداپتور میانجی Ad Manager برای i-mobile قابلیت‌های زیر را دارد:

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

پیش‌نیازها

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

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

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

    ثبت‌نام کنید یا به حساب i-mobile خود وارد شوید.

    با کلیک کردن روی برگه サイト／アプリ管理 (مدیریت سایت/برنامه) و دکمه پلاتفرم برنامه‌تان، برنامه خود را به داشبورد i-mobile اضافه کنید.

    Android

    iOS

    فرم را تکمیل کنید و روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.

    Android

    iOS

    برای ایجاد «جایگاه آگهی» جدید، برنامه‌تان را در برگه サイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.

    Android

    iOS

    به برگه 広告スポット管理 (مدیریت جایگاه آگهی) بروید و روی دکمه 新規広告スポット (جایگاه آگهی جدید) کلیک کنید.

    create_ad_spot

    سپس، فرم را با ارائه 広告スポット名 (نام جایگاه آگهی)، 広告スポットサイズ (اندازه جایگاه آگهی) و جزئیات دیگر تکمیل کنید. سپس روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.

    new_ad_spot_form

    جایگاه آگهی جدیدتان آماده است. برای مشاهده جزئیات یکپارچه‌سازی آن، روی دکمه アプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.

    ad_spot_list

    パブリッシャーID (شناسه ناشر)، メディアID (شناسه رسانه)، و スポットID (شناسه نقطه) را یادداشت کنید. بعداً هنگام پیکربندی i-mobile برای میانجی‌گری در میانای کاربری Ad Manager به این پارامترها نیاز خواهید داشت.

    Android

    iOS

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

    Authorized Sellers for Apps app-ads.txt ابتکاری از IAB Tech Lab است که کمک می‌کند مطمئن شوید فضای آگهی برنامه‌تان فقط ازطریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از افت قابل‌توجه در درآمد آگهی، باید فایل app-ads.txt را پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، فایل app-ads.txt برای Ad Manager ایجاد کنید.

    برای پیاده‌سازی app-ads.txt برای i-mobile، پرسشگان آن‌ها را ببینید.

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

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

    Android

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

    iOS

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

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

    OpenUPM-CLI

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

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

    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 Registries

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

    نصب از OpenUPM

    بسته Unity

    جدیدترین نسخه افزونه میانجی Google Mobile Ads برای i-mobile را از پیوند بارگیری در گزارش تغییرات بارگیری کنید و GoogleMobileAdsIMobileMediation.unitypackage را از فایل zip استخراج کنید.

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

    وارد کردن از Unity

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

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

    مرحله ۴: کد اضافی لازم است

    Android

    برای ادغام i-mobile به کد دیگری نیاز نیست.

    iOS

    ادغام SKAdNetwork

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

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

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

    مطمئن شوید دستگاه آزمایشی‌تان را برای Ad Manager ثبت کرده باشید. i-mobile برای آزمایش، شناسه Spot، شناسه رسانه، و شناسه ناشر آزمایشی ارائه می‌دهد، می‌توانید آن‌ها را اینجا پیدا کنید.

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

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

    کدهای خطا

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

    Android

    قالب نام کلاس
    برنما com.google.ads.mediation.imobile.IMobileAdapter
    بینابینی com.google.ads.mediation.imobile.IMobileAdapter
    بومی com.google.ads.mediation.imobile.IMobileMediationAdapter

    iOS

    قالب نام کلاس
    برنما IMobileAdapter
    بینابینی IMobileAdapter
    بومی GADMediationAdapterIMobile

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

    Android

    کد خطا استدلال
    0-99 کیت توسعه نرم‌افزار i-mobile خطایی برگرداند. برای جزئیات بیشتر، کد را ببینید.
    ۱۰۱ i-mobile برای بار کردن آگهی‌ها به بافت Activity نیاز دارد.
    102 پارامترهای سرور i-mobile پیکربندی‌شده در Ad Manager UI وجود ندارد یا نامعتبر است.
    103 اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده i-mobile مطابقت ندارد.
    104 فراخوان برگشتی موفقیت بار کردن آگهی بومی i-mobile فهرست آگهی‌های بومی خالی برگرداند.

    iOS

    کد خطا استدلال
    0-10 کیت توسعه نرم‌افزار i-mobile خطایی برگرداند. برای جزئیات بیشتر، کد را ببینید.
    ۱۰۱ پارامترهای سرور i-mobile پیکربندی‌شده در Ad Manager UI وجود ندارد یا نامعتبر است.
    102 اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده i-mobile مطابقت ندارد.
    103 i-mobile نتوانست آگهی ارائه دهد.
    104 i-mobile آرایه آگهی بومی خالی برگرداند.
    ۱۰۵ i-mobile نتوانست دارایی‌های آگهی بومی را بارگیری کند.
    106 i-mobile از درخواست برای چند آگهی بینابینی بااستفاده از یک «شناسه جایگاه» پشتیبانی نمی‌کند.

    گزارش تغییرات افزایه میانجی‌گری i-mobile Unity

    نسخه ۱.۳.۱۶

    نسخه ۱.۳.۱۵

    نسخه ۱.۳.۱۴

    نسخه ۱.۳.۱۳

    نسخه ۱.۳.۱۲

    نسخه ۱.۳.۱۱

    نسخه ۱.۳.۱۰

    نسخه ۱.۳.۹

    نسخه ۱.۳.۸

    نسخه ۱.۳.۷

    نسخه ۱.۳.۶

    نسخه ۱.۳.۵

    نسخه ۱.۳.۴

    نسخه ۱.۳.۳

    نسخه ۱.۳.۲

    نسخه ۱.۳.۱

    نسخه ۱.۳.۰

    نسخه ۱.۲.۲

    نسخه ۱.۲.۱

    نسخه ۱.۲.۰

    نسخه ۱.۱.۰

    نسخه ۱.۰.۲

    نسخه ۱.۰.۱

    نسخه ۱.۰.۰