این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK (Legacy) برای بار کردن و نمایش آگهیهای Moloco بااستفاده از میانجیگری AdMob استفاده کنید و ادغامهای پیشنهاد قیمت را پوشش میدهد. این راهنما نحوه افزودن Moloco به پیکربندی میانجیگری واحد آگهی و نحوه ادغام کیت توسعه نرمافزار و آداپتور Moloco در برنامه Android را پوشش میدهد.
یکپارچهسازیها و قالبهای آگهی پشتیبانیشده
آداپتور میانجیگری Moloco قابلیتهای زیر را دارد:
| یکپارچهسازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالبها | |
| صفحه باز شدن برنامه | |
| برنما | |
| بینابینی | |
| پاداش | |
| بینابینی پاداشدار | |
| بومی | |
پیشنیازها
قبلاز ادامه دادن، موارد زیر را تأیید کنید:
Android API سطح ۲۴ یا بالاتر.
آداپتور Moloco نسخه 3.8.0.0 یا بالاتر.
جدیدترین نسخه Google Mobile Ads SDK (Legacy).
مرحله ۱: راهاندازی پیکربندیها در واسط کاربر Moloco
به سیستم «درگاه ناشر Moloco» وارد شوید.
به برگه نمای کلی > برنامهها بروید، سپس روی دکمه افزودن برنامه کلیک کنید تا برنامه جدیدی ایجاد کنید.
سیستمعامل و تنظیمات حریم خصوصی را برای برنامهتان انتخاب کنید، بقیه فرم را تکمیل کنید، و سپس روی ایجاد کلیک کنید.
پساز ایجاد برنامه، آن را از برگه برنامهها انتخاب کنید تا جزئیات را ببینید و کلید برنامه را یادداشت کنید.
به برگه نمای کلی > واحدهای آگهی بروید، برنامه را از منوِ کرکرهای انتخاب کنید، و سپس روی واحد آگهی جدید کلیک کنید.
پیشنهاد قیمت درونبرنامه را بهعنوان روش مزایده انتخاب کنید و بقیه فرم را تکمیل کنید. سپس روی ایجاد کلیک کنید.
به واحد آگهی تازهایجادشده خود در برگه واحدهای آگهی بروید تا جزئیات آن را مشاهده کنید. شناسه واحد آگهی را یادداشت کنید.
مرحله ۲: راهاندازی کردن تقاضای Moloco در واسط کاربر AdMob
پیکربندی تنظیمات میانجیگری برای واحد آگهی شما
باید Moloco Ads SDK را به پیکربندی میانجیگری واحد آگهیتان اضافه کنید.
ابتدا، به سیستم حساب AdMob خود وارد شوید. سپس به برگه میانجیگری بروید. اگر گروه میانجیگری موجودی دارید که میخواهید آن را اصلاح کنید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به افزودن Moloco Ads SDK بهعنوان منبع آگهی بروید.
برای ایجاد گروه میانجیگری جدید، ایجاد گروه میانجیگری را انتخاب کنید.

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

نامی برای گروه میانجیگریتان انتخاب کنید و مکانهای هدف را انتخاب کنید. سپس، وضعیت گروه میانجیگری را روی فعال تنظیم کنید و سپس روی افزودن واحدهای آگهی کلیک کنید.

این گروه میانجی را با یک یا چند واحد آگهی AdMob موجودتان مرتبط کنید. سپس روی تمام کلیک کنید.

اکنون باید کارت واحدهای آگهی را ببینید که با واحدهای آگهی انتخابی شما پر شده است:

افزودن Moloco Ads SDK بهعنوان منبع آگهی
در بخش منابع آگهی، کارت پیشنهاد قیمت را پیدا کنید و افزودن منبع آگهی را انتخاب کنید. سپس Moloco Ads SDK را انتخاب کنید.
روی نحوه امضای قرارداد مشارکت کلیک کنید و مشارکت مزایدهای را با Moloco Ads SDK راهاندازی کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر ازقبل نگاشتی برای Moloco Ads SDK دارید، میتوانید آن را انتخاب کنید. درغیراینصورت، روی افزودن نگاشت کلیک کنید.
سپس کلید برنامه و شناسه واحد آگهی را که در بخش قبلی بهدست آوردید وارد کنید. سپس روی تمام کلیک کنید.
افزودن Moloco Ads به فهرست شرکای آگهی تحت مقررات اروپا و ایالتهای ایالات متحده
مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید تا Moloco Ads را به فهرست شرکای آگهی مقررات ایالتی ایالات متحده و اروپا در میانای کاربری AdMob اضافه کنید.
مرحله ۳: وارد کردن کیت توسعه نرمافزار و آداپتور Moloco
یکپارچهسازی «استودیو Android» (توصیهشده)
در فایل build.gradle.kts سطح برنامه، پیکربندیها و وابستگیهای پیادهسازی زیر را اضافه کنید. از جدیدترین نسخههای کیت توسعه نرمافزار Moloco و
آداپتور استفاده کنید:
dependencies {
implementation("com.google.android.gms:play-services-ads:25.5.0")
implementation("com.google.ads.mediation:moloco:4.13.0.0")
}
مرحله ۴: پیادهسازی تنظیمات حریم خصوصی در Moloco SDK
کسب رضایت اتحادیه اروپا و مقررات کلی حفاظت از داده
برای رعایت کردن «خطمشی Google درخصوص موافقت کاربر اتحادیه اروپا»، باید شفافسازیهای خاصی را برای کاربران ساکن منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس انجام دهید و موافقت آنها را برای استفاده از کوکیها یا دیگر فضاهای ذخیرهسازی محلی در جاهایی که قانون الزام میکند، و برای جمعآوری، همرسانی، و استفاده از دادههای شخصی برای شخصیسازی آگهیها کسب کنید. این خطمشی منعکسکننده الزامات «آییننامه حریمخصوصی الکترونیکی» اتحادیه اروپا و «مقررات کلی حفاظت از داده» (GDPR) است. شما مسئولید که تأیید کنید رضایت به هر منبع آگهی در زنجیره میانجیگری شما منتقل شده است.
نسخه 3.5.0.0 و جدیدترِ آداپتور Android کیت توسعه نرمافزار Moloco Ads از ارسال سیگنالهای کسب رضایت با مقررات کلی حفاظت از داده از پلاتفرمهای مدیریت کسب رضایت که با چارچوب شفافسازی و کسب رضایت (TCF) سازمان تبلیغات تعاملی ادغام میشوند به کیت توسعه نرمافزار Moloco Ads پشتیبانی میکند.
برای اطلاعات بیشتر، به
اسناد MolocoPrivacy مراجعه کنید.
قوانین حریم خصوصی ایالتی در ایالات متحده
قوانین حریم خصوصی ایالتهای امریکا ملزم میکند که به کاربران حق انصراف از «فروش» «اطلاعات شخصی» آنها (طبق تعریف قانون از این اصطلاحات) داده شود و این انصراف ازطریق پیوند برجسته «اطلاعات شخصی من فروخته نشود» در صفحه اصلی طرف «فروشنده» ارائه شود. راهنمای رعایت قوانین حریم خصوصی ایالتهای ایالات متحده امکان فعال کردن پردازش محدود دادهها را برای آگهیرسانی Google فراهم میکند، اما Google نمیتواند این تنظیم را برای هر شبکه آگهی در زنجیره میانجیگری شما اعمال کند. بنابراین، باید هریک از شبکههای آگهی را که ممکن است در فروش اطلاعات شخصی مشارکت داشته باشند در زنجیره میانجیگریتان شناسایی کنید و برای اطمینان از رعایت مقررات، از راهنماییهای هریک از آن شبکهها پیروی کنید.
کیت توسعه نرمافزار Moloco شامل پرچم isDoNotSell برای ارسال اطلاعات رضایت به کیت توسعه نرمافزار Moloco است.
نمونه کد زیر نحوه ارسال اطلاعات رضایت به Moloco SDK را نشان میدهد. اگر تصمیم دارید این پرچمها را تنظیم کنید، توصیه میشود این کار را قبلاز درخواست آگهی ازطریق Google Mobile Ads SDK (Legacy) انجام دهید.
Kotlin
val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)
جاوا
PrivacySettings privacySettings =
new PrivacySettings(
/* isUserConsent= */ false, /* isAgeRestrictedUser= */ false, /* isDoNotSell= */ true);
MolocoPrivacy.setPrivacy(privacySettings);
برای اطلاعات بیشتر، به سند Moloco SDK Android مراجعه کنید.
مرحله ۵: آزمایش پیادهسازی
فعال کردن آگهیهای آزمایشی
مطمئن شوید دستگاه آزمایشیتان را برای AdMob ثبت کردهاید.
درستیسنجی آگهیهای آزمایشی
برای تأیید اینکه آگهیهای آزمایشی را از Moloco Ads SDK دریافت میکنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع (های) آگهی Moloco(Bidding) فعال کنید.
کدهای خطا
اگر آداپتور نتواند آگهیای از Moloco دریافت کند، میتوانید خطای زمینهای را از پاسخ آگهی بااستفاده از
ResponseInfo.getAdapterResponses()
تحت کلاسهای زیر بررسی کنید:
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
در اینجا کدها و پیامهای همراهی که توسط آداپتور Moloco هنگام بارگیری نشدن آگهی ارسال میشوند، آورده شده است:
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱۰۱ | com.google.ads.mediation.moloco | «کلید برنامه Moloco» وجود ندارد یا نامعتبر است. |
| 102 | com.google.ads.mediation.moloco | شناسه واحد آگهی Moloco موجود نیست یا نامعتبر است. |
| 103 | com.google.ads.mediation.moloco | شیء آگهی Moloco برگرداندهشده تهی بود. |
| -۱ تا ۵۰۰۰ | com.moloco.sdk | کیت توسعه نرمافزار Moloco خطایی برگرداند. برای جزئیات بیشتر، به اسناد Moloco مراجعه کنید. |
گزارش تغییرات آداپتور میانجی Moloco Android
نسخه ۴.۱۳.۰.۰
- سازگاری با Moloco SDK نسخه 4.13.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۵.۰.
- نسخه ۱.۵.۰ کیت توسعه نرمافزار تبلیغات تلفن همراه Google نسل بعدی.
- Moloco SDK نسخه ۴.۱۳.۰.
نسخه ۴.۱۲.۰.۱
- وابستگی Kotlin آداپتور را به ۱.۹.۰ (حداقل نسخه Kotlin پشتیبانیشده توسط کیت توسعه نرمافزار GMA NextGen) سنجاق کنید.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۵.۴.۰.
- نسخه ۱.۴.۰ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- Moloco SDK نسخه ۴.۱۲.۰.
نسخه ۴.۱۲.۰.۰
- سازگاری با Moloco SDK 4.12.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۵.۴.۰.
- نسخه ۱.۴.۰ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- Moloco SDK نسخه ۴.۱۲.۰.
نسخه ۴.۱۱.۱.۰
- بهروزرسانی شد تا وقتی آگهی بومی نمایش داده میشود، ظهور آگهی را گزارش کند.
- آگهیهای برنمای ثابت را اصلاح کردیم تا هنگام کلیک شدن بهجای نمایش داده شدن،
onAdOpenedرا فراخوانی کنند. - سازگاری با Moloco SDK نسخه ۴.۱۱.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۵.۴.۰.
- کیت توسعه نرمافزار تبلیغات تلفن همراه Google نسل بعدی نسخه ۱.۳.۱.
- Moloco SDK نسخه ۴.۱۱.۱.
نسخه ۴.۱۱.۰.۰
- پشتیبانی از برنمای تطبیقی را به مبدل میانجی Moloco اضافه میکند.
- سازگاری با Moloco SDK نسخه 4.11.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۵.۴.۰.
- کیت توسعه نرمافزار تبلیغات تلفن همراه Google نسل بعدی نسخه ۱.۳.۱.
- Moloco SDK نسخه ۴.۱۱.۰.
نسخه ۴.۱۰.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۱۰.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۵.۴.۰.
- نسخه ۱.۲.۱ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- Moloco SDK نسخه ۴.۱۰.۱.
نسخه ۴.۱۰.۰.۰
- با تنظیمات محدودیت سنی Moloco
AgeRestrictedTreatmentمطابقت دارد. - سازگاری با Moloco SDK 4.10.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۵.۴.۰.
- نسخه ۱.۲.۱ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- Moloco SDK نسخه ۴.۱۰.۰.
نسخه ۴.۹.۰.۰
- سازگاری با Moloco SDK نسخه 4.9.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۳.۰.
- نسخه ۱.۱.۱ کیت توسعه نرمافزار تبلیغات تلفن همراه Google نسل بعدی.
- Moloco SDK نسخه ۴.۹.۰.
نسخه ۴.۹.۰.۰ (درحال انجام)
نسخه ۴.۸.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۸.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۲.۰.
- نسخه ۱.۰.۱ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- Moloco SDK نسخه ۴.۸.۱.
نسخه ۴.۸.۰.۰
- بهروزرسانی شد تا بهجای بافت فعالیت، بافت برنامه به Moloco.initialize() ارسال شود تا از نشت حافظه جلوگیری شود.
- سازگاری با Moloco SDK 4.8.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۲.۰.
- کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile نسخه 0.25.0-beta01.
- Moloco SDK نسخه ۴.۸.۰.
نسخه ۴.۷.۰.۰
- ویژگیای برای ساختن آداپتور با وابستگی کیت توسعه نرمافزار GMA Next-Gen اضافه شد.
- سازگاری با Moloco SDK نسخه ۴.۷.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۱.۰.
- کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile نسخه 0.25.0-beta01.
- Moloco SDK نسخه ۴.۷.۰.
نسخه ۴.۶.۰.۰
- سازگاری با Moloco SDK نسخه 4.6.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
- Moloco SDK نسخه ۴.۶.۰.
نسخه ۴.۵.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۵.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
- Moloco SDK نسخه ۴.۵.۰.
نسخه ۴.۴.۰.۰
- سازگاری با Moloco SDK 4.4.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
- Moloco SDK نسخه ۴.۴.۰.
نسخه ۴.۳.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۳.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۴.۸.۰.
- Moloco SDK نسخه ۴.۳.۱.
نسخه ۴.۲.۱.۰
- سازگاری با Moloco SDK 4.2.1 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
- Moloco SDK نسخه ۴.۲.۱.
نسخه ۴.۲.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۲.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
- Moloco SDK نسخه ۴.۲.۰.
نسخه ۴.۱.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۱.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
- Moloco SDK نسخه ۴.۱.۱.
نسخه ۴.۱.۰.۰
- سازگاری با Moloco SDK نسخه 4.1.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۶.۰.
- Moloco SDK نسخه ۴.۱.۰.
نسخه ۴.۰.۰.۰
- سازگاری با Moloco SDK 4.0.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۵.۰.
- Moloco SDK نسخه ۴.۰.۰.
نسخه ۳.۱۲.۱.۰
- سازگاری با Moloco SDK نسخه ۳.۱۲.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۵.۰.
- Moloco SDK نسخه ۳.۱۲.۱.
نسخه ۳.۱۲.۰.۰
- سازگاری با Moloco SDK نسخه 3.12.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۴.۰.
- Moloco SDK نسخه ۳.۱۲.۰.
نسخه ۳.۱۱.۰.۰
- سازگاری با Moloco SDK نسخه 3.11.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۴.۰.
- Moloco SDK نسخه ۳.۱۱.۰.
نسخه ۳.۱۰.۰.۰
- سازگاری با Moloco SDK نسخه 3.10.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۳.۰.
- Moloco SDK نسخه ۳.۱۰.۰.
نسخه ۳.۹.۰.۰
- سازگاری با Moloco SDK نسخه ۳.۹.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۲.۰.
- Moloco SDK نسخه ۳.۹.۰.
نسخه ۳.۸.۰.۱
- پشتیبانی از اندازه آگهی برنمای مستطیلی متوسط اضافه شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۱.۰.
- Moloco SDK نسخه ۳.۸.۰.
نسخه ۳.۸.۰.۰
- پشتیبانی از پیشنهاد قیمت برای قالب آگهی بومی اضافه شد.
- سازگاری با Moloco SDK نسخه ۳.۸.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۱.۰.
- Moloco SDK نسخه ۳.۸.۰.
نسخه ۳.۷.۲.۰
- سازگاری با Moloco SDK نسخه 3.7.2 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۰.۰.
- Moloco SDK نسخه ۳.۷.۲.
نسخه ۳.۷.۱.۰
- حداقل سطح میانای برنامهسازی کاربردی Android موردنیاز به ۲۳ بهروز شد.
- حداقل نسخه موردنیاز «کیت توسعه نرمافزار تبلیغات تلفن همراه Google» به ۲۴.۰.۰ بهروزرسانی شد.
- سازگاری با Moloco SDK نسخه ۳.۷.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۰.۰.
- Moloco SDK نسخه ۳.۷.۱.
نسخه ۳.۷.۰.۰
- سازگاری با Moloco SDK نسخه 3.7.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۳.۶.۰.
- Moloco SDK نسخه ۳.۷.۰.
نسخه ۳.۶.۱.۰
- سازگاری با Moloco SDK 3.6.1 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۳.۶.۰.
- Moloco SDK نسخه ۳.۶.۱.
نسخه ۳.۶.۰.۰
- سازگاری با Moloco SDK نسخه 3.6.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۳.۶.۰.
- Moloco SDK نسخه ۳.۶.۰.
نسخه ۳.۵.۰.۰
- نسخهٔ پخش اولیه.
- پشتیبانی از پیشنهاد قیمت برای قالبهای آگهی برنما، بینابینی، و پاداشدار اضافه شد.
- سازگاری با Moloco SDK 3.5.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۳.۶.۰.
- Moloco SDK نسخه ۳.۵.۰.