این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Moloco با استفاده از AdMob Mediation استفاده کنید که ادغام‌های مناقصه را پوشش می‌دهد. نحوه افزودن Moloco به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Moloco SDK و آداپتور در یک برنامه Android را پوشش می‌دهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای Moloco دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | |
| فرمت ها | |
| برنامه باز شود | |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
| بینابینی پاداش | |
| بومی | |
الزامات
Android API سطح 23 یا بالاتر
آداپتور Moloco 3.8.0.0 یا بالاتر
جدیدترین SDK تبلیغات موبایل گوگل
راهنمای شروع میانجیگری را کامل کنید.
مرحله 1: تنظیمات را در Moloco UI تنظیم کنید
وارد پورتال Moloco Publisher شوید .
به قسمت نمای کلی > تب Apps بروید، سپس روی دکمه Add App کلیک کنید تا یک برنامه جدید ایجاد کنید.
تنظیمات سیستم عامل و حریم خصوصی را برای برنامه خود انتخاب کنید، بقیه فرم را پر کنید و سپس روی ایجاد کلیک کنید.
پس از ایجاد برنامه، آن را از برگه برنامه‌ها انتخاب کنید تا جزئیات را مشاهده کنید و کلید برنامه را یادداشت کنید.
به برگه نمای کلی > واحدهای آگهی بروید، برنامه را از منوی کشویی انتخاب کنید و سپس روی واحد آگهی جدید کلیک کنید.
مناقصه درون برنامه ای را به عنوان روش مزایده انتخاب کنید و بقیه فرم را پر کنید. سپس روی ایجاد کلیک کنید.
برای مشاهده جزئیات آن، به واحد تبلیغاتی تازه ایجاد شده خود در زیر برگه واحدهای آگهی بروید. به شناسه واحد تبلیغات توجه داشته باشید.
مرحله 2: تقاضای Moloco را در رابط کاربری AdMob تنظیم کنید
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
باید Moloco Ads SDK را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.
ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر گروه میانجی موجودی دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید و به افزودن Moloco Ads SDK به عنوان منبع آگهی بروید.
برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.
قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی Continue کلیک کنید.
به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.
این گروه میانجی را با یک یا چند واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید.
اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کرده‌اید مشاهده کنید:
Moloco Ads SDK را به عنوان منبع آگهی اضافه کنید
در زیر کارت مناقصه در بخش منابع آگهی ، افزودن منبع آگهی را انتخاب کنید. سپس Moloco Ads SDK را انتخاب کنید.روی نحوه امضای قرارداد مشارکت و تنظیم یک شراکت در مناقصه با Moloco Ads SDK کلیک کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر قبلاً نقشه‌ای برای Moloco Ads SDK دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.
در مرحله بعد، App Key و شناسه واحد آگهی را که در بخش قبل به دست آمده‌اید، وارد کنید. سپس روی Done کلیک کنید.
تبلیغات Moloco را به لیست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده اضافه کنید
برای افزودن Moloco Ads به فهرست شرکای آگهی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.
مرحله 3: Moloco SDK و آداپتور را وارد کنید
ادغام Android Studio (توصیه می شود)
در فایل build.gradle.kts در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه های Moloco SDK و آداپتور استفاده کنید:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.google.ads.mediation:moloco:3.12.1.0")
}
مرحله 4: تنظیمات حریم خصوصی را در Moloco SDK اجرا کنید
رضایت اتحادیه اروپا و GDPR
برای پیروی از خط‌مشی رضایت کاربر اتحادیه اروپا Google ، باید اطلاعات مشخصی را به کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس ارائه کنید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر فضای ذخیره‌سازی محلی در مواردی که از نظر قانونی لازم است، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات کسب کنید. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع آگهی در زنجیره میانجی شما هستید. Google نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.
Moloco SDK شامل پرچم isUserConsent برای ارسال اطلاعات رضایت به Moloco SDK است.
کد نمونه زیر نحوه انتقال اطلاعات رضایت به Moloco SDK را نشان می دهد. اگر انتخاب می‌کنید این پرچم‌ها را تنظیم کنید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.
کاتلین
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isUserConsent = true)
MolocoPrivacy.setPrivacy(privacySettings)
جاوا
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
/* isUserConsent */ true,
/* isAgeRestrictedUser */ false,
/* isDoNotSell */ false);
MolocoPrivacy.setPrivacy(privacySettings);
برای اطلاعات بیشتر به مستندات Android SDK Moloco مراجعه کنید.
قوانین حفظ حریم خصوصی ایالات متحده
قوانین حفظ حریم خصوصی ایالات ایالات متحده مستلزم اعطای حق انصراف به کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف از طریق پیوند برجسته "اطلاعات شخصی من را نفروشید" در صفحه اصلی طرف "فروشنده" ارائه می شود. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.
Moloco SDK شامل پرچم isDoNotSell برای ارسال اطلاعات رضایت به Moloco SDK است.
کد نمونه زیر نحوه انتقال اطلاعات رضایت به Moloco SDK را نشان می دهد. اگر انتخاب می‌کنید این پرچم‌ها را تنظیم کنید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.
کاتلین
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)
جاوا
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
/* isUserConsent */ false,
/* isAgeRestrictedUser */ false,
/* isDoNotSell */ true);
MolocoPrivacy.setPrivacy(privacySettings);
برای اطلاعات بیشتر به مستندات Android SDK Moloco مراجعه کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهی‌های آزمایشی را از Moloco Ads SDK دریافت می‌کنید، با استفاده از منبع(های ) آگهی Moloco (مناقصه ) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از Moloco دریافت کند، می‌توانید با استفاده از ResponseInfo.getAdapterResponses() در کلاس‌های زیر، خطای اساسی مربوط به پاسخ آگهی را بررسی کنید:
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور Moloco هنگام بارگیری نشدن آگهی ارسال می‌شوند:
| کد خطا | دامنه | دلیل |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | کلید برنامه Moloco وجود ندارد یا نامعتبر است. |
| 102 | com.google.ads.mediation.moloco | شناسه واحد آگهی Moloco وجود ندارد یا نامعتبر است. |
| 103 | com.google.ads.mediation.moloco | شیء تبلیغ Moloco بازگشتی تهی بود. |
| -1 تا 5000 | com.moloco.sdk | Moloco SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Moloco مراجعه کنید. |
تأیید اعتبار سمت سرور
اگر تماس‌های تأیید سمت سرور (SSV) را تأیید می‌کنید ، شناسه منبع آگهی برای Moloco 8267622065755668722 است.
Moloco Android Mediation Adapter Changelog
نسخه 4.0.0.0 (در حال پیشرفت)
نسخه 3.12.1.0
- سازگاری تایید شده با Moloco SDK 3.12.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.5.0.
- Moloco SDK نسخه 3.12.1.
نسخه 3.12.0.0
- سازگاری تایید شده با Moloco SDK 3.12.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.4.0.
- Moloco SDK نسخه 3.12.0.
نسخه 3.11.0.0
- سازگاری تایید شده با Moloco SDK 3.11.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.4.0.
- Moloco SDK نسخه 3.11.0.
نسخه 3.10.0.0
- سازگاری تایید شده با Moloco SDK 3.10.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.3.0.
- Moloco SDK نسخه 3.10.0.
نسخه 3.9.0.0
- سازگاری تایید شده با Moloco SDK 3.9.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.2.0.
- Moloco SDK نسخه 3.9.0.
نسخه 3.8.0.1
- پشتیبانی از اندازه تبلیغات بنر مستطیلی متوسط اضافه شده است.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.1.0.
- Moloco SDK نسخه 3.8.0.
نسخه 3.8.0.0
- پشتیبانی مناقصه برای قالب تبلیغات بومی اضافه شد.
- سازگاری تایید شده با Moloco SDK 3.8.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.1.0.
- Moloco SDK نسخه 3.8.0.
نسخه 3.7.2.0
- سازگاری تایید شده با Moloco SDK 3.7.2.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.0.0.
- Moloco SDK نسخه 3.7.2.
نسخه 3.7.1.0
- حداقل سطح API Android مورد نیاز را به 23 به روز کرد.
- حداقل نسخه مورد نیاز Google Mobile Ads SDK به 24.0.0 به روز شد.
- سازگاری تایید شده با Moloco SDK 3.7.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 24.0.0.
- Moloco SDK نسخه 3.7.1.
نسخه 3.7.0.0
- سازگاری تایید شده با Moloco SDK 3.7.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 23.6.0.
- Moloco SDK نسخه 3.7.0.
نسخه 3.6.1.0
- سازگاری تایید شده با Moloco SDK 3.6.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 23.6.0.
- Moloco SDK نسخه 3.6.1.
نسخه 3.6.0.0
- سازگاری تایید شده با Moloco SDK 3.6.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 23.6.0.
- Moloco SDK نسخه 3.6.0.
نسخه 3.5.0.0
- انتشار اولیه
- پشتیبانی از مناقصه برای قالب‌های تبلیغاتی بنر، بینابینی و پاداش اضافه شده است.
- سازگاری تایید شده با Moloco SDK 3.5.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 23.6.0.
- Moloco SDK نسخه 3.5.0.