توجه: شبکه مخاطبان فیس بوک اکنون شبکه مخاطبان متا است. برای اطلاعات بیشتر به اطلاعیه متا مراجعه کنید. این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از شبکه Meta Audience با استفاده از میانجیگری استفاده کنید که یکپارچهسازی مناقصه را پوشش میدهد. نحوه اضافه کردن Meta Audience Network به پیکربندی میانجی واحد تبلیغاتی و نحوه ادغام شبکه Meta Audience و آداپتور در یک Unity برنامه
را AdMob آداپتور میانجی برای شبکه Meta Audience دارای قابلیت های زیر است:
یکپارچه سازی مناقصه آبشار فرمت ها بنر بینابینی پاداش داده شد بینابینی پاداش
Meta Audience Network فقط در سال 2021 مناقصه شد.
الزامات جدیدترین SDK تبلیغات موبایل گوگل یونیتی 5.6 یا بالاتر پلاگین میانجی تبلیغات موبایل Google برای Meta Audience Network 2.11.0 ( آخرین نسخه توصیه می شود ) برای استقرار در اندروید Android API سطح 21 یا بالاتر برای استقرار در iOS هدف استقرار iOS 10.0 یا بالاتر آخرین نسخه متا مخاطبان شبکه SDK معمولاً به آخرین نسخه Xcode نیاز دارد. یک کار Unity پروژه با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید. راهنمای شروع میانجیگری را کامل کنید مرحله 1: تنظیمات را در رابط کاربری شبکه متا مخاطبان تنظیم کنید ثبت نام کنید و وارد صفحه شروع Business Manager شوید.
روی شروع و سپس ایجاد حساب جدید کلیک کنید.
فیلدهای الزامی را با جزئیات کسب و کار خود پر کنید و روی Next کلیک کنید.
یک ملک ایجاد کنید پس از پر کردن اطلاعات مورد نیاز، از شما خواسته می شود که یک ویژگی برای برنامه خود ایجاد کنید. نام مورد نظر ملک را برای برنامه خود وارد کنید و روی Next کلیک کنید.
سپس پلتفرم خود را برای کسب درآمد انتخاب کنید.
جزئیات برنامه خود را اضافه کنید و روی Next کلیک کنید.
با کلیک روی افزودن یک حساب پرداخت جدید، حساب پرداخت خود را تنظیم کنید. برای وارد کردن اطلاعات پرداخت خود به صفحه جدیدی هدایت می شوید. جزئیات لازم را پر کنید، سپس روی Next کلیک کنید.
Google AdMob را به عنوان پلتفرم میانجی انتخاب کنید، سپس روی ایجاد مکان کلیک کنید.
یک قالب را انتخاب کنید، فرم را پر کنید و روی ایجاد کلیک کنید.
توجه: فرمت بنر شبکه Meta Audience از فرمت نمایش مستطیل متوسط و بنرهای عرض انعطاف پذیر با ارتفاع 50، 90 یا 250 پشتیبانی می کند.
شناسه مکان را یادداشت کنید.
روی Done کلیک کنید.
حالت تست را روشن کنید برای دستورالعملهای دقیق در مورد نحوه فعال کردن تبلیغات آزمایشی شبکه مخاطبین متا، راهنمای پیادهسازی شبکه مخاطبان آزمایشی را ببینید.
مرحله 2: تقاضای شبکه Meta Audience را در آن تنظیم کنید AdMob UI Android برای دستورالعملها، به مرحله 2 در راهنمای مربوطه مراجعه کنیداندروید .
iOS برای دستورالعملها، به مرحله 2 در راهنمای مربوطه مراجعه کنیدiOS .
اضافه کنید Facebook به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده مهم: بررسی کنید که مجوز مدیریت حساب برای تکمیل پیکربندی برای رضایت اتحادیه اروپا و GDPR، CPRA و پلت فرم پیامرسانی کاربر را دارید. برای جزئیات بیشتر به مدیریت دسترسی کاربر به حساب خود مراجعه کنید. برای افزودن Meta به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.
مرحله 3: SDK و آداپتور Meta Audience Network را وارد کنید توجه: ادغام نشدن نسخههای متا مخاطب شبکه و نسخههای SDK تبلیغات تلفن همراه Google سازگار ممکن است منجر به مشکلات ساخت شود. OpenUPM-CLI مهم: اگر از استفاده از .unitypackage
به استفاده از OpenUPM-CLI مهاجرت میکنید، باید با حذف همه فایلها از پوشه Assets/GoogleMobileAds/Mediation/MetaAudienceNetwork
داراییها را از مکان قدیمی حذف نصب کنید. اگر OpenUPM-CLI را نصب کردهاید، میتوانید با اجرای دستور زیر از دایرکتوری اصلی پروژه، افزونه میانجیگری شبکه متا مخاطبین تبلیغات Google Mobile را برای Unity در پروژه خود نصب کنید:
openupm add com.google.ads.mobile.mediation.metaaudiencenetwork
OpenUPM مهم: اگر از استفاده از .unitypackage
به استفاده از OpenUPM مهاجرت میکنید، باید با حذف همه فایلها از پوشه Assets/GoogleMobileAds/Mediation/MetaAudienceNetwork
داراییها را از محل قدیمی حذف نصب کنید. در ویرایشگر پروژه Unity خود، Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.
در برگه Scoped Registries ، OpenUPM را به عنوان یک رجیستری محدوده با جزئیات زیر اضافه کنید:
نام: OpenUPM
URL: https://package.openupm.com
محدوده (ها): com.google
سپس به مسیر Window > Package Manager بروید تا Unity Package Manager را باز کنید و My Registries را از منوی کشویی انتخاب کنید.
بسته میانجی شبکه متا مخاطبین تبلیغات Google Mobile را انتخاب کنید و روی Install کلیک کنید.
Unity Package آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل برای شبکه متا مخاطبان را از لینک دانلود در 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 شما کپی می کند.
مرحله 4: اجرای تنظیمات حریم خصوصی در Meta Audience SDK رضایت اتحادیه اروپا و GDPR تحت خطمشی رضایت کاربر اتحادیه اروپا Google، باید اطمینان حاصل کنید که برخی افشاگریها به کاربران منطقه اقتصادی اروپا (EEA) در رابطه با استفاده داده میشود و از آنها رضایت گرفته میشود. از شناسه های دستگاه و داده های شخصی این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. هنگام درخواست رضایت، باید هر شبکه تبلیغاتی را در زنجیره میانجی خود شناسایی کنید که ممکن است دادههای شخصی را جمعآوری، دریافت یا استفاده کند و اطلاعاتی درباره استفاده هر شبکه ارائه دهد. Google در حال حاضر نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.
برای اطلاعات در مورد GDPR و تبلیغات متا، راهنمای متا را مرور کنید.
قوانین حفظ حریم خصوصی ایالات متحده قوانین حفظ حریم خصوصی ایالات متحده مستلزم دادن حق انصراف کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف ارائه شده از طریق پیوند برجسته "اطلاعات شخصی من را نفروش" در "فروش" "صفحه اصلی حزب. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکههای تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنماییهای هر یک از آن شبکهها برای اطمینان از رعایت آن پیروی کنید.
برای کاربران در کالیفرنیا، گزینههای پردازش داده متا را مرور کنید.
مرحله 5: کد مورد نیاز را اضافه کنید Android برای ادغام شبکه Meta Audience نیازی به کد اضافی نیست.
ادغام iOS SKAdNetwork مستندات شبکه Meta Audience را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist
پروژه خود اضافه کنید.
ردیابی تبلیغات فعال است اگر برای iOS 14 یا بالاتر میسازید، دستورالعملهای شبکه Meta Audience درباره نحوه تنظیم پرچم ردیابی تبلیغات خود را بررسی کنید.
مرحله 6: اجرای خود را آزمایش کنید فعال کردن تبلیغات آزمایشی مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید و حالت آزمایشی را در رابط کاربری شبکه Meta Audience فعال کرده اید . نکته کلیدی: هنگام آزمایش، مطمئن شوید که برنامه فیس بوک را روی دستگاه آزمایشی نصب کرده اید و با یک لاگین معتبر فیس بوک وارد شده اید. برای جزئیات بیشتر به مستندات متا مراجعه کنید. مهم: قبل از انتشار برنامه، حالت تست AdMob و Meta Audience Network را غیرفعال کنید. تأیید آگهیهای آزمایشی
برای تأیید اینکه آگهیهای آزمایشی را از شبکه Meta Audience دریافت میکنید، با استفاده از منبع(های) آگهی شبکه Meta Audience (مناقصه) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
مراحل اختیاری ذخیره سازی در اندروید 9 Android با شروع Android 9 (سطح API 28)، پشتیبانی متن واضح به طور پیشفرض غیرفعال است ، که بر عملکرد حافظه پنهان رسانه SDK شبکه متا مخاطب تأثیر میگذارد و میتواند بر تجربه کاربر و درآمد تبلیغات تأثیر بگذارد. برای به روز رسانی پیکربندی امنیت شبکه در برنامه خود ، مستندات متا را دنبال کنید.
iOS برای ادغام های iOS قابل اجرا نیست.
کدهای خطا اگر آداپتور نتواند تبلیغی را از Audience Network دریافت کند، میتوانید با استفاده ResponseInfo
در کلاسهای زیر، خطای اساسی را از پاسخ آگهی بررسی کنید:
com . google . ads . mediation . facebook . FacebookAdapter
com . google . ads . mediation . facebook . FacebookMediationAdapter
GADMAdapterFacebook
GADMediationAdapterFacebook
در اینجا کدها و پیامهای همراهی هستند که توسط آداپتور شبکه Meta Audience هنگامی که یک تبلیغ بارگیری نمیشود:
کد خطای Android دلیل 101 پارامترهای سرور نامعتبر است (به عنوان مثال شناسه مکان موجود نیست). 102 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از شبکه متا مخاطب مطابقت ندارد. 103 ناشر باید آگهی هایی با زمینه Activity
درخواست کند. 104 SDK شبکه Meta Audience راه اندازی نشد. 105 ناشر برای تبلیغات بومی Unified درخواست نکرده است. 106 تبلیغ بومی بارگیری شده شی متفاوت از آنچه انتظار می رود است. 107 شی Context
استفاده شده نامعتبر است. 108 آگهی بارگذاری شده دارایی های مورد نیاز تبلیغات بومی را ندارد. 109 ایجاد یک آگهی بومی از محموله پیشنهادی ناموفق بود. 110 شبکه متا مخاطبین SDK در ارائه تبلیغ بینابینی/پاداش خود شکست خورد. 111 استثنا در هنگام ایجاد یک شیء AdView
شبکه متا مخاطبین ایجاد می شود. 1000-9999 شبکه Meta Audience یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات شبکه Meta Audience مراجعه کنید.
کد خطای iOS دلیل 101 پارامترهای سرور نامعتبر است (به عنوان مثال شناسه مکان موجود نیست). 102 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از شبکه متا مخاطب مطابقت ندارد. 103 شیء تبلیغاتی شبکه متا مخاطب در مقداردهی اولیه ناموفق بود. 104 Meta Audience Network SDK در ارائه آگهی بینابینی/پاداش خود شکست خورد. 105 کنترلر نمای ریشه بنر تبلیغاتی nil
است. 106 SDK شبکه Meta Audience راه اندازی نشد. 1000-9999 شبکه Meta Audience یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات شبکه Meta Audience مراجعه کنید.
نسخه 2.7.1 (منسوخ شده، از نسخه 2.8.0 یا جدیدتر استفاده کنید) نسخه 2.7.0 (منسوخ شده، از نسخه 2.8.0 یا جدیدتر استفاده کنید) نسخه 2.6.1 (منسوخ شده، از نسخه 2.8.0 یا جدیدتر استفاده کنید) نسخه 2.6.0 نسخه 2.5.1 از آداپتور اندروید فیس بوک نسخه 5.5.0.0 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 5.5.1.0 پشتیبانی می کند. نسخه 2.5.0 از آداپتور اندروید فیس بوک نسخه 5.5.0.0 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 5.5.0.0 پشتیبانی می کند. نسخه 2.4.1 از آداپتور اندروید فیسبوک نسخه 5.4.1.1 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 5.4.0.0 پشتیبانی می کند. نسخه 2.4.0 از آداپتور فیس بوک اندروید نسخه 5.4.0.0 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 5.4.0.0 پشتیبانی می کند. نسخه 2.3.2 از آداپتور اندروید فیس بوک نسخه 5.3.1.2 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 5.3.2.0 پشتیبانی می کند. نسخه 2.3.1 از آداپتور فیس بوک اندروید نسخه 5.3.1.0 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 5.3.2.0 پشتیبانی می کند. نسخه 2.3.0 از آداپتور فیس بوک اندروید نسخه 5.3.0.0 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 5.3.0.0 پشتیبانی می کند. نسخه 2.2.0 پلاگین را برای پشتیبانی از API پاداش باز بتا جدید به روز کرد. از آداپتور فیس بوک اندروید نسخه 5.2.0.1 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 5.2.0.1 پشتیبانی می کند. نسخه 2.1.1 از آداپتور اندروید فیسبوک نسخه 5.1.0.1 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 5.1.0.0 پشتیبانی می کند. نسخه 2.1.0 از آداپتور اندروید فیسبوک نسخه 5.1.0.0 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 5.1.0.0 پشتیبانی می کند. نسخه 2.0.0 از آداپتور فیس بوک اندروید نسخه 5.0.1.0 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 5.0.1.0 پشتیبانی می کند. نسخه 1.2.1 از آداپتور اندروید فیسبوک نسخه 4.99.3.0 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 4.99.3.0 پشتیبانی می کند. نسخه 1.2.0 از آداپتور اندروید فیسبوک نسخه 4.99.1.1 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 4.99.2.0 پشتیبانی می کند. نسخه 1.1.3 از آداپتور اندروید فیس بوک نسخه 4.28.2.1 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 4.28.1.2 پشتیبانی می کند. نسخه 1.1.2 تضاد احتمالی با افزونه میانجیگری Unity Ads Unity رفع شد. نسخه 1.1.1 از آداپتور اندروید فیس بوک نسخه 4.28.2.0 پشتیبانی می کند. از آداپتور فیس بوک iOS نسخه 4.28.1.1 پشتیبانی می کند. نسخه 1.1.0 از Facebook Android SDK نسخه 4.28.1 پشتیبانی می کند. پشتیبانی از Facebook iOS SDK نسخه 4.28.1. نسخه 1.0.0 اولین انتشار! پشتیبانی از Facebook Android SDK نسخه 4.27.0. پشتیبانی از Facebook iOS SDK نسخه 4.27.1.