این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بار کردن و نمایش آگهیهای Moloco بااستفاده از میانجیگری AdMob استفاده کنید و ادغامهای مزایده را پوشش میدهد. در این آموزش نحوه افزودن Moloco به پیکربندی میانجیگری واحد آگهی و نحوه ادغام کردن کیت توسعه نرمافزار و آداپتور Moloco در برنامه iOS پوشش داده میشود.
یکپارچهسازیها و قالبهای آگهی پشتیبانیشده
آداپتور میانجیگری Moloco قابلیتهای زیر را دارد:
| یکپارچهسازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالبها | |
| صفحه باز شدن برنامه | |
| برنما | |
| بینابینی | |
| پاداش | |
| بینابینی پاداشدار | |
| بومی | |
پیشنیازها
پیشاز ادامه دادن، موارد زیر را تأیید کنید:
هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.
آداپتور Moloco نسخه 3.9.1.0 یا بالاتر.
جدیدترین نسخه Google Mobile Ads SDK.
Step 1: Set up configurations in Moloco UI
به سیستم «درگاه ناشر Moloco» وارد شوید.
به برگه نمای کلی > برنامهها بروید، سپس روی دکمه افزودن برنامه کلیک کنید تا برنامه جدیدی ایجاد کنید.
سیستمعامل و تنظیمات حریم خصوصی را برای برنامهتان انتخاب کنید، بقیه فرم را تکمیل کنید، و سپس روی ایجاد کلیک کنید.
پساز ایجاد برنامه، آن را از برگه برنامهها انتخاب کنید تا جزئیات را ببینید و کلید برنامه را یادداشت کنید.
به برگه نمای کلی > واحدهای آگهی بروید، برنامه را از منوِ کرکرهای انتخاب کنید، و سپس روی واحد آگهی جدید کلیک کنید.
پیشنهاد قیمت درونبرنامه را بهعنوان روش مزایده انتخاب کنید و بقیه فرم را تکمیل کنید. سپس روی ایجاد کلیک کنید.
به واحد آگهی تازهایجادشده خود در برگه واحدهای آگهی بروید تا جزئیات آن را مشاهده کنید. شناسه واحد آگهی را یادداشت کنید.
مرحله ۲: راهاندازی تقاضای Moloco در واسط کاربر AdMob
پیکربندی تنظیمات میانجیگری برای واحد آگهی شما
باید Moloco Ads SDK را به پیکربندی میانجیگری واحد آگهیتان اضافه کنید.
ابتدا، به سیستم حساب AdMob خود وارد شوید. سپس به برگه میانجیگری بروید. اگر گروه میانجیگری موجودی دارید که میخواهید آن را اصلاح کنید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید، و به افزودن کیت توسعه نرمافزار Moloco Ads بهعنوان منبع آگهی بروید.
برای ایجاد گروه میانجیگری جدید، ایجاد گروه میانجیگری را انتخاب کنید.

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

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

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

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

افزودن کیت توسعه نرمافزار آگهیهای Moloco بهعنوان منبع آگهی
در بخش منابع آگهی، کارت پیشنهاد قیمت را پیدا کنید و افزودن منبع آگهی را انتخاب کنید. سپس Moloco Ads SDK را انتخاب کنید.
روی نحوه امضای قرارداد مشارکت کلیک کنید و مشارکت مزایدهای را با Moloco Ads SDK راهاندازی کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر ازقبل نگاشتی برای Moloco Ads SDK دارید، میتوانید آن را انتخاب کنید. درغیراینصورت، روی افزودن نگاشت کلیک کنید.
سپس، کلید برنامه و شناسه واحد آگهی را که در بخش قبلی بهدست آوردید وارد کنید. سپس روی تمام کلیک کنید.
افزودن Moloco Ads به فهرست شرکای آگهی مقررات ایالتی ایالات متحده و اروپا
مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید تا Moloco Ads را به فهرست شرکای آگهی مقررات ایالتی ایالات متحده و اروپا در میانای کاربری AdMob اضافه کنید.
مرحله ۳: وارد کردن کیت توسعه نرمافزار و آداپتور Moloco
استفاده از Swift Package Manager
قبلاز ادامه دادن، باید حداقل نسخه آداپتور پشتیبانیشده 4.1.0.0 را داشته باشید.
برای افزودن وابستگی بسته به پروژهتان، این مراحل را دنبال کنید:
در Xcode، به File > Add Package Dependencies... بروید.
در پیاموارهای که ظاهر میشود، نشانی وب بسته زیر را جستجو کنید:
https://github.com/googleads/googleads-mobile-ios-mediation-moloco.gitدر قانون وابستگی، شاخه را انتخاب کنید.
در فیلد نوشتاری،
mainرا وارد کنید.
استفاده از CocoaPods
خط زیر را به Podfile پروژهتان اضافه کنید:
pod 'GoogleMobileAdsMediationMoloco'از خط فرمان، این دستور را اجرا کنید:
pod install --repo-update
مرحله ۴: پیادهسازی تنظیمات حریم خصوصی در Moloco SDK
کسب رضایت اتحادیه اروپا و مقررات کلی حفاظت از داده
برای رعایت کردن «خطمشی Google درخصوص موافقت کاربر اتحادیه اروپا»، باید شفافسازیهای خاصی را برای کاربران ساکن منطقه اقتصادی اروپا (EEA)، پادشاهی متحد (UK)، و سوئیس انجام دهید و موافقت آنها را برای استفاده از کوکیها یا دیگر فضاهای ذخیرهسازی محلی در جاهایی که قانون الزام میکند، و برای جمعآوری، همرسانی، و استفاده از دادههای شخصی برای شخصیسازی آگهیها کسب کنید. این خطمشی منعکسکننده الزامات «آییننامه حریمخصوصی الکترونیکی» اتحادیه اروپا و «مقررات کلی حفاظت از داده» (GDPR) است. شما مسئولید که تأیید کنید رضایت به هر منبع آگهی در زنجیره میانجیگری شما منتقل شده است.
Moloco Ads SDK iOS adapter version 3.5.0.0 and later supports passing GDPR consent signals from consent management platforms that integrate with IAB's Transparency and Consent Framework (TCF) to Moloco Ads SDK SDK. برای اطلاعات بیشتر، رشته رضایت TCF را ببینید.
قوانین حریم خصوصی ایالتی در ایالات متحده
قوانین حریم خصوصی ایالتهای امریکا ملزم میکند که به کاربران حق انصراف از «فروش» «اطلاعات شخصی» آنها (طبق تعریف قانون از این اصطلاحات) داده شود و این انصراف ازطریق پیوند برجسته «اطلاعات شخصی من فروخته نشود» در صفحه اصلی طرف «فروشنده» ارائه شود. راهنمای رعایت قوانین حریم خصوصی ایالتهای ایالات متحده امکان فعال کردن پردازش محدود داده را برای ارائه آگهی Google فراهم میکند، اما Google نمیتواند این تنظیم را برای هر شبکه آگهی در زنجیره میانجیگری شما اعمال کند. بنابراین، باید هر شبکه آگهی را که ممکن است در فروش اطلاعات شخصی مشارکت داشته باشد در زنجیره میانجیگریتان شناسایی کنید و برای اطمینان از رعایت مقررات، از راهنماییهای هریک از آن شبکهها پیروی کنید.
کیت توسعه نرمافزار Moloco شامل پرچم isDoNotSell برای ارسال اطلاعات رضایت به
کیت توسعه نرمافزار Moloco است.
نمونه کد زیر نحوه ارسال اطلاعات رضایت به Moloco SDK را نشان میدهد. اگر تصمیم گرفتید این پرچمها را تنظیم کنید، توصیه میشود این کار را قبلاز درخواست آگهی ازطریق Google Mobile Ads SDK انجام دهید.
Swift
import MolocoSDK
// ...
MolocoPrivacySettings.isDoNotSell = true;
آبجکتیو-سی
#import <MolocoSDK/MolocoSDK-Swift.h>
// ...
[MolocoPrivacySettings setIsDoNotSell:YES];
برای اطلاعات بیشتر، سند حریم خصوصی Moloco را ببینید.
مرحله ۵: آزمایش کردن پیادهسازی
فعال کردن آگهیهای آزمایشی
مطمئن شوید دستگاه آزمایشیتان را برای AdMob ثبت کردهاید.
درستیسنجی آگهیهای آزمایشی
برای تأیید اینکه آگهیهای آزمایشی را از Moloco Ads SDK دریافت میکنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع (های) آگهی Moloco(Bidding) فعال کنید.
کدهای خطا
اگر آداپتور نتواند آگهی را از Moloco دریافت کند، میتوانید خطای اساسی را از پاسخ آگهی بااستفاده از
GADResponseInfo.adNetworkInfoArray
تحت کلاسهای زیر بررسی کنید:
MolocoSDK.MolocoError
GADMediationAdapterMoloco
در اینجا کدها و پیامهای همراهی که توسط آداپتور Moloco هنگام بارگیری نشدن آگهی ارسال میشوند، آورده شده است:
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱۰۱ | com.google.ads.mediation.moloco | کیت توسعه نرمافزار Moloco از ارائه آگهی در iOS 12 و نسخههای پایینتر پشتیبانی نمیکند. |
| 102 | com.google.ads.mediation.moloco | «کلید برنامه Moloco» وجود ندارد یا نامعتبر است. |
| 103 | com.google.ads.mediation.moloco | شناسه واحد آگهی Moloco موجود یا معتبر نیست. |
| 104 | com.google.ads.mediation.moloco | آگهی برای نمایش آماده نیست. |
| ۱۰۵ | com.google.ads.mediation.moloco | آگهی نشان داده نشد. |
| 106 | com.google.ads.mediation.moloco | دادههای پرداز زدن برای پرداز زدن آگهی دردسترس نیست. |
| ۱- تا ۵۰۰۰ | ارسالشده توسط Moloco SDK | کیت توسعه نرمافزار Moloco خطایی برگرداند. برای جزئیات بیشتر، به اسناد Moloco مراجعه کنید. |
گزارش تغییرات آداپتور میانجی Moloco iOS
نسخه ۴.۱۱.۱.۰
- سازگاری با Moloco SDK نسخه 4.11.1 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۱۱.۰.
- Moloco SDK نسخه ۴.۱۱.۱.
نسخه ۴.۱۱.۰.۰
- سازگاری با Moloco SDK نسخه 4.11.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۱۱.۰.
- Moloco SDK نسخه ۴.۱۱.۰.
نسخه ۴.۱۰.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۱۰.۰ تأیید شد.
- بهروزرسانی شد تا نشان دهد Moloco SDK میتواند ظهورهای آگهی بومی را ردیابی کند.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۹.۰.
- Moloco SDK نسخه ۴.۱۰.۰.
نسخه ۴.۹.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۹.۱ تأیید شد.
ساخته و آزمایششده با:
- نسخه ۱۳.۸.۰ کیت توسعه نرمافزار آگهی تلفن همراه Google.
- Moloco SDK نسخه ۴.۹.۱.
نسخه ۴.۹.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۹.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۷.۰.
- Moloco SDK نسخه ۴.۹.۰.
نسخه ۴.۸.۱.۱
- پشتیبانی از اندازههای آگهی برنمای تطبیقی اضافه شده است.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۶.۰.
- Moloco SDK نسخه ۴.۸.۱.
نسخه ۴.۸.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۸.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۶.۰.
- Moloco SDK نسخه ۴.۸.۱.
نسخه 4.8.0.0
- سازگاری با Moloco SDK نسخه ۴.۸.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۶.۰.
- Moloco SDK نسخه ۴.۸.۰.
نسخه ۴.۷.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۷.۰ تأیید شد.
- حداقل نسخه iOS را بهروز کنید تا وابستگی کیت توسعه نرمافزار تبلیغات تلفن همراه Google را کاهش دهید و نسخههای جزئی مجاز شوند.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۵.۰.
- Moloco SDK نسخه ۴.۷.۰.
نسخه ۴.۶.۱.۱
- اکنون آداپتور پرچم
ageRestrictedTreatment«کیت توسعه نرمافزار آگهیهای Google Mobile» را به COPPA API «کیت توسعه نرمافزار Moloco» بازارسال میکند.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۳.۰.
- Moloco SDK نسخه ۴.۶.۱.
نسخه ۴.۶.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۶.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۳.۰.
- Moloco SDK نسخه ۴.۶.۱.
نسخه ۴.۶.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۶.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۲.۰.
- Moloco SDK نسخه ۴.۶.۰.
نسخه ۴.۵.۱.۰
- سازگاری با Moloco SDK نسخه ۴.۵.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۲.۰.
- Moloco SDK نسخه ۴.۵.۱.
نسخه ۴.۵.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۵.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۱.۰.
- Moloco SDK نسخه ۴.۵.۰.
نسخه ۴.۴.۱.۰
- سازگاری با Moloco SDK نسخه 4.4.1 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۱.۰.
- Moloco SDK نسخه ۴.۴.۱.
نسخه ۴.۴.۰.۰
- سازگاری با Moloco SDK نسخه 4.4.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۱.۰.
- Moloco SDK نسخه ۴.۴.۰.
نسخه ۴.۳.۰.۲
- وابستگی کیت توسعه نرمافزار تبلیغات تلفن همراه Google به نسخه ۱۳.۰.۰ بهروز شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۰.۰.
- Moloco SDK نسخه ۴.۳.۰.
نسخه ۴.۳.۰.۱
- حداقل نسخه iOS برای CocoaPods به
13.0بهروزرسانی شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۳.۰.۰.
- Moloco SDK نسخه ۴.۳.۰.
نسخه ۴.۳.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۳.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۱۴.۰.
- Moloco SDK نسخه ۴.۳.۰.
نسخه ۴.۲.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۲.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۱۴.۰.
- Moloco SDK نسخه ۴.۲.۰.
نسخه ۴.۱.۲.۰
- سازگاری با Moloco SDK نسخه ۴.۱.۲ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۱۴.۰.
- Moloco SDK نسخه ۴.۱.۲.
نسخه ۴.۱.۰.۰
- سازگاری با Moloco SDK نسخه ۴.۱.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۱۴.۰.
- Moloco SDK نسخه ۴.۱.۰.
نسخه ۳.۱۳.۰.۰
- شامل
Info.plistدر چارچوبها است. - سازگاری با Moloco SDK نسخه ۳.۱۳.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهیهای Google Mobile نسخه ۱۲.۹.۰.
- نسخه ۳.۱۳.۰ از کیت توسعه نرمافزار Moloco.
نسخه ۳.۱۲.۱.۰
- سازگاری با Moloco SDK نسخه ۳.۱۲.۱ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۱۲.۸.۰.
- Moloco SDK نسخه ۳.۱۲.۱.
نسخه ۳.۱۲.۰.۰
- سازگاری با Moloco SDK نسخه 3.12.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۱۲.۸.۰.
- Moloco SDK نسخه ۳.۱۲.۰.
نسخه ۳.۱۱.۰.۰
- سازگاری با Moloco SDK نسخه ۳.۱۱.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۶.۰.
- Moloco SDK نسخه ۳.۱۱.۰.
نسخه ۳.۱۰.۱.۰
- سازگاری با نسخه 3.10.1 از Moloco SDK تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۶.۰.
- Moloco SDK نسخه ۳.۱۰.۱.
نسخه ۳.۱۰.۰.۰
- سازگاری با Moloco SDK نسخه 3.10.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۵.۰.
- Moloco SDK نسخه ۳.۱۰.۰.
نسخه ۳.۹.۱.۰
- پشتیبانی از تهنقش برای قالبهای آگهی مزایدهای اضافه شد.
- مشکل مربوط به بار کردن آگهیهای برنمای MREC برطرف شد.
- سازگاری با Moloco SDK نسخه 3.9.1 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۳.۰.
- Moloco SDK نسخه ۳.۹.۱.
نسخه ۳.۹.۰.۰
- نام پلاتفرم میانجیگری اکنون هنگام مقداردهی اولیه کیت توسعه نرمافزار Moloco تنظیم میشود.
- سازگاری با Moloco SDK نسخه ۳.۹.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۳.۰.
- Moloco SDK نسخه ۳.۹.۰.
نسخه ۳.۸.۰.۰
- پرچمهای
-fobjc-arcو-fstack-protector-allفعال شد. - مشکل دریافت ردهبندی ستارهای برای آگهیهای بومی برطرف شد.
- سازگاری با Moloco SDK نسخه ۳.۸.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۲.۰.
- Moloco SDK نسخه ۳.۸.۰.
نسخه ۳.۷.۲.۰
- سازگاری با Moloco SDK نسخه 3.7.2 تأیید شد.
- پشتیبانی از پیشنهاد قیمت برای قالب آگهی بومی اضافه شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۱.۰.
- Moloco SDK نسخه ۳.۷.۲.
نسخه ۳.۷.۱.۰
- سازگاری با نسخه 3.7.1 از Moloco SDK تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۱.۰.
- Moloco SDK نسخه ۳.۷.۱.
نسخه ۳.۷.۰.۰
- سازگاری با Moloco SDK نسخه ۳.۷.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۰.۰.
- Moloco SDK نسخه ۳.۷.۰.
نسخه ۳.۶.۰.۱
- آداپتور بهروزرسانی شد تا نسخه Moloco SDK را از رشته اصلی بازیابی کند.
- اکنون به «کیت توسعه نرمافزار تبلیغات تلفن همراه Google» نسخه ۱۲.۰.۰ یا بالاتر نیاز دارد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۲.۰.۰.
- Moloco SDK نسخه ۳.۶.۰.
نسخه ۳.۶.۰.۰
- سازگاری با Moloco SDK نسخه ۳.۶.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۱.۱۳.۰.
- Moloco SDK نسخه ۳.۶.۰.
نسخه ۳.۵.۰.۰
- نسخهٔ پخش اولیه.
- پشتیبانی از پیشنهاد قیمت برای قالبهای آگهی برنمایی (شامل MREC)، بینابینی، و پاداشدار اضافه شد.
- سازگاری با Moloco SDK نسخه ۳.۵.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۱۱.۱۳.۰.
- Moloco SDK نسخه ۳.۵.۰.