این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Moloco با استفاده از میانجیگری استفاده کنید که ادغام‌های مناقصه را پوشش می‌دهد. نحوه افزودن Moloco به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Moloco SDK و آداپتور در یک برنامه Android را پوشش می‌دهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای Moloco دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | |
| فرمت ها | |
| برنامه باز شود | |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
| بینابینی پاداش | |
| بومی | |
الزامات
Android API سطح 23 یا بالاتر
آداپتور Moloco 3.8.0.0 یا بالاتر
جدیدترین SDK تبلیغات موبایل گوگل
راهنمای شروع میانجیگری را کامل کنید.
مرحله 1: تنظیمات را در Moloco UI تنظیم کنید
وارد پورتال Moloco Publisher شوید .
به قسمت نمای کلی > تب Apps بروید، سپس روی دکمه Add App کلیک کنید تا یک برنامه جدید ایجاد کنید.
تنظیمات سیستم عامل و حریم خصوصی را برای برنامه خود انتخاب کنید، بقیه فرم را پر کنید و سپس روی ایجاد کلیک کنید.
پس از ایجاد برنامه، آن را از برگه برنامه‌ها انتخاب کنید تا جزئیات را مشاهده کنید و کلید برنامه را یادداشت کنید.
به برگه نمای کلی > واحدهای آگهی بروید، برنامه را از منوی کشویی انتخاب کنید و سپس روی واحد آگهی جدید کلیک کنید.
مناقصه درون برنامه ای را به عنوان روش مزایده انتخاب کنید و بقیه فرم را پر کنید. سپس روی ایجاد کلیک کنید.
برای مشاهده جزئیات آن، به واحد تبلیغاتی تازه ایجاد شده خود در زیر برگه واحدهای آگهی بروید. به شناسه واحد تبلیغات توجه داشته باشید.
مرحله 2: تقاضای Moloco را در رابط کاربری Ad Manager تنظیم کنید
به حساب Ad Manager خود وارد شوید.
اشتراک گذاری سیگنال ایمن را فعال کنید
به Admin > تنظیمات جهانی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری ایمن سیگنال را بررسی کرده و آن را تغییر دهید. روی ذخیره کلیک کنید.
سیگنال ایمن را در درخواست های پیشنهاد به اشتراک بگذارید
به Inventory > Secure Signals بروید. در قسمت Secure signals ، Moloco Ads SDK را جستجو کنید و گزینه Enable app integration را فعال کنید.
روی ذخیره کلیک کنید.
اشتراک‌گذاری سیگنال ایمن برای مناقصه SDK مجاز است
به Delivery > تنظیمات کانال درخواستی بروید. در برگه تنظیمات پیش‌فرض ، اجازه دادن به اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK را تغییر دهید.
روی ذخیره کلیک کنید.
مناقصه Moloco را پیکربندی کنید
به Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
روی مناقصه جدید کلیک کنید.
Moloco Ads را به عنوان پیشنهاد دهنده انتخاب کنید.
برای فعال کردن پیشنهاد SDK برای این پیشنهاد دهنده، روی Continue کلیک کنید.
روی Done کلیک کنید.
پیکربندی نقشه واحد تبلیغات
به Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
شرکتی را برای Moloco Ads SDK انتخاب کنید.
به برگه نگاشت واحد آگهی بروید و روی نقشه واحد آگهی جدید کلیک کنید.
واحد تبلیغات خاص را انتخاب کنید. یک واحد تبلیغات و قالب، برنامه موبایل را به عنوان نوع موجودی ، و برنامه تلفن همراه خود را انتخاب کنید. سپس، App Key و Ad Unit ID را که در قسمت قبل به دست آمده بود وارد کنید.
در نهایت روی Save کلیک کنید.
تبلیغات Moloco را به لیست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده اضافه کنید
برای افزودن Moloco Ads به فهرست شرکای آگهی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری Ad Manager، مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.
مرحله 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: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهی‌های آزمایشی را از 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.