ادغام 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 UI راه‌اندازی کنید

    ثبت‌نام کنید یا به حساب 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 نصب کرده‌اید، می‌توانید «افزایه میانجی‌گری Google Mobile Ads i-mobile برای Unity» را با اجرای فرمان زیر از فهرست راهنمای ریشه پروژه خود به پروژه‌تان نصب کنید:

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

    OpenUPM

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

    در زبانه ثبت‌های محدود، OpenUPM را به‌عنوان ثبت محدود با جزئیات زیر اضافه کنید:

    • نام: 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» را برای i-mobile از پیوند بارگیری در Changelog بارگیری کنید و GoogleMobileAdsIMobileMediation.unitypackage را از فایل zip استخراج کنید.

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

    وارد کردن از Unity

    سپس دارایی‌ها > مدیر وابستگی خارجی > حل‌کننده Android > حل اجباری را انتخاب کنید. کتابخانه «مدیر وابستگی خارجی» وضوح وابستگی را از ابتدا انجام خواهد داد و وابستگی‌های اعلام‌شده را در دایرکتوری 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» پیکربندی شده‌اند وجود ندارند یا نامعتبر هستند.
    102 اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده i-mobile مطابقت ندارد.
    103 ‫i-mobile نتوانست آگهی ارائه دهد.
    104 i-mobile آرایه آگهی بومی خالی برگرداند.
    ۱۰۵ i-mobile نتوانست دارایی‌های آگهی بومی را بارگیری کند.
    106 i-mobile از درخواست برای چند آگهی بینابینی بااستفاده از یک «شناسه جایگاه» پشتیبانی نمی‌کند.

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

    نسخه ۱.۳.۱۶

    نسخه ۱.۳.۱۵

    نسخه ۱.۳.۱۴

    نسخه ۱.۳.۱۳

    نسخه ۱.۳.۱۲

    نسخه ۱.۳.۱۱

    نسخه ۱.۳.۱۰

    نسخه ۱.۳.۹

    نسخه ۱.۳.۸

    نسخه ۱.۳.۷

    نسخه ۱.۳.۶

    نسخه ۱.۳.۵

    نسخه ۱.۳.۴

    نسخه ۱.۳.۳

    نسخه ۱.۳.۲

    نسخه ۱.۳.۱

    نسخه ۱.۳.۰

    نسخه ۱.۲.۲

    نسخه ۱.۲.۱

    نسخه ۱.۲.۰

    نسخه ۱.۱.۰

    نسخه ۱.۰.۲

    نسخه 1.0.1

    نسخه ۱.۰.۰