شبکه Meta Audience را با مناقصه ادغام کنید

پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر

این راهنما به شما نشان می‌دهد که چگونه از افزونه Google Mobile Ads Unity برای بارگذاری و نمایش تبلیغات از Meta Audience Network با استفاده از میانجیگری استفاده کنید و ادغام‌های پیشنهاد قیمت را پوشش می‌دهد. این راهنما نحوه اضافه کردن Meta Audience Network به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام Meta Audience Network و آداپتور آن در یک برنامه Unity را پوشش می‌دهد.

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

آداپتور میانجیگری AdMob برای شبکه مخاطبان متا (Meta Audience Network) قابلیت‌های زیر را دارد:

ادغام
مناقصه
آبشار ۱
قالب‌ها
بنر
بینابینی
پاداش داده شده
تبلیغات بینابینی پاداش‌دار

۱ شبکه مخاطبان متا فقط در سال ۲۰۲۱ به مناقصه تبدیل شد.

الزامات

  • آخرین افزونه تبلیغات موبایلی گوگل برای یونیتی
  • یونیتی ۵.۶ یا بالاتر
  • افزونه میانجیگری تبلیغات موبایلی گوگل برای شبکه مخاطبان متا نسخه ۲.۱۱.۰ ( آخرین نسخه توصیه می‌شود )
  • برای نصب روی اندروید
    • اندروید API سطح ۲۳ یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 10.0 یا بالاتر
    • جدیدترین SDK شبکه مخاطبان متا معمولاً به آخرین نسخه Xcode نیاز دارد.
  • یک پروژه یونیتی فعال که با افزونه یونیتی تبلیغات موبایلی گوگل پیکربندی شده است. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
  • راهنمای شروع میانجیگری را تکمیل کنید

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

ثبت نام کنید و به صفحه شروع مدیر کسب و کار وارد شوید.

روی شروع به کار (Get started) و سپس ایجاد حساب کاربری جدید (Create new account) کلیک کنید.

فیلدهای مورد نیاز را با جزئیات کسب و کار خود پر کنید و روی «بعدی» کلیک کنید.

ایجاد یک ملک

پس از پر کردن اطلاعات مورد نیاز، از شما خواسته می‌شود که یک ویژگی برای برنامه خود ایجاد کنید. نام دلخواه ویژگی برنامه خود را وارد کنید و روی «بعدی» کلیک کنید.

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

جزئیات برنامه خود را اضافه کنید و روی «بعدی» کلیک کنید.

اندروید

آی‌او‌اس

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

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

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

شناسه‌ی محل قرارگیری را یادداشت کنید.

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

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .

برای پیاده‌سازی app-ads.txt برای شبکه مخاطبان متا، به شناسایی فروشندگان مجاز با app-ads.txt مراجعه کنید.

حالت تست را روشن کنید

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

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

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

اندروید

برای دستورالعمل‌ها، به مرحله ۲ در راهنمای اندروید مراجعه کنید.

آی‌او‌اس

برای دستورالعمل‌ها، به مرحله ۲ در راهنمای iOS مراجعه کنید.

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

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

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

رابط خط فرمان OpenUPM

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید افزونه‌ی میانجی‌گری شبکه‌ی مخاطبان متای تبلیغات موبایل گوگل برای یونیتی را با اجرای دستور زیر از دایرکتوری ریشه‌ی پروژه، روی پروژه‌ی خود نصب کنید:

openupm add com.google.ads.mobile.mediation.metaaudiencenetwork

اوپن‌یو‌پی‌ام

در ویرایشگر پروژه یونیتی خود، گزینه Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.

در زیر تب Scoped Registries ، OpenUPM را به عنوان یک رجیستری Scoped با جزئیات زیر اضافه کنید:

  • نام: OpenUPM
  • آدرس اینترنتی: https://package.openupm.com
  • محدوده(ها): com.google

جزئیات OpenUPM

سپس، به مسیر Window > Package Manager بروید تا Unity Package Manager باز شود و از منوی کشویی، My Registrys را انتخاب کنید.

رجیستری‌های یونیتی

بسته‌ی Google Mobile Ads MetaAudienceNetwork Mediation را انتخاب کرده و روی نصب کلیک کنید.

نصب از OpenUPM

بسته یونیتی

آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای شبکه مخاطبان متا (Meta Audience Network) را از لینک دانلود موجود در Changelog دانلود کنید و بسته GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage را از فایل زیپ استخراج کنید.

در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage را که دانلود کرده‌اید، پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.

وارد کردن از یونیتی

سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تجزیه و تحلیل وابستگی‌ها را از ابتدا انجام می‌دهد و وابستگی‌های اعلام شده را در پوشه Assets/Plugins/Android برنامه Unity شما کپی می‌کند.

عزم راسخ

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

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

برای کسب اطلاعات در مورد GDPR و تبلیغات متا، راهنمای متا را مرور کنید.

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

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

برای کاربران ساکن کالیفرنیا، گزینه‌های پردازش داده‌های متا را بررسی کنید.

مرحله ۵: اضافه کردن کد مورد نیاز

اندروید

هیچ کد اضافی برای ادغام شبکه مخاطبان متا مورد نیاز نیست.

آی‌او‌اس

ادغام شبکه SKAd

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات Meta Audience Network را دنبال کنید.

ردیابی تبلیغات فعال شد

اگر در حال ساخت برنامه برای iOS 14 یا بالاتر هستید، دستورالعمل‌های Meta Audience Network را در مورد نحوه تنظیم پرچم ردیابی تبلیغات آنها بررسی کنید.

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

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

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده‌اید و حالت آزمایشی را در رابط کاربری Meta Audience Network فعال کرده‌اید .

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

برای تأیید اینکه تبلیغات آزمایشی را از شبکه مخاطبان متا دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی شبکه مخاطبان متا (مناقصه ) فعال کنید.

مراحل اختیاری

ذخیره سازی در حافظه پنهان (caching) در اندروید ۹

اندروید

از اندروید ۹ (سطح API 28)، پشتیبانی از متن واضح (cleartext) به طور پیش‌فرض غیرفعال است ، که بر عملکرد ذخیره‌سازی رسانه‌ای SDK شبکه مخاطبان متا (Meta Audience Network SDK) تأثیر می‌گذارد و می‌تواند بر تجربه کاربری و درآمد تبلیغات تأثیر بگذارد. برای به‌روزرسانی پیکربندی امنیت شبکه در برنامه خود ، مستندات متا را دنبال کنید.

آی‌او‌اس

برای ادغام با iOS قابل استفاده نیست.

کدهای خطا

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

اندروید 

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

آی‌او‌اس 

GADMAdapterFacebook
GADMediationAdapterFacebook

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

اندروید

کد خطا دلیل
۱۰۱ پارامترهای سرور نامعتبر است (مثلاً شناسه قرارگیری وجود ندارد).
۱۰۲ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط شبکه مخاطبان متا مطابقت ندارد.
۱۰۳ ناشر باید تبلیغاتی با زمینه Activity context) درخواست کند.
۱۰۴ SDK شبکه مخاطبان متا (Meta Audience Network SDK) نتوانست مقداردهی اولیه شود.
۱۰۵ ناشر درخواستی برای تبلیغات بومی یکپارچه (Unified Native ads) ارائه نکرده بود.
۱۰۶ تبلیغ بومی بارگذاری شده، شیء متفاوتی نسبت به آنچه انتظار می‌رفت، است.
۱۰۷ شیء Context استفاده شده نامعتبر است.
۱۰۸ تبلیغ بارگذاری شده فاقد ویژگی‌های لازم برای تبلیغات همسان است.
۱۰۹ ایجاد تبلیغ بومی از طریق ظرفیت پیشنهاد قیمت ناموفق بود.
۱۱۰ SDK شبکه مخاطبان متا (Meta Audience Network SDK) نتوانست تبلیغ بینابینی/پاداش‌دار خود را ارائه دهد.
۱۱۱ هنگام ایجاد شیء AdView شبکه مخاطبان متا، استثنا ایجاد می‌شود.
۱۰۰۰-۹۹۹۹ شبکه مخاطبان متا (Meta Audience Network) یک خطای مختص SDK را برگرداند. برای جزئیات بیشتر به مستندات شبکه مخاطبان متا مراجعه کنید.

آی‌او‌اس

کد خطا دلیل
۱۰۱ پارامترهای سرور نامعتبر است (مثلاً شناسه قرارگیری وجود ندارد).
۱۰۲ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط شبکه مخاطبان متا مطابقت ندارد.
۱۰۳ شیء تبلیغاتی شبکه مخاطبان متا (Meta Audience Network) نتوانست مقداردهی اولیه شود.
۱۰۴ SDK شبکه مخاطبان متا (Meta Audience Network SDK) نتوانست تبلیغ بینابینی/پاداش‌دار خود را ارائه دهد.
۱۰۵ کنترل‌کننده نمای ریشه بنر تبلیغاتی nil است.
۱۰۶ SDK شبکه مخاطبان متا (Meta Audience Network SDK) نتوانست مقداردهی اولیه شود.
۱۰۰۰-۹۹۹۹ شبکه مخاطبان متا (Meta Audience Network) یک خطای مختص SDK را برگرداند. برای جزئیات بیشتر به مستندات شبکه مخاطبان متا مراجعه کنید.

تغییرات افزونه میانجیگری Unity Network برای شبکه مخاطبان متا

نسخه ۳.۱۷.۳

نسخه ۳.۱۷.۲

نسخه ۳.۱۷.۱

نسخه ۳.۱۷.۰

نسخه ۳.۱۶.۰

نسخه ۳.۱۵.۰

نسخه ۳.۱۴.۰

نسخه ۳.۱۳.۱

نسخه ۳.۱۳.۰

نسخه ۳.۱۲.۲

نسخه ۳.۱۲.۱

نسخه ۳.۱۲.۰

نسخه ۳.۱۱.۰

نسخه ۳.۱۰.۰

نسخه ۳.۹.۱

نسخه ۳.۹.۰

نسخه ۳.۸.۰

نسخه ۳.۷.۰

نسخه ۳.۶.۱

نسخه ۳.۶.۰

نسخه ۳.۵.۰

نسخه ۳.۴.۰

نسخه ۳.۳.۲

نسخه ۳.۳.۱

نسخه ۳.۳.۰

نسخه ۳.۲.۰

نسخه ۳.۱.۰

نسخه ۳.۰.۰

نسخه ۲.۱۲.۰

نسخه ۲.۱۱.۱

نسخه ۲.۱۱.۰

نسخه ۲.۱۰.۰

نسخه ۲.۹.۲

نسخه ۲.۹.۱

نسخه ۲.۹.۰

نسخه ۲.۸.۱

نسخه ۲.۸.۰

نسخه ۲.۷.۱ (منسوخ شده، از ۲.۸.۰ یا جدیدتر استفاده کنید)

نسخه ۲.۷.۰ (منسوخ شده، از ۲.۸.۰ یا جدیدتر استفاده کنید)

نسخه ۲.۶.۱ (منسوخ شده، از ۲.۸.۰ یا جدیدتر استفاده کنید)

نسخه ۲.۶.۰

نسخه ۲.۵.۱

  • از آداپتور اندروید فیسبوک نسخه ۵.۵.۰.۰ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۵.۵.۱.۰ پشتیبانی می‌کند.

نسخه ۲.۵.۰

  • از آداپتور اندروید فیسبوک نسخه ۵.۵.۰.۰ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۵.۵.۰.۰ پشتیبانی می‌کند.

نسخه ۲.۴.۱

  • از آداپتور اندروید فیسبوک نسخه ۵.۴.۱.۱ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۵.۴.۰.۰ پشتیبانی می‌کند.

نسخه ۲.۴.۰

  • از آداپتور اندروید فیسبوک نسخه ۵.۴.۰.۰ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۵.۴.۰.۰ پشتیبانی می‌کند.

نسخه ۲.۳.۲

  • از آداپتور اندروید فیسبوک نسخه ۵.۳.۱.۲ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۵.۳.۲.۰ پشتیبانی می‌کند.

نسخه ۲.۳.۱

  • از آداپتور اندروید فیسبوک نسخه ۵.۳.۱.۰ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۵.۳.۲.۰ پشتیبانی می‌کند.

نسخه ۲.۳.۰

  • از آداپتور اندروید فیسبوک نسخه ۵.۳.۰.۰ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۵.۳.۰.۰ پشتیبانی می‌کند.

نسخه ۲.۲.۰

  • افزونه برای پشتیبانی از API پاداش‌دهی بتای باز جدید به‌روزرسانی شد.
  • از آداپتور اندروید فیسبوک نسخه ۵.۲.۰.۱ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۵.۲.۰.۱ پشتیبانی می‌کند.

نسخه ۲.۱.۱

  • از آداپتور اندروید فیسبوک نسخه ۵.۱.۰.۱ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۵.۱.۰.۰ پشتیبانی می‌کند.

نسخه ۲.۱.۰

  • از آداپتور اندروید فیسبوک نسخه ۵.۱.۰.۰ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۵.۱.۰.۰ پشتیبانی می‌کند.

نسخه ۲.۰.۰

  • از آداپتور اندروید فیسبوک نسخه ۵.۰.۱.۰ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۵.۰.۱.۰ پشتیبانی می‌کند.

نسخه ۱.۲.۱

  • از آداپتور اندروید فیسبوک نسخه ۴.۹۹.۳.۰ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۴.۹۹.۳.۰ پشتیبانی می‌کند.

نسخه ۱.۲.۰

  • از آداپتور اندروید فیسبوک نسخه ۴.۹۹.۱.۱ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۴.۹۹.۲.۰ پشتیبانی می‌کند.

نسخه ۱.۱.۳

  • از آداپتور اندروید فیسبوک نسخه ۴.۲۸.۲.۱ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۴.۲۸.۱.۲ پشتیبانی می‌کند.

نسخه ۱.۱.۲

  • تداخل احتمالی با افزونه میانجیگری Unity Ads Unity برطرف شد.

نسخه ۱.۱.۱

  • از آداپتور اندروید فیسبوک نسخه ۴.۲۸.۲.۰ پشتیبانی می‌کند.
  • از آداپتور فیسبوک iOS نسخه ۴.۲۸.۱.۱ پشتیبانی می‌کند.

نسخه ۱.۱.۰

  • از نسخه ۴.۲۸.۱ کیت توسعه نرم‌افزار اندروید فیسبوک پشتیبانی می‌کند.
  • از نسخه ۴.۲۸.۱ کیت توسعه نرم‌افزاری فیس‌بوک iOS پشتیبانی می‌کند.

نسخه ۱.۰.۰

  • اولین انتشار!
  • از نسخه ۴.۲۷.۰ کیت توسعه نرم‌افزار اندروید فیسبوک پشتیبانی می‌کند.
  • از نسخه ۴.۲۷.۱ کیت توسعه نرم‌افزار فیس‌بوک iOS پشتیبانی می‌کند.