ادغام Moloco با میانجیگری

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Moloco با استفاده از AdMob Mediation استفاده کنید که ادغام‌های مناقصه را پوشش می‌دهد. نحوه افزودن Moloco به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Moloco SDK و آداپتور در یک برنامه iOS را پوشش می‌دهد.

ادغام ها و قالب های تبلیغاتی پشتیبانی شده

آداپتور میانجی برای Moloco دارای قابلیت های زیر است:

یکپارچه سازی
مناقصه
آبشار
فرمت ها
برنامه باز شود
بنر
بینابینی
پاداش داده شد
بینابینی پاداش
بومی

الزامات

  • هدف استقرار iOS 12.0 یا بالاتر

  • آداپتور Moloco 3.9.1.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 و آداپتور را وارد کنید

  • خط زیر را به Podfile پروژه خود اضافه کنید:

    pod 'GoogleMobileAdsMediationMoloco'

  • از خط فرمان اجرا کنید:

    pod install --repo-update

مرحله 4: تنظیمات حریم خصوصی را در Moloco SDK اجرا کنید

برای پیروی از خط‌مشی رضایت کاربر اتحادیه اروپا 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: اجرای خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید.

تبلیغات آزمایشی را تأیید کنید

برای تأیید اینکه آگهی‌های آزمایشی را از 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 در داخل فریمورک ها می باشد.
  • سازگاری تایید شده با Moloco SDK نسخه 3.13.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 12.9.0.
  • Moloco SDK نسخه 3.13.0.

نسخه 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.