این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Mintegral با استفاده از میانجیگری استفاده کنید، که هم ادغام آبشار و هم پیشنهاد قیمت را پوشش میدهد. نحوه افزودن Mintegral به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Mintegral SDK و آداپتور در یک Unity برنامه
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
این Ad Manager آداپتور میانجی برای Mintegral دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | 1 |
آبشار | 2 |
فرمت ها | |
برنامه باز شود | |
بنر | |
بینابینی | |
پاداش داده شد | |
بینابینی پاداش |
2 ادغام Waterfall در نسخه بتا بسته است.
الزامات
- جدیدترین SDK تبلیغات موبایل گوگل
- یونیتی 5.6 یا بالاتر
- [برای مناقصه]: برای ادغام همه قالبهای تبلیغاتی پشتیبانی شده در مناقصه، از افزونه میانجیگری تبلیغات موبایلی Google برای Mintegral 1.4.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه میشود )
- برای استقرار در اندروید
- 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
نام مکان و قالب آگهی را وارد کنید.
Header Bidding را به عنوان نوع مناقصه انتخاب کنید. بقیه فرم را پر کنید و روی ذخیره کلیک کنید.
پس از ایجاد آگهی شما، شناسه قرار دادن را یادداشت کنید.
اندروید
iOS
روی منوی کشویی 1 AD Units کلیک کنید و شناسه واحد AD را یادداشت کنید.
اندروید
iOS
کلید API گزارش Mintegral خود را پیدا کنید
مناقصه
این مرحله برای ادغام پیشنهادها لازم نیست.
آبشار
برای تنظیم شناسه واحد تبلیغات Ad Manager خود به کلید API گزارش Mintegral نیاز دارید. به Account > API Tools بروید. از آسمان و راز خود یادداشت کنید.
مرحله 2: تقاضای Mintegral را تنظیم کنید Ad Manager UI
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعملها، به مرحله 2 در راهنمای Android مراجعه کنید.
iOS
برای دستورالعملها، مرحله 2 را در راهنمای iOS ببینید.
اضافه کنید Mintegral به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده
برای افزودن Mobvista/Mintegral به فهرست شرکای آگهی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری Ad Manager، مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.
مرحله 3: Mintegral SDK و آداپتور را وارد کنید
OpenUPM-CLI
اگر OpenUPM-CLI را نصب کردهاید، میتوانید با اجرای دستور زیر از دایرکتوری ریشه پروژه خود، افزونه میانجیگری Mintegral Ads برای Unity را در پروژه خود نصب کنید:
openupm add com.google.ads.mobile.mediation.mintegral
OpenUPM
در ویرایشگر پروژه 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: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید.
Mintegral برای دریافت آگهیهای آزمایشی Mintegral برای بنرها، قالبهای تبلیغاتی با پاداش و بومی، توصیه میکند از کلیدهای برنامه، شناسههای برنامه، شناسههای مکان و شناسههای واحد آگهی ارائه شده در صفحه شناسه آزمون 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 ساخته و آزمایش شده است.