این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Moloco با استفاده از میانجیگری استفاده کنید که ادغامهای مناقصه را پوشش میدهد. نحوه افزودن Moloco به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Moloco SDK و آداپتور در یک برنامه iOS را پوشش میدهد.
ادغام ها و فرمت های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای Moloco دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | |
آبشار | |
فرمت ها | |
برنامه باز شود | |
بنر | |
بینابینی | |
پاداش داده شد | |
بینابینی پاداش | |
بومی |
الزامات
هدف استقرار iOS 12.0 یا بالاتر
آداپتور Moloco 3.9.1.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 و آداپتور را وارد کنید
استفاده از CocoaPods (توصیه می شود)
خط زیر را به Podfile پروژه خود اضافه کنید:
pod 'GoogleMobileAdsMediationMoloco'
از خط فرمان اجرا کنید:
pod install --repo-update
مرحله 4: تنظیمات حریم خصوصی را در Moloco SDK اجرا کنید
رضایت اتحادیه اروپا و GDPR
برای پیروی از خطمشی رضایت کاربر اتحادیه اروپا Google ، باید اطلاعات مشخصی را به کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس ارائه کنید و رضایت آنها را برای استفاده از کوکیها یا سایر فضای ذخیرهسازی محلی در مواردی که از نظر قانونی لازم است، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات کسب کنید. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع آگهی در زنجیره میانجی شما هستید. Google نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.
Moloco SDK شامل پرچم hasUserConsent
برای ارسال اطلاعات رضایت به Moloco SDK است.
کد نمونه زیر نحوه انتقال اطلاعات رضایت به Moloco SDK را نشان می دهد. اگر انتخاب میکنید این پرچمها را تنظیم کنید، توصیه میشود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.
سویفت
import MolocoSDK
// ...
MolocoPrivacySettings.hasUserConsent = true;
هدف-C
#import <MolocoSDK/MolocoSDK-Swift.h>
// ...
[MolocoPrivacySettings setHasUserConsent:YES];
برای اطلاعات بیشتر به مستندات حریم خصوصی Moloco مراجعه کنید.
قوانین حفظ حریم خصوصی ایالات متحده
قوانین حفظ حریم خصوصی ایالات ایالات متحده مستلزم اعطای حق انصراف به کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف از طریق پیوند برجسته "اطلاعات شخصی من را نفروشید" در صفحه اصلی طرف "فروشنده" ارائه می شود. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکههای تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنماییهای هر یک از آن شبکهها برای اطمینان از رعایت آن پیروی کنید.
Moloco SDK شامل پرچم isDoNotSell
برای ارسال اطلاعات رضایت به Moloco SDK است.
کد نمونه زیر نحوه انتقال اطلاعات رضایت به Moloco SDK را نشان می دهد. اگر انتخاب میکنید این پرچمها را تنظیم کنید، توصیه میشود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.
سویفت
import MolocoSDK
// ...
MolocoPrivacySettings.isDoNotSell = true;
هدف-C
#import <MolocoSDK/MolocoSDK-Swift.h>
// ...
[MolocoPrivacySettings setIsDoNotSell:YES];
برای اطلاعات بیشتر به مستندات حریم خصوصی Moloco مراجعه کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را از Moloco Ads SDK دریافت میکنید، با استفاده از منبع(های ) آگهی Moloco (مناقصه ) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
کدهای خطا
اگر آداپتور نتواند تبلیغی از Moloco دریافت کند، میتوانید با استفاده از GADResponseInfo.adNetworkInfoArray
در کلاسهای زیر، خطای اساسی را از پاسخ آگهی بررسی کنید:
MolocoSDK.MolocoError
GADMediationAdapterMoloco
در اینجا کدها و پیامهای همراهی هستند که توسط آداپتور Moloco هنگام بارگیری نشدن آگهی ارسال میشوند:
کد خطا | دامنه | دلیل |
---|---|---|
101 | com.google.ads.mediation.moloco | Moloco SDK از ارائه تبلیغات در iOS 12 و پایینتر پشتیبانی نمیکند. |
102 | com.google.ads.mediation.moloco | کلید برنامه Moloco وجود ندارد یا نامعتبر است. |
103 | com.google.ads.mediation.moloco | شناسه واحد آگهی Moloco وجود ندارد یا نامعتبر است. |
104 | com.google.ads.mediation.moloco | آگهی برای نمایش آماده نیست |
105 | com.google.ads.mediation.moloco | آگهی نمایش داده نشد. |
106 | com.google.ads.mediation.moloco | داده های رندر برای ارائه آگهی در دسترس نیست. |
-1 تا 5000 | ارسال شده توسط Moloco SDK | Moloco SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Moloco مراجعه کنید. |
تأیید اعتبار سمت سرور
اگر تماسهای تأیید سمت سرور (SSV) را تأیید میکنید ، شناسه منبع آگهی برای Moloco 8267622065755668722
است.
Moloco iOS Mediation Adapter Changelog
نسخه 3.13.0.0 (در حال پیشرفت)
- شامل Info.plist در داخل فریمورک ها می باشد.
نسخه 3.12.1.0
- سازگاری تایید شده با Moloco SDK نسخه 3.12.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.8.0.
- Moloco SDK نسخه 3.12.1.
نسخه 3.12.0.0
- سازگاری تایید شده با Moloco SDK نسخه 3.12.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.8.0.
- Moloco SDK نسخه 3.12.0.
نسخه 3.11.0.0
- سازگاری تایید شده با Moloco SDK نسخه 3.11.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.6.0.
- Moloco SDK نسخه 3.11.0.
نسخه 3.10.1.0
- سازگاری تایید شده با Moloco SDK نسخه 3.10.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.6.0.
- Moloco SDK نسخه 3.10.1.
نسخه 3.10.0.0
- سازگاری تایید شده با Moloco SDK نسخه 3.10.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.5.0.
- Moloco SDK نسخه 3.10.0.
نسخه 3.9.1.0
- پشتیبانی از واترمارک برای فرمتهای آگهی پیشنهادی اضافه شده است.
- رفع مشکل هنگام بارگیری بنرهای تبلیغاتی MREC.
- سازگاری تایید شده با Moloco SDK نسخه 3.9.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.3.0.
- Moloco SDK نسخه 3.9.1.
نسخه 3.9.0.0
- نام پلتفرم میانجی اکنون هنگام راه اندازی اولیه Moloco SDK تنظیم شده است.
- سازگاری تایید شده با Moloco SDK نسخه 3.9.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.3.0.
- Moloco SDK نسخه 3.9.0.
نسخه 3.8.0.0
-
-fobjc-arc
و-fstack-protector-all
flags فعال شد. - مشکل کسب رتبه ستاره برای تبلیغات بومی رفع شد.
- سازگاری تایید شده با Moloco SDK نسخه 3.8.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.2.0.
- Moloco SDK نسخه 3.8.0.
نسخه 3.7.2.0
- سازگاری تایید شده با Moloco SDK نسخه 3.7.2.
- پشتیبانی مناقصه برای قالب تبلیغات بومی اضافه شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.1.0.
- Moloco SDK نسخه 3.7.2.
نسخه 3.7.1.0
- سازگاری تایید شده با Moloco SDK نسخه 3.7.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.1.0.
- Moloco SDK نسخه 3.7.1.
نسخه 3.7.0.0
- سازگاری تایید شده با Moloco SDK نسخه 3.7.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.0.0.
- Moloco SDK نسخه 3.7.0.
نسخه 3.6.0.1
- آداپتور را برای بازیابی نسخه Moloco SDK از رشته اصلی به روز کرد.
- اکنون به Google Mobile Ads SDK نسخه 12.0.0 یا بالاتر نیاز دارد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 12.0.0.
- Moloco SDK نسخه 3.6.0.
نسخه 3.6.0.0
- سازگاری تایید شده با Moloco SDK نسخه 3.6.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.13.0.
- Moloco SDK نسخه 3.6.0.
نسخه 3.5.0.0
- انتشار اولیه
- پشتیبانی مناقصه برای بنر (شامل MREC)، قالبهای تبلیغاتی بینابینی و پاداش اضافه شده است.
- سازگاری تایید شده با Moloco SDK نسخه 3.5.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.13.0.
- Moloco SDK نسخه 3.5.0.