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

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

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

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

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

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

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

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

شرکت را برای Moloco Ads SDK انتخاب کنید.

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

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

افزودن Moloco Ads به فهرست شرکای آگهی مقررات ایالتی ایالات متحده و اروپا
مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید تا Moloco Ads را به فهرست شرکای آگهی مقررات ایالتی ایالات متحده و اروپا در میانای کاربری 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) است. شما مسئولید که تأیید کنید رضایت به هر منبع آگهی در زنجیره میانجیگری شما منتقل شده است.
نسخه 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 مراجعه کنید.
مرحله ۵: آزمایش پیادهسازی
فعال کردن آگهیهای آزمایشی
مطمئن شوید دستگاه آزمایشیتان را برای 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 Mobile.
- Moloco SDK نسخه ۴.۱۳.۰.
نسخه ۴.۱۲.۰.۱
- وابستگی Kotlin آداپتور را به ۱.۹.۰ (حداقل نسخه Kotlin پشتیبانیشده توسط کیت توسعه نرمافزار GMA NextGen) سنجاق کنید.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۴.۰.
- نسخه ۱.۴.۰ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- Moloco SDK نسخه ۴.۱۲.۰.
نسخه ۴.۱۲.۰.۰
- سازگاری با Moloco SDK نسخه 4.12.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۴.۰.
- نسخه ۱.۴.۰ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- Moloco SDK نسخه ۴.۱۲.۰.
نسخه ۴.۱۱.۱.۰
- بهروزرسانی شد تا ظهور آگهی را هنگام نمایش آگهی بومی گزارش کند.
- آگهیهای برنمای ثابت را اصلاح کردیم تا هنگام کلیک شدن بهجای نمایش داده شدن،
onAdOpenedرا فراخوانی کنند. - سازگاری با Moloco SDK نسخه 4.11.1 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۴.۰.
- کیت توسعه نرمافزار تبلیغات تلفن همراه Google نسل بعدی نسخه ۱.۳.۱.
- Moloco SDK نسخه ۴.۱۱.۱.
نسخه ۴.۱۱.۰.۰
- پشتیبانی از برنمای تطبیقی را به آداپتور میانجی Moloco اضافه میکند.
- سازگاری با Moloco SDK 4.11.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۴.۰.
- کیت توسعه نرمافزار تبلیغات تلفن همراه Google نسل بعدی نسخه ۱.۳.۱.
- Moloco SDK نسخه ۴.۱۱.۰.
نسخه ۴.۱۰.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۱۰.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۴.۰.
- کیت توسعه نرمافزار تبلیغات تلفن همراه Google نسل بعدی نسخه ۱.۲.۱.
- Moloco SDK نسخه ۴.۱۰.۱.
نسخه ۴.۱۰.۰.۰
- با تنظیمات محدودیت سنی Moloco
AgeRestrictedTreatmentمطابقت دارد. - سازگاری با Moloco SDK 4.10.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۴.۰.
- کیت توسعه نرمافزار تبلیغات تلفن همراه Google نسل بعدی نسخه ۱.۲.۱.
- Moloco SDK نسخه ۴.۱۰.۰.
نسخه ۴.۹.۰.۰
- سازگاری با Moloco SDK نسخه 4.9.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۳.۰.
- نسخه ۱.۱.۱ کیت توسعه نرمافزار تبلیغات تلفن همراه Google نسل بعدی.
- Moloco SDK نسخه ۴.۹.۰.
نسخه ۴.۹.۰.۰ (درحال انجام)
نسخه ۴.۸.۱.۰
- سازگاری با Moloco SDK 4.8.1 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۲.۰.
- نسخه ۱.۰.۱ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- Moloco SDK نسخه ۴.۸.۱.
نسخه ۴.۸.۰.۰
- بهروزرسانی شد تا بهجای بافت فعالیت، بافت برنامه به Moloco.initialize() ارسال شود تا از نشت حافظه جلوگیری شود.
- سازگاری با Moloco SDK 4.8.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۲.۰.
- کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile نسخه 0.25.0-beta01.
- Moloco SDK نسخه ۴.۸.۰.
نسخه ۴.۷.۰.۰
- ویژگیای برای ساختن آداپتور با وابستگی GMA Next-Gen SDK اضافه شد.
- سازگاری با 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 نسخه ۲۴.۸.۰.
- Moloco SDK نسخه ۴.۳.۱.
نسخه ۴.۲.۱.۰
- سازگاری با Moloco SDK 4.2.1 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
- Moloco SDK نسخه ۴.۲.۱.
نسخه ۴.۲.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۲.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
- Moloco SDK نسخه ۴.۲.۰.
نسخه ۴.۱.۱.۰
- سازگاری با Moloco SDK 4.1.1 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه 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 نسخه ۳.۱۲.۰.
نسخه 3.11.0.0
- سازگاری با 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 نسخه ۳.۷.۲.
نسخه 3.7.1.0
- حداقل سطح میانای برنامهسازی کاربردی Android موردنیاز به ۲۳ بهروز شد.
- حداقل نسخه موردنیاز «کیت توسعه نرمافزار تبلیغات تلفن همراه Google» به ۲۴.۰.۰ بهروزرسانی شد.
- سازگاری با Moloco SDK نسخه ۳.۷.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۰.۰.
- Moloco SDK نسخه ۳.۷.۱.
نسخه ۳.۷.۰.۰
- سازگاری با Moloco SDK نسخه 3.7.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۳.۶.۰.
- Moloco SDK نسخه ۳.۷.۰.
نسخه 3.6.1.0
- سازگاری با Moloco SDK نسخه ۳.۶.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار 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 نسخه ۳.۵.۰.