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

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

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

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

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

الزامات

  • آخرین افزونه تبلیغات موبایلی گوگل برای یونیتی
    • یونیتی ۵.۶ یا بالاتر
    • [برای پیشنهاد قیمت]: برای ادغام تمام قالب‌های تبلیغاتی پشتیبانی‌شده در پیشنهاد قیمت، از افزونه‌ی میانجیگری تبلیغات موبایلی گوگل برای Mintegral 1.4.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
    • برای نصب روی اندروید
      • اندروید API سطح ۲۳ یا بالاتر
    • برای استقرار در iOS
      • هدف استقرار iOS 12.0 یا بالاتر
    • یک پروژه Unity در حال کار که با افزونه Unity تبلیغات موبایلی گوگل پیکربندی شده است. برای جزئیات بیشتر به بخش «شروع به کار» مراجعه کنید.
    • راهنمای شروع میانجیگری را تکمیل کنید

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

ثبت نام کنید یا وارد حساب کاربری Mintegral خود شوید .

کلید برنامه را پیدا کنید

به برگه تنظیمات برنامه (APP Setting) بروید و کلید برنامه (APP Key) را یادداشت کنید.

افزودن یک برنامه جدید

از تب تنظیمات برنامه ، روی دکمه افزودن برنامه کلیک کنید.

پلتفرم را انتخاب کنید و بقیه فرم را پر کنید. سپس روی ذخیره کلیک کنید.

اندروید

آی‌او‌اس

شناسه برنامه (APP ID) خود را یادداشت کنید.

اندروید

آی‌او‌اس

ایجاد جایگاه تبلیغات

پس از ایجاد برنامه، به برگه Placements & Units بروید و مطابق شکل زیر، روی دکمه Add Placement کلیک کنید تا جایگاه تبلیغ خود را ایجاد کنید.

اندروید

آی‌او‌اس

نام محل قرارگیری و قالب AD را وارد کنید.

نوع پیشنهاد قیمت را به صورت Header Bidding انتخاب کنید. بقیه فرم را پر کنید و روی ذخیره کلیک کنید.

پس از ایجاد جایگاه تبلیغ، شناسه جایگاه را یادداشت کنید.

اندروید

آی‌او‌اس

روی منوی کشویی «۱ واحد AD» کلیک کنید و شناسه واحد AD را یادداشت کنید.

اندروید

آی‌او‌اس

کلید API گزارش‌دهی Mintegral خود را پیدا کنید

مناقصه

این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.

آبشار

برای تنظیم شناسه واحد تبلیغاتی Ad Manager خود، به کلید API گزارش‌دهی Mintegral خود نیاز دارید. به حساب کاربری > ابزارهای API بروید. کلید و رمز خود را یادداشت کنید.

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

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .

برای پیاده‌سازی app-ads.txt برای Mintegral، به «چگونه app-Ads.txt می‌تواند به مبارزه با کلاهبرداری تبلیغاتی کمک کند» مراجعه کنید.

مرحله ۲: تنظیم تقاضای یکپارچه در رابط کاربری مدیریت تبلیغات

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

اندروید

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

آی‌او‌اس

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

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

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

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

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

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

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

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

در ویرایشگر پروژه یونیتی خود، گزینه 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 Mintegral Mediation را انتخاب کرده و روی نصب کلیک کنید.

نصب از OpenUPM

بسته یونیتی

آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای Mintegral را از لینک دانلود موجود در Changelog دانلود کنید و بسته GoogleMobileAdsMintegralMediation.unitypackage را از فایل زیپ استخراج کنید.

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

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

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

عزم راسخ

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

اندروید

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

آی‌او‌اس

ادغام شبکه SKAd

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

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

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

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

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

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

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

کدهای خطا

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

اندروید 

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

آی‌او‌اس 

GADMediationAdapterMintegral

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

اندروید

کد خطا دامنه دلیل
۱۰۱ com.google.ads.mediation.mintegral پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه قرارگیری وجود ندارد).
۱۰۲ com.google.ads.mediation.mintegral اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط Mintegral مطابقت ندارد.
۱۰۳ com.google.ads.mediation.mintegral پاسخ پیشنهاد نامعتبر یا مفقود است.
۱۰۴ com.google.ads.mediation.mintegral Mintegral SDK خطای عدم پر کردن را برگرداند.

آی‌او‌اس

کد خطا دامنه دلیل
۱۰۱ com.google.mediation.mintegral پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه قرارگیری وجود ندارد).
۱۰۲ com.google.mediation.mintegral Mintegral SDK خطای عدم پر کردن را برگرداند.
۱۰۳ com.google.mediation.mintegral SDK مینتگرال نتوانست تبلیغی را نشان دهد.
۱۰۴ com.google.mediation.mintegral اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط Mintegral مطابقت ندارد.

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

نسخه ۱.۹.۸

نسخه ۱.۹.۷

نسخه ۱.۹.۶

نسخه ۱.۹.۵

نسخه ۱.۹.۴

نسخه ۱.۹.۳

نسخه ۱.۹.۲

نسخه ۱.۹.۱

نسخه ۱.۹.۰

نسخه ۱.۸.۴

نسخه ۱.۸.۳

نسخه ۱.۸.۲

نسخه ۱.۸.۱

نسخه ۱.۸.۰

نسخه ۱.۷.۰

نسخه ۱.۶.۵

نسخه ۱.۶.۴

نسخه ۱.۶.۳

نسخه ۱.۶.۲

نسخه ۱.۶.۱

نسخه ۱.۶.۰

نسخه ۱.۵.۰

نسخه ۱.۴.۰

نسخه ۱.۳.۰

نسخه ۱.۲.۱

نسخه ۱.۲.۰

نسخه ۱.۱.۰

نسخه ۱.۰.۰