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

همرسانی نشان امن در درخواستهای پیشنهاد قیمت
به موجودی > سیگنالهای امن پیمایش کنید. در بخش نشانهای ایمن، Moloco Ads SDK را جستجو کنید و فعال کردن ادغام برنامه را روشن کنید.

روی ذخیره کلیک کنید.
اجازه دادن به همرسانی سیگنال امن برای «پیشنهاد قیمت کیت توسعه نرمافزار»
به تحویل > تنظیمات کانال تقاضا بروید. در برگه تنظیمات پیشفرض، اجازه دادن به همرسانی سیگنال ایمن را برای پیشنهاد قیمت کیت توسعه نرمافزار روشن کنید.

روی ذخیره کلیک کنید.
پیکربندی پیشنهاد قیمت Moloco
به ارائه > پیشنهاددهندگان قیمت بروید و روی رفتن به «پیشنهاد قیمت کیت توسعه نرمافزار» کلیک کنید.

روی پیشنهاددهنده جدید کلیک کنید.

Moloco Ads را بهعنوان پیشنهاددهنده قیمت انتخاب کنید.

برای فعال کردن «پیشنهاد قیمت کیت توسعه نرمافزار» برای این پیشنهاددهنده قیمت، روی ادامه کلیک کنید.

روی تمام کلیک کنید.
پیکربندی تخصیص واحد آگهی
به ارائه > پیشنهاددهندگان قیمت بروید و روی رفتن به «پیشنهاد قیمت کیت توسعه نرمافزار» کلیک کنید.

شرکت را برای «کیت توسعه نرمافزار Moloco Ads» انتخاب کنید.

به برگه تخصیص واحد آگهی بروید و روی تخصیص واحد آگهی جدید کلیک کنید.

واحد آگهی خاص را انتخاب کنید. واحد آگهی و قالب را انتخاب کنید، برنامه تلفن همراه را بهعنوان نوع موجودی و برنامه تلفن همراه خود را انتخاب کنید. سپس، کلید برنامه و شناسه واحد آگهی را که در بخش قبلی بهدست آوردهاید وارد کنید.
درنهایت، روی ذخیره کلیک کنید.

افزودن Moloco Ads به فهرست شرکای آگهی تحت مقررات اروپا و ایالتهای ایالات متحده
مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید تا آگهیهای Moloco را به فهرست شرکای آگهی مقررات اروپا و ایالتی ایالات متحده در «میانای کاربری Ad Manager» اضافه کنید.
مرحله ۳: وارد کردن کیت توسعه نرمافزار و آداپتور 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) است. شما مسئولید که تأیید کنید رضایت به هر منبع آگهی در زنجیره میانجیگری شما منتقل شده است.
نسخه آداپتور Android کیت توسعه نرمافزار Moloco Ads
3.5.0.0
و نسخههای جدیدتر از انتقال نشانهای موافقت «مقررات عمومی حفاظت از دادهها» از پلاتفرمهای مدیریت موافقت
که با «چارچوب شفافسازی و کسب رضایت» (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 مراجعه کنید.
مرحله ۵: آزمایش پیادهسازی
فعال کردن آگهیهای آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کردهاید.
درستیسنجی آگهیهای آزمایشی
برای تأیید اینکه آگهیهای آزمایشی را از 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 4.13.0.
نسخه 4.12.0.1
- وابستگی Kotlin آداپتور را به ۱.۹.۰ (حداقل نسخه Kotlin پشتیبانیشده توسط کیت توسعه نرمافزار GMA NextGen) سنجاق کنید.
ساخته و آزمایششده با:
- نسخه ۲۵.۴.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۴.۰ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- Moloco SDK نسخه ۴.۱۲.۰.
نسخه ۴.۱۲.۰.۰
- سازگاری با Moloco SDK 4.12.0 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۴.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۴.۰ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- Moloco SDK نسخه ۴.۱۲.۰.
نسخه ۴.۱۱.۱.۰
- بهروزرسانی شد تا ظهور آگهی را هنگام نمایش آگهی بومی گزارش کند.
- آگهیهای برنمای ثابت برای فراخوانی
onAdOpenedتماس برگشتی هنگام کلیک شدن بهجای نمایش داده شدن. - سازگاری با Moloco SDK نسخه ۴.۱۱.۱ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۴.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۳.۱ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه ۴.۱۱.۱ «کیت توسعه نرمافزار Moloco».
نسخه 4.11.0.0
- پشتیبانی از برنمای تطبیقی را به آداپتور میانجیگری Moloco اضافه میکند.
- سازگاری با Moloco SDK نسخه 4.11.0 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۵.۴.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۱.۳.۱ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- Moloco SDK نسخه ۴.۱۱.۰.
نسخه ۴.۱۰.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۱۰.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۵.۴.۰.
- نسخه ۱.۲.۱ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- Moloco SDK نسخه ۴.۱۰.۱.
نسخه ۴.۱۰.۰.۰
- Maps
AgeRestrictedTreatmentبه تنظیمات محدودیت سنی Moloco. - سازگاری با Moloco SDK نسخه ۴.۱۰.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۵.۴.۰.
- نسخه ۱.۲.۱ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- Moloco SDK نسخه ۴.۱۰.۰.
نسخه ۴.۹.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۹.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۳.۰.
- نسخه ۱.۱.۱ «کیت توسعه نرمافزار نسل بعدی تبلیغات تلفن همراه Google».
- نسخه Moloco SDK 4.9.0.
نسخه ۴.۹.۰.۰ (درحال انجام)
نسخه ۴.۸.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۸.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۲.۰.
- نسخه ۱.۰.۱ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- Moloco SDK نسخه ۴.۸.۱.
نسخه ۴.۸.۰.۰
- بهروزرسانی شد تا بهجای بافت فعالیت، بافت برنامه به Moloco.initialize() ارسال شود تا از نشت حافظه جلوگیری شود.
- سازگاری با Moloco SDK 4.8.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۲.۰.
- نسخه 0.25.0-beta01 کیت توسعه نرمافزار نسل بعدی «آگهیهای تلفن همراه Google».
- Moloco SDK نسخه ۴.۸.۰.
نسخه ۴.۷.۰.۰
- ویژگیای برای ساختن آداپتور با وابستگی کیت توسعه نرمافزار GMA Next-Gen اضافه شد.
- سازگاری با Moloco SDK نسخه ۴.۷.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۱.۰.
- نسخه 0.25.0-beta01 کیت توسعه نرمافزار نسل بعدی «آگهیهای تلفن همراه Google».
- Moloco SDK نسخه ۴.۷.۰.
نسخه ۴.۶.۰.۰
- سازگاری با Moloco SDK 4.6.0 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۹.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- Moloco SDK نسخه ۴.۶.۰.
نسخه ۴.۵.۰.۰
- سازگاری با Moloco SDK 4.5.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
- Moloco SDK نسخه ۴.۵.۰.
نسخه ۴.۴.۰.۰
- سازگاری با Moloco SDK 4.4.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
- نسخه ۴.۴.۰ کیت توسعه نرمافزار Moloco.
نسخه ۴.۳.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۳.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۴.۸.۰.
- Moloco SDK نسخه ۴.۳.۱.
نسخه ۴.۲.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۲.۱ درستیسنجی شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
- Moloco SDK نسخه ۴.۲.۱.
نسخه ۴.۲.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۲.۰ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۷.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه ۴.۲.۰ «کیت توسعه نرمافزار Moloco».
نسخه ۴.۱.۱.۰
- سازگاری با 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 3.12.1.
نسخه ۳.۱۲.۰.۰
- سازگاری با Moloco SDK نسخه 3.12.0 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۴.۰ کیت توسعه نرمافزار آگهی تلفن همراه Google.
- نسخه Moloco SDK 3.12.0.
نسخه ۳.۱۱.۰.۰
- سازگاری با Moloco SDK نسخه 3.11.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۴.۰.
- Moloco SDK نسخه ۳.۱۱.۰.
نسخه ۳.۱۰.۰.۰
- سازگاری با Moloco SDK نسخه ۳.۱۰.۰ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۳.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- Moloco SDK نسخه ۳.۱۰.۰.
نسخه 3.9.0.0
- سازگاری با Moloco SDK نسخه ۳.۹.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۲.۰.
- نسخه ۳.۹.۰ «کیت توسعه نرمافزار Moloco».
نسخه ۳.۸.۰.۱
- پشتیبانی از اندازه آگهی برنمایی مستطیل متوسط اضافه شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۱.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه کیت توسعه نرمافزار Moloco ۳.۸.۰.
نسخه ۳.۸.۰.۰
- پشتیبانی پیشنهاد قیمت برای قالب آگهی بومی اضافه شد.
- سازگاری با Moloco SDK نسخه ۳.۸.۰ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۱.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- Moloco SDK نسخه ۳.۸.۰.
نسخه ۳.۷.۲.۰
- سازگاری با Moloco SDK نسخه 3.7.2 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۰.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه Moloco SDK 3.7.2.
نسخه ۳.۷.۱.۰
- حداقل سطح میانای برنامهسازی کاربردی Android موردنیاز به ۲۳ بهروزرسانی شد.
- حداقل نسخه موردنیاز «کیت توسعه نرمافزار تبلیغات تلفن همراه Google» به ۲۴.۰.۰ بهروزرسانی شد.
- سازگاری با Moloco SDK نسخه ۳.۷.۱ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۴.۰.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه Moloco SDK 3.7.1.
نسخه ۳.۷.۰.۰
- سازگاری با Moloco SDK نسخه 3.7.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۳.۶.۰.
- نسخه کیت توسعه نرمافزار Moloco 3.7.0.
نسخه ۳.۶.۱.۰
- سازگاری با Moloco SDK 3.6.1 تأیید شد.
ساخته و آزمایششده با:
- نسخه ۲۳.۶.۰ «کیت توسعه نرمافزار آگهی تلفن همراه Google».
- نسخه کیت توسعه نرمافزار Moloco 3.6.1.
نسخه ۳.۶.۰.۰
- سازگاری با Moloco SDK نسخه 3.6.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۳.۶.۰.
- Moloco SDK نسخه ۳.۶.۰.
نسخه ۳.۵.۰.۰
- نسخهٔ پخش اولیه.
- پشتیبانی از پیشنهاد قیمت برای قالبهای آگهی برنما، بینابینی، و پاداشدار اضافه شد.
- سازگاری با Moloco SDK 3.5.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۳.۶.۰.
- Moloco SDK نسخه ۳.۵.۰.