ادغام Moloco با مناقصه

این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از Moloco با استفاده از میانجیگری استفاده کنید، و ادغام‌های پیشنهاد قیمت را پوشش می‌دهد. این راهنما نحوه اضافه کردن 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 در رابط کاربری Ad Manager

وارد حساب مدیر تبلیغات خود شوید.

فعال کردن اشتراک‌گذاری امن سیگنال

به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.

سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید

به بخش موجودی > سیگنال‌های امن بروید. در زیر سیگنال‌های امن ، کیت توسعه نرم‌افزار Moloco Ads را جستجو کنید و گزینه فعال کردن ادغام برنامه را فعال کنید.

روی ذخیره کلیک کنید.

امکان اشتراک‌گذاری امن سیگنال برای مناقصه SDK

به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیش‌فرض ، گزینه «اجازه اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.

روی ذخیره کلیک کنید.

پیکربندی پیشنهاد قیمت Moloco

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

روی پیشنهاددهنده جدید کلیک کنید.

Moloco Ads را به عنوان پیشنهاد دهنده انتخاب کنید.

برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.

روی انجام شد کلیک کنید.

پیکربندی نگاشت واحد تبلیغات

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

شرکت Moloco Ads SDK را انتخاب کنید.

به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.

واحد تبلیغاتی خاص را انتخاب کنید. یک واحد تبلیغاتی و قالب آن، برنامه موبایل را به عنوان نوع موجودی و برنامه موبایل خود انتخاب کنید. سپس، کلید برنامه و شناسه واحد تبلیغاتی که در بخش قبل به دست آورده‌اید را وارد کنید.

در نهایت، روی ذخیره کلیک کنید.

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

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

مرحله ۳: 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 مراجعه کنید.

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

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

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

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

برای تأیید اینکه تبلیغات آزمایشی را از 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 نسخه ۳.۵.۰.