با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Mintegral با استفاده از AdMob Mediation استفاده کنید، که هم ادغام آبشار و هم یکپارچهسازی پیشنهادها را پوشش میدهد. نحوه افزودن Mintegral به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Mintegral SDK و آداپتور در یک برنامه Android را پوشش میدهد.
ادغام ها و فرمت های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای Mintegral دارای قابلیت های زیر است:
یکپارچه سازی
مناقصه
آبشار
فرمت ها
برنامه باز شود
بنر
بینابینی
پاداش داده شد
بینابینی پاداش
بومی
الزامات
Android API سطح 23 یا بالاتر
[برای مناقصه]: برای ادغام همه قالبهای تبلیغاتی پشتیبانی شده در مناقصه، از آداپتور Mintegral 16.5.91.1 یا بالاتر ( آخرین نسخه توصیه میشود ) استفاده کنید.
به برگه تنظیمات برنامه بروید و کلید APP را یادداشت کنید.
یک برنامه جدید اضافه کنید
از تب APP Setting ، روی دکمه Add APP کلیک کنید.
پلتفرم را انتخاب کنید و بقیه فرم را پر کنید. سپس، روی ذخیره کلیک کنید.
به شناسه APP برنامه خود توجه داشته باشید.
یک مکان تبلیغاتی ایجاد کنید
هنگامی که برنامه شما ایجاد شد، به برگه Placements & Units بروید و مطابق شکل زیر بر روی دکمه Add Placement کلیک کنید تا محل تبلیغات خود را ایجاد کنید.
نام مکان و قالب آگهی را وارد کنید.
مناقصه
Header Bidding را به عنوان نوع مناقصه انتخاب کنید. بقیه فرم را پر کنید و روی ذخیره کلیک کنید.
آبشار
آبشار را به عنوان نوع پیشنهاد انتخاب کنید. بقیه فرم را پر کنید و روی ذخیره کلیک کنید.
پس از ایجاد آگهی شما، شناسه قرار دادن را یادداشت کنید.
روی منوی کشویی 1 AD Units کلیک کنید و شناسه واحد AD را یادداشت کنید.
کلید API گزارش Mintegral خود را پیدا کنید
مناقصه
این مرحله برای ادغام پیشنهادها لازم نیست.
آبشار
برای تنظیم شناسه واحد تبلیغات AdMob خود به کلید API گزارش Mintegral نیاز دارید. به Account > API Tools بروید. از آسمان و راز خود یادداشت کنید.
app-ads.txt خود را به روز کنید
فروشندگان مجاز برای برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا مطمئن شوید موجودی آگهیهای برنامه شما فقط از طریق کانالهایی که بهعنوان مجاز شناسایی کردهاید فروخته میشود. برای جلوگیری از ضرر قابل توجه در درآمد تبلیغات، باید فایل app-ads.txt را پیاده سازی کنید. اگر قبلاً این کار را انجام نداده اید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .
مرحله 2: تقاضای Mintegral را در رابط کاربری AdMob تنظیم کنید تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
باید Mintegral را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.
ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر یک گروه میانجی موجود دارید که میخواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید، و به افزودن Mintegral به عنوان منبع آگهی بروید.
برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.
قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی Continue کلیک کنید.
به گروه میانجی خود یک نام بدهید و مکانهایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.
این گروه میانجی را با یک یا چند واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید.
اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کردهاید مشاهده کنید:
Mintegral را به عنوان منبع تبلیغاتی اضافه کنید
مناقصه در زیر کارت مناقصه در بخش منابع آگهی ، افزودن منبع آگهی را انتخاب کنید. سپس Mintegral را انتخاب کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر قبلاً نقشه ای برای Mintegral دارید، می توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.
سپس کلید برنامه ، شناسه برنامه ، شناسه مکان و شناسه واحد آگهی را که در بخش قبل به دست آمدهاند وارد کنید. سپس روی Done کلیک کنید.
آبشار در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید.
Mintegral را انتخاب کنید. سپس یک مقدار eCPM برای Mintegral وارد کنید و روی Continue کلیک کنید.
اگر قبلاً نقشه ای برای Mintegral دارید، می توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید. سپس کلید برنامه ، شناسه برنامه ، شناسه مکان و شناسه واحد آگهی را که در بخش قبل به دست آمدهاند وارد کنید. سپس روی Done کلیک کنید.
Mobvista/Mintegral را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید
سپس، در فایل build.gradle.kts در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه های Mintegral SDK و آداپتور استفاده کنید:
به مصنوعات آداپتور Mintegral در مخزن Maven Google بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور Mintegral را دانلود کرده و آن را به پروژه خود اضافه کنید.
مرحله 4: تنظیمات حریم خصوصی را در Mintegral SDK اجرا کنید رضایت اتحادیه اروپا و GDPR
برای پیروی از خطمشی رضایت کاربر اتحادیه اروپا Google ، باید اطلاعات مشخصی را به کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس ارائه کنید و رضایت آنها را برای استفاده از کوکیها یا سایر فضای ذخیرهسازی محلی در مواردی که از نظر قانونی لازم است، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات کسب کنید. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع آگهی در زنجیره میانجی شما هستید. Google نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.
Mintegral SDK شامل روش setConsentStatus برای ارسال اطلاعات رضایت به Mintegral SDK است.
کد نمونه زیر نحوه ارسال اطلاعات رضایت به Mintegral SDK را نشان می دهد. این گزینهها باید قبل از راهاندازی SDK تبلیغات موبایلی Google تنظیم شوند تا مطمئن شوید که به درستی به Mintegral SDK بازارسال میشوند.
قوانین حفظ حریم خصوصی ایالات ایالات متحده مستلزم اعطای حق انصراف به کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف از طریق پیوند برجسته "اطلاعات شخصی من را نفروشید" در صفحه اصلی طرف "فروشنده" ارائه می شود. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکههای تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنماییهای هر یک از آن شبکهها برای اطمینان از رعایت آن پیروی کنید.
Mintegral SDK شامل متد setDoNotTrackStatus برای ارسال اطلاعات رضایت به Mintegral SDK است.
کد نمونه زیر نحوه ارسال اطلاعات رضایت به Mintegral SDK را نشان می دهد. اگر میخواهید با این روش تماس بگیرید، پس از راهاندازی SDK تبلیغات موبایلی Google، اما قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK، با آن تماس بگیرید.
Mintegral برای دریافت آگهیهای آزمایشی Mintegral برای بنرها، قالبهای تبلیغاتی با پاداش و بومی، توصیه میکند از کلیدهای برنامه، شناسههای برنامه، شناسههای مکان و شناسههای واحد آگهی ارائه شده در صفحه شناسه آزمون Mintegral استفاده کنید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را از Mintegral دریافت میکنید، با استفاده از منبع(های) آگهی Mintegral (مناقصه) و Mintegral (آبشار)آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
مراحل اختیاریMintegral را به لیست شرکای تبلیغاتی CCPA اضافه کنید
برای افزودن Mintegral به لیست شرکای تبلیغاتی CCPA در رابط کاربری AdMob، مراحل موجود در تنظیمات CCPA را دنبال کنید.
تبلیغات بومی رندر آگهی
آداپتور Mintegral تبلیغات بومی خود را به عنوان اشیاء NativeAd برمی گرداند. فیلدهای زیر را برای NativeAd پر می کند.
میدان
دارایی ها همیشه توسط آداپتور Mintegral گنجانده شده است
1 آداپتور Mintegral دسترسی مستقیم به دارایی تصویر اصلی را برای تبلیغات بومی خود فراهم نمی کند. در عوض، آداپتور MediaView با یک ویدیو یا یک تصویر پر می کند.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از Mintegral دریافت کند، میتوانید با استفاده از ResponseInfo.getAdapterResponses() در کلاسهای زیر، خطای اساسی را از پاسخ آگهی بررسی کنید:
تاریخ آخرین بهروزرسانی 2025-10-07 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-10-07 بهوقت ساعت هماهنگ جهانی."],[],["This guide outlines how to integrate Mintegral ad mediation into AdMob for Android apps. Key actions include configuring your Mintegral account by creating an app, noting its App ID/Key, setting up ad placements, and retrieving IDs. In AdMob, create a mediation group, add Mintegral as an ad source (either bidding or waterfall), and input the Mintegral App ID/Key. Import the Mintegral SDK and adapter into Android Studio, configure privacy settings, then test the integration with test ads. The guide details supported ad formats and troubleshooting steps.\n"]]