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

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

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

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

یکپارچه سازی
مناقصه	^1
آبشار	^2
فرمت ها
برنامه باز شود
بنر
بینابینی
پاداش داده شد
بینابینی پاداش

¹ ادغام مناقصه در نسخه بتای بسته است (به جز قالب تبلیغات بومی در بتای باز).

² ادغام Waterfall در نسخه بتا بسته است.

الزامات

• جدیدترین SDK تبلیغات موبایل گوگل
  • یونیتی 5.6 یا بالاتر
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک کار Unity پروژه با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

مرحله 1: تنظیمات را در Mintegral UI تنظیم کنید

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

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

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

یک برنامه جدید اضافه کنید

از تب APP Setting ، روی دکمه Add APP کلیک کنید.

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

اندروید

iOS

به شناسه APP برنامه خود توجه داشته باشید.

اندروید

iOS

یک مکان تبلیغاتی ایجاد کنید

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

اندروید

iOS

نام مکان و قالب آگهی را وارد کنید.

مهم: برای قالب تبلیغات بومی، Native (Custom Rendering) را به عنوان AD Format انتخاب کنید.

مناقصه

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

آبشار

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

پس از ایجاد آگهی شما، شناسه قرار دادن را یادداشت کنید.

اندروید

iOS

روی منوی کشویی 1 AD Units کلیک کنید و شناسه واحد AD را یادداشت کنید.

اندروید

iOS

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

مناقصه

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

آبشار

برای تنظیم شناسه واحد تبلیغات AdMob خود به کلید API گزارش Mintegral نیاز دارید. به Account > API Tools بروید. از آسمان و راز خود یادداشت کنید.

مرحله 2: تقاضای Mintegral را تنظیم کنید Ad Manager UI

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

اندروید

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

iOS

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

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

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

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

توجه: عدم ادغام نسخه‌های سازگار Mintegral و Google Mobile Ads SDK ممکن است منجر به مشکلات ساخت شود.

OpenUPM-CLI

مهم: اگر از استفاده از .unitypackage به استفاده از OpenUPM-CLI مهاجرت می‌کنید، باید با حذف همه فایل‌ها از پوشه Assets/GoogleMobileAds/Mediation/Mintegral دارایی‌ها را از محل قدیمی حذف نصب کنید.

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

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

OpenUPM

مهم: اگر از استفاده از .unitypackage به استفاده از OpenUPM مهاجرت می‌کنید، باید با حذف همه فایل‌ها از پوشه Assets/GoogleMobileAds/Mediation/Mintegral دارایی‌ها را از محل قدیمی حذف نصب کنید.

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

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

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

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

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

پکیج یونیتی

آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل برای 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 شما کپی می کند.

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

اندروید

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

iOS

ادغام SKAdNetwork

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

مرحله 5: اجرای خود را آزمایش کنید

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

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

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

مهم: قبل از انتشار برنامه، حالت تست AdMob و Mintegral را غیرفعال کنید.

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

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

کدهای خطا

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

اندروید

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

iOS

GADMediationAdapterMintegral

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

اندروید

کد خطا	دامنه	دلیل
101	com.google.ads.mediation.mintegral	پارامترهای سرور نامعتبر (مثلاً شناسه برنامه یا شناسه مکان وجود ندارد).
102	com.google.ads.mediation.mintegral	اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده Mintegral مطابقت ندارد.
103	com.google.ads.mediation.mintegral	پاسخ پیشنهادی موجود نیست یا نامعتبر است.
104	com.google.ads.mediation.mintegral	Mintegral SDK یک خطای عدم پر کردن را برگرداند.

iOS

کد خطا	دامنه	دلیل
101	com.google.mediation.mintegral	پارامترهای سرور نامعتبر (مثلاً شناسه برنامه یا شناسه مکان وجود ندارد).
102	com.google.mediation.mintegral	Mintegral SDK یک خطای عدم پر کردن را برگرداند.
103	com.google.mediation.mintegral	Mintegral SDK نتوانست تبلیغی را نشان دهد.
104	com.google.mediation.mintegral	اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده Mintegral مطابقت ندارد.

Mintegral Unity Mediation Plugin Changelog

نسخه 1.8.3

• از آداپتور اندروید Mintegral نسخه 16.8.61.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.7.3.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 9.3.0 ساخته و آزمایش شده است.

نسخه 1.8.2

• از آداپتور اندروید Mintegral نسخه 16.8.61.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.7.2.1 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.1.

نسخه 1.8.1

• از آداپتور اندروید Mintegral نسخه 16.8.51.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.7.2.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.

نسخه 1.8.0

• از آداپتور اندروید Mintegral نسخه 16.8.31.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.7.0.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.

نسخه 1.7.0

• DummyClient به PlaceholderClient تغییر نام داد.
• از آداپتور اندروید Mintegral نسخه 16.8.11.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.6.9.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.

نسخه 1.6.5

• از آداپتور اندروید Mintegral نسخه 16.7.81.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.6.8.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.

نسخه 1.6.4

• از آداپتور اندروید Mintegral نسخه 16.7.61.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.6.7.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.

نسخه 1.6.3

• از آداپتور اندروید Mintegral نسخه 16.7.41.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.6.6.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.

نسخه 1.6.2

• از آداپتور اندروید Mintegral نسخه 16.7.41.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.6.4.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.

نسخه 1.6.1

• از آداپتور اندروید Mintegral نسخه 16.7.21.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.6.3.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.

نسخه 1.6.0

• از آداپتور اندروید Mintegral نسخه 16.7.11.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.6.2.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.0.0.

نسخه 1.5.0

• از آداپتور اندروید Mintegral نسخه 16.6.71.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.6.0.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.0.0.

نسخه 1.4.0

• از آداپتور اندروید Mintegral نسخه 16.6.34.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.5.6.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 8.7.0 ساخته و آزمایش شده است.

نسخه 1.3.0

• از آداپتور اندروید Mintegral نسخه 16.5.91.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.5.3.0 پشتیبانی می کند.
• متدهای زیر را به کلاس Mintegral اضافه کرد:
  • SetConsentStatus(bool)
  • SetDoNotTrackStatus(bool)
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 8.6.0.

نسخه 1.2.1

• از آداپتور اندروید Mintegral نسخه 16.4.61.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.3.8.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 8.3.0 ساخته و آزمایش شده است.

نسخه 1.2.0

• محتوای آداپتور به GoogleMobileAds/Mediation/Mintegral/ منتقل شد.
• از آداپتور اندروید Mintegral نسخه 16.4.41.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.3.6.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 8.3.0 ساخته و آزمایش شده است.

نسخه 1.1.0

• از آداپتور اندروید Mintegral نسخه 16.3.61.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.2.9.1 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.4.1 ساخته و آزمایش شده است.

نسخه 1.0.0

• انتشار اولیه!
• از آداپتور اندروید Mintegral نسخه 16.2.61.0 پشتیبانی می کند.
• از آداپتور iOS Mintegral نسخه 7.2.6.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.3.1 ساخته و آزمایش شده است.