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

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

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

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

الزامات

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

• آداپتور Moloco نسخه ۳.۹.۱.۰ یا بالاتر

• جدیدترین SDK تبلیغات موبایلی گوگل

• راهنمای شروع میانجیگری را تکمیل کنید.

مرحله ۱: تنظیمات را در رابط کاربری Moloco انجام دهید

وارد پورتال ناشران Moloco شوید.

به تب Overview > Apps بروید، سپس برای ایجاد یک برنامه جدید، روی دکمه Add App کلیک کنید.

تنظیمات سیستم عامل و حریم خصوصی را برای برنامه خود انتخاب کنید، بقیه فرم را پر کنید و سپس روی ایجاد کلیک کنید.

پس از ایجاد برنامه، آن را از تب برنامه‌ها انتخاب کنید تا جزئیات را مشاهده کنید و کلید برنامه (App Key) را یادداشت کنید.

به برگه «نمای کلی» > «واحدهای تبلیغاتی» بروید، برنامه را از منوی کشویی انتخاب کنید و سپس روی «واحد تبلیغاتی جدید» کلیک کنید.

روش مزایده را با انتخاب «قیمت‌گذاری درون‌برنامه‌ای » (In-app bidding) انتخاب کنید و بقیه فرم را پر کنید. سپس روی «ایجاد» (Create ) کلیک کنید.

برای مشاهده جزئیات واحد تبلیغاتی تازه ایجاد شده خود، به تب واحدهای تبلیغاتی بروید. شناسه واحد تبلیغاتی (Ad Unit ID) را یادداشت کنید.

مرحله ۲: تنظیم تقاضای Moloco در رابط کاربری AdMob

تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید

شما باید Moloco Ads SDK را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.

ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به مرحله Add Moloco Ads SDK as an ad source بروید.

برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.

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

به گروه میانجیگری خود یک نام بدهید و مکان‌هایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کرده‌اید پر شده است:

اضافه کردن Moloco Ads SDK به عنوان منبع تبلیغات

Moloco Ads را به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده اضافه کنید

برای افزودن Moloco Ads به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

مرحله ۳: SDK و آداپتور Moloco را وارد کنید

استفاده از CocoaPods (توصیه می‌شود)

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

  pod 'GoogleMobileAdsMediationMoloco'
  

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

  pod install --repo-update

مرحله ۴: تنظیمات حریم خصوصی را در Moloco SDK پیاده‌سازی کنید

رضایت اتحادیه اروپا و GDPR

برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر ذخیره‌سازی‌های محلی در صورت لزوم قانونی، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات، دریافت کنید. این سیاست منعکس‌کننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از داده‌ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطه‌گری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکه‌هایی منتقل کند.

کیت توسعه نرم‌افزار Moloco شامل پرچم hasUserConsent برای ارسال اطلاعات رضایت به کیت توسعه نرم‌افزار Moloco است.

نمونه کد زیر نحوه ارسال اطلاعات رضایت به Moloco SDK را نشان می‌دهد. اگر تصمیم به تنظیم این پرچم‌ها دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.

import MolocoSDK
// ...

MolocoPrivacySettings.hasUserConsent = true;

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setHasUserConsent:YES];

برای اطلاعات بیشتر به مستندات حریم خصوصی Moloco مراجعه کنید.

قوانین حفظ حریم خصوصی ایالت‌های آمریکا

قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف می‌کند) را می‌دهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه می‌شود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده، امکان فعال کردن پردازش داده‌های محدود برای سرویس تبلیغات گوگل را ارائه می‌دهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطه‌گری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطه‌گری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنمایی‌های هر یک از این شبکه‌ها پیروی کنید.

کیت توسعه نرم‌افزار Moloco شامل پرچم isDoNotSell برای ارسال اطلاعات رضایت به کیت توسعه نرم‌افزار Moloco است.

نمونه کد زیر نحوه ارسال اطلاعات رضایت به Moloco SDK را نشان می‌دهد. اگر تصمیم به تنظیم این پرچم‌ها دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.

import MolocoSDK
// ...

MolocoPrivacySettings.isDoNotSell = true;

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setIsDoNotSell:YES];

برای اطلاعات بیشتر به مستندات حریم خصوصی Moloco مراجعه کنید.

مرحله ۵: پیاده‌سازی خود را آزمایش کنید

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

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

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

برای تأیید اینکه تبلیغات آزمایشی را از Moloco Ads SDK دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در ad inspector با استفاده از منبع(های ) تبلیغاتی Moloco (پیشنهاد ) فعال کنید.

کدهای خطا

اگر آداپتور نتواند تبلیغی از Moloco دریافت کند، می‌توانید خطای اساسی ناشی از پاسخ تبلیغ را با استفاده از GADResponseInfo.adNetworkInfoArray تحت کلاس‌های زیر بررسی کنید:

MolocoSDK.MolocoError
GADMediationAdapterMoloco

در اینجا کدها و پیام‌های همراه که توسط آداپتور Moloco هنگام عدم بارگیری یک تبلیغ نمایش داده می‌شوند، آمده است:

تأیید سمت سرور با پاداش

اگر فراخوانی‌های تأیید سمت سرور (SSV) را اعتبارسنجی کنید ، شناسه منبع تبلیغات برای Moloco 8267622065755668722 خواهد بود.

تغییرات آداپتور میانجیگری iOS Moloco

نسخه ۴.۱.۰.۰ (در حال انجام)

نسخه ۴.۰.۰.۰ (در حال انجام)

نسخه ۳.۱۳.۰.۰

• شامل Info.plist درون فریم‌ورک‌ها می‌شود.
• سازگاری تأیید شده با Moloco SDK نسخه 3.13.0.

ساخته و آزمایش شده با:

• نسخه ۱۲.۹.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۱۳.۰.

نسخه ۳.۱۲.۱.۰

• سازگاری تأیید شده با Moloco SDK نسخه ۳.۱۲.۱.

ساخته و آزمایش شده با:

• نسخه ۱۲.۸.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۱۲.۱.

نسخه ۳.۱۲.۰.۰

• سازگاری تأیید شده با Moloco SDK نسخه 3.12.0.

ساخته و آزمایش شده با:

• نسخه ۱۲.۸.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۱۲.۰.

نسخه ۳.۱۱.۰.۰

• سازگاری تأیید شده با Moloco SDK نسخه 3.11.0.

ساخته و آزمایش شده با:

• نسخه ۱۲.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۱۱.۰ کیت توسعه نرم‌افزاری مولوکو.

نسخه ۳.۱۰.۱.۰

• سازگاری تأیید شده با Moloco SDK نسخه ۳.۱۰.۱.

ساخته و آزمایش شده با:

• نسخه ۱۲.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۱۰.۱.

نسخه ۳.۱۰.۰.۰

• سازگاری تأیید شده با Moloco SDK نسخه 3.10.0.

ساخته و آزمایش شده با:

• نسخه ۱۲.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۱۰.۰.

نسخه ۳.۹.۱.۰

• پشتیبانی از واترمارک برای قالب‌های تبلیغاتی پیشنهاد قیمت اضافه شد.
• مشکلی که هنگام بارگذاری بنرهای تبلیغاتی MREC وجود داشت، برطرف شد.
• سازگاری تأیید شده با Moloco SDK نسخه ۳.۹.۱.

ساخته و آزمایش شده با:

• نسخه ۱۲.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۹.۱.

نسخه ۳.۹.۰.۰

• نام پلتفرم میانجیگری اکنون هنگام مقداردهی اولیه Moloco SDK تنظیم می‌شود.
• سازگاری تأیید شده با Moloco SDK نسخه ۳.۹.۰.

ساخته و آزمایش شده با:

• نسخه ۱۲.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۹.۰.

نسخه ۳.۸.۰.۰

• پرچم‌های -fobjc-arc ‎ و -fstack-protector-all ‎ فعال شدند.
• مشکل مربوط به دریافت امتیاز ستاره برای تبلیغات بومی برطرف شد.
• سازگاری تأیید شده با Moloco SDK نسخه ۳.۸.۰.

ساخته و آزمایش شده با:

• نسخه ۱۲.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۸.۰.

نسخه ۳.۷.۲.۰

• سازگاری تأیید شده با Moloco SDK نسخه ۳.۷.۲.
• پشتیبانی از پیشنهاد قیمت برای قالب تبلیغات بومی اضافه شد.

ساخته و آزمایش شده با:

• نسخه ۱۲.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۷.۲.

نسخه ۳.۷.۱.۰

• سازگاری تأیید شده با Moloco SDK نسخه ۳.۷.۱.

ساخته و آزمایش شده با:

• نسخه ۱۲.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۷.۱.

نسخه ۳.۷.۰.۰

• سازگاری تأیید شده با Moloco SDK نسخه ۳.۷.۰.

ساخته و آزمایش شده با:

• نسخه ۱۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۷.۰.

نسخه ۳.۶.۰.۱

• آداپتور را به‌روزرسانی کردیم تا نسخه Moloco SDK را از نخ اصلی بازیابی کند.
• اکنون به نسخه ۱۲.۰.۰ یا بالاتر SDK تبلیغات موبایل گوگل نیاز دارد.

ساخته و آزمایش شده با:

• نسخه ۱۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۶.۰.

نسخه ۳.۶.۰.۰

• سازگاری تأیید شده با Moloco SDK نسخه ۳.۶.۰.

ساخته و آزمایش شده با:

• نسخه ۱۱.۱۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۶.۰.

نسخه ۳.۵.۰.۰

• انتشار اولیه.
• پشتیبانی از پیشنهاد قیمت برای بنر (شامل MREC)، قالب‌های تبلیغاتی بینابینی و پاداشی اضافه شد.
• سازگاری تأیید شده با Moloco SDK نسخه 3.5.0.

ساخته و آزمایش شده با:

• نسخه ۱۱.۱۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• مولوکو SDK نسخه ۳.۵.۰.