ادغام Mintegral با مناقصه (بتا)

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

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

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

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

الزامات

• Android API سطح 21 یا بالاتر

• [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی شده در مناقصه، از آداپتور Mintegral 16.5.91.1 یا بالاتر ( آخرین نسخه توصیه می‌شود ) استفاده کنید.

• جدیدترین SDK تبلیغات موبایل گوگل

• راهنمای شروع میانجیگری را کامل کنید

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

به حساب Ad Manager خود وارد شوید.

اضافه کردن Mintegral در شرکت ها

اشتراک گذاری سیگنال ایمن را فعال کنید

مناقصه Mintegral را پیکربندی کنید

پیکربندی نقشه واحد تبلیغات

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

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

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

ادغام Android Studio (توصیه می شود)

در فایل settings.gradle.kts سطح پروژه خود، مخازن زیر را اضافه کنید:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
  }
}

سپس، در فایل build.gradle.kts در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه های Mintegral SDK و آداپتور استفاده کنید:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:mintegral:16.8.61.0")
}

ادغام دستی

1. برای گنجاندن Mintegral SDK، به Mintegral SDK برای Android بروید.

2. به مصنوعات آداپتور Mintegral در مخزن Maven Google بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور Mintegral را دانلود کرده و آن را به پروژه خود اضافه کنید.

مرحله 4: تنظیمات حریم خصوصی را در Mintegral SDK اجرا کنید

رضایت اتحادیه اروپا و GDPR

تحت «خط‌مشی رضایت کاربر اتحادیه اروپا» Google، باید اطمینان حاصل کنید که اطلاعات مشخصی در رابطه با استفاده از شناسه‌های دستگاه و داده‌های شخصی به کاربران منطقه اقتصادی اروپا (EEA) داده می‌شود و از آنها رضایت گرفته می‌شود. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. هنگام درخواست رضایت، باید هر شبکه تبلیغاتی را در زنجیره میانجی خود شناسایی کنید که ممکن است داده‌های شخصی را جمع‌آوری، دریافت یا استفاده کند و اطلاعاتی درباره استفاده هر شبکه ارائه دهد. Google در حال حاضر نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.

Mintegral SDK شامل روش setConsentStatus برای ارسال اطلاعات رضایت به Mintegral SDK است.

کد نمونه زیر نحوه ارسال اطلاعات رضایت به Mintegral SDK را نشان می دهد. این گزینه‌ها باید قبل از راه‌اندازی SDK تبلیغات تلفن همراه Google تنظیم شوند تا مطمئن شوید که به درستی به Mintegral SDK بازارسال می‌شوند.

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)

برای اطلاعات بیشتر به اسناد حریم خصوصی Mintegral مراجعه کنید.

قوانین حفظ حریم خصوصی ایالات متحده

قوانین حفظ حریم خصوصی ایالات ایالات متحده مستلزم اعطای حق انصراف به کاربران از «فروش» «اطلاعات شخصی» خود (همانطور که قانون آن شرایط را تعریف می‌کند)، با انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروخت» ارائه می‌کند. در صفحه اصلی حزب "فروش". راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.

Mintegral SDK شامل متد setDoNotTrackStatus برای ارسال اطلاعات رضایت به Mintegral SDK است.

کد نمونه زیر نحوه ارسال اطلاعات رضایت به Mintegral SDK را نشان می دهد. اگر می‌خواهید با این روش تماس بگیرید، پس از راه‌اندازی SDK تبلیغات موبایلی Google ، اما قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK، با آن تماس بگیرید.

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)

برای اطلاعات بیشتر به اسناد حریم خصوصی Mintegral مراجعه کنید.

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

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

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

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

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

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

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

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

مراحل اختیاری

Mintegral را به لیست شرکای تبلیغاتی CCPA اضافه کنید

برای افزودن Mintegral به لیست شرکای تبلیغاتی CCPA در رابط کاربری Ad Manager مراحل را در تنظیمات CCPA دنبال کنید.

تبلیغات بومی

رندر آگهی

آداپتور Mintegral تبلیغات بومی خود را به عنوان اشیاء NativeAd برمی گرداند. فیلدهای زیر را برای NativeAd پر می کند.

¹ آداپتور Mintegral دسترسی مستقیم به دارایی تصویر اصلی را برای تبلیغات بومی خود فراهم نمی کند. در عوض، آداپتور MediaView را با یک ویدیو یا یک تصویر پر می کند.

کدهای خطا

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

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

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

Mintegral Android Mediation Adapter Changelog

نسخه بعدی

• Mintegral SDK را در یک رشته پس‌زمینه (برای رفع ANR) راه‌اندازی کنید.

نسخه 16.8.61.0

• سازگاری تایید شده با Mintegral SDK 16.8.61.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.3.0.
• Mintegral SDK نسخه 16.8.61.

نسخه 16.8.51.0

• سازگاری تایید شده با Mintegral SDK 16.8.51.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.3.0.
• Mintegral SDK نسخه 16.8.51.

نسخه 16.8.41.0

• سازگاری تایید شده با Mintegral SDK 16.8.41.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.3.0.
• Mintegral SDK نسخه 16.8.41.

نسخه 16.8.31.0

• سازگاری تایید شده با Mintegral SDK 16.8.31.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.2.0.
• Mintegral SDK نسخه 16.8.31.

نسخه 16.8.11.0

• سازگاری تایید شده با Mintegral SDK 16.8.11.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.2.0.
• Mintegral SDK نسخه 16.8.11.

نسخه 16.7.91.0

• سازگاری تایید شده با Mintegral SDK 16.7.91.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.2.0.
• Mintegral SDK نسخه 16.7.91.

نسخه 16.7.81.0

• سازگاری تایید شده با Mintegral SDK 16.7.81.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.2.0.
• Mintegral SDK نسخه 16.7.81.

نسخه 16.7.71.0

• سازگاری تایید شده با Mintegral SDK 16.7.71.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.1.0.
• Mintegral SDK نسخه 16.7.71.

نسخه 16.7.61.0

• سازگاری تایید شده با Mintegral SDK 16.7.61.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.1.0.
• Mintegral SDK نسخه 16.7.61.

نسخه 16.7.51.0

• سازگاری تایید شده با Mintegral SDK 16.7.51.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.1.0.
• Mintegral SDK نسخه 16.7.51.

نسخه 16.7.41.0

• سازگاری تایید شده با Mintegral SDK 16.7.41.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.1.0.
• Mintegral SDK نسخه 16.7.41.

نسخه 16.7.31.0

• سازگاری تایید شده با Mintegral SDK 16.7.31.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.1.0.
• Mintegral SDK نسخه 16.7.31.

نسخه 16.7.21.0

• سازگاری تایید شده با Mintegral SDK 16.7.21.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.0.0.
• Mintegral SDK نسخه 16.7.21.

نسخه 16.7.11.0

• سازگاری تایید شده با Mintegral SDK 16.7.11.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.0.0.
• Mintegral SDK نسخه 16.7.11.

نسخه 16.6.71.0

• سازگاری تایید شده با Mintegral SDK 16.6.71.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.0.0.
• Mintegral SDK نسخه 16.6.71.

نسخه 16.6.61.0

• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 23.0.0 به روز شد.
• سازگاری تایید شده با Mintegral SDK 16.6.61.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.0.0.
• Mintegral SDK نسخه 16.6.61.

نسخه 16.6.51.0

• سازگاری تایید شده با Mintegral SDK 16.6.51.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.6.0.
• Mintegral SDK نسخه 16.6.51.

نسخه 16.6.41.0

• سازگاری تایید شده با Mintegral SDK 16.6.41.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.6.0.
• Mintegral SDK نسخه 16.6.41.

نسخه 16.6.34.0

• سازگاری تایید شده با Mintegral SDK 16.6.34.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.6.0.
• Mintegral SDK نسخه 16.6.34.

نسخه 16.6.21.0

• سازگاری تایید شده با Mintegral SDK 16.6.21.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.6.0.
• Mintegral SDK نسخه 16.6.21.

نسخه 16.5.91.1

• پشتیبانی مناقصه برای قالب تبلیغات باز برنامه اضافه شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.6.0.
• Mintegral SDK نسخه 16.5.91.

نسخه 16.5.91.0

• سازگاری تایید شده با Mintegral SDK 16.5.91.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.6.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.6.0.
• Mintegral SDK نسخه 16.5.91.

نسخه 16.5.51.0

• سازگاری تایید شده با Mintegral SDK 16.5.51.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.3.0.
• Mintegral SDK نسخه 16.5.51.

نسخه 16.5.41.0

• سازگاری تایید شده با Mintegral SDK 16.5.41.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.3.0.
• Mintegral SDK نسخه 16.5.41.

نسخه 16.5.31.0

• سازگاری تایید شده با Mintegral SDK 16.5.31.
• آداپتور را به وابستگی به Google Mobile Ads SDK نسخه 22.3.0 برگرداند.
• پشتیبانی از آبشار برای قالب تبلیغات باز برنامه اضافه شده است.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.3.0.
• Mintegral SDK نسخه 16.5.31.

نسخه 16.5.21.0

• سازگاری تایید شده با Mintegral SDK 16.5.21.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.4.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.4.0.
• Mintegral SDK نسخه 16.5.21.

نسخه 16.5.11.0

• پشتیبانی از واترمارک برای تبلیغات مناقصه اضافه شده است.
• سازگاری تایید شده با Mintegral SDK 16.5.11.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.2.0.
• Mintegral SDK نسخه 16.5.11.

نسخه 16.4.91.0

• سازگاری تایید شده با Mintegral SDK 16.4.91.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.2.0.
• Mintegral SDK نسخه 16.4.91.

نسخه 16.4.81.0

• سازگاری تایید شده با Mintegral SDK 16.4.81.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.2.0.
• Mintegral SDK نسخه 16.4.81.

نسخه 16.4.71.0

• سازگاری تایید شده با Mintegral SDK 16.4.71.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.2.0.
• Mintegral SDK نسخه 16.4.71.

نسخه 16.4.61.0

• سازگاری تایید شده با Mintegral SDK 16.4.61.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.1.0.
• Mintegral SDK نسخه 16.4.61.

نسخه 16.4.51.0

• سازگاری تایید شده با Mintegral SDK 16.4.51.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.1.0.
• Mintegral SDK نسخه 16.4.51.

نسخه 16.4.41.0

• مشکلی که در آن بنرهای تبلیغاتی با اندازه های نادرست ارائه می شدند برطرف شد.
• سازگاری تایید شده با Mintegral SDK 16.4.41.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.0.0.
• Mintegral SDK نسخه 16.4.41.

نسخه 16.4.31.0

• سازگاری تایید شده با Mintegral SDK 16.4.31.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.0.0.
• Mintegral SDK نسخه 16.4.31.

نسخه 16.4.21.0

• آداپتور به‌روزرسانی شده برای استفاده از کلاس جدید VersionInfo .
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.0.0 به روز شد.
• سازگاری تایید شده با Mintegral SDK 16.4.21.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.0.0.
• Mintegral SDK نسخه 16.4.21.

نسخه 16.3.91.0

• سازگاری تایید شده با Mintegral SDK 16.3.91.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.5.0.
• Mintegral SDK نسخه 16.3.91.

نسخه 16.3.81.0

• سازگاری تایید شده با Mintegral SDK 16.3.81.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.5.0.
• Mintegral SDK نسخه 16.3.81.

نسخه 16.3.71.0

• سازگاری تایید شده با Mintegral SDK 16.3.71.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.5.0.
• Mintegral SDK نسخه 16.3.71.

نسخه 16.3.61.0

• سازگاری تایید شده با Mintegral SDK 16.3.61.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.5.0.
• Mintegral SDK نسخه 16.3.61.

نسخه 16.3.51.1

• پشتیبانی از آبشار برای بنر (شامل MREC)، فرمت های تبلیغاتی بینابینی، پاداش و بومی اضافه شده است.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 21.5.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.5.0.
• Mintegral SDK نسخه 16.3.51.

نسخه 16.3.51.0

• سازگاری تایید شده با Mintegral SDK 16.3.51.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.4.0.
• Mintegral SDK نسخه 16.3.51.

نسخه 16.3.41.0

• سازگاری تایید شده با Mintegral SDK 16.3.41.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.4.0 به روز کرد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.4.0.
• Mintegral SDK نسخه 16.3.41.

نسخه 16.3.11.0

• سازگاری تایید شده با Mintegral SDK 16.3.11.
• آداپتور را به‌روزرسانی کرد تا هنگام نمایش آگهی‌های دارای پاداش onUserEarnedReward() را قبل از onAdClosed() بفرستد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.3.0.
• Mintegral SDK نسخه 16.3.11.

نسخه 16.2.61.0

• انتشار اولیه!
• پشتیبانی مناقصه برای بنر (شامل MREC)، قالب‌های تبلیغاتی بینابینی، پاداش و بومی اضافه شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.3.0.
• Mintegral SDK نسخه 16.2.61.