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

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

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

را Ad Manager آداپتور میانجی برای شبکه Meta Audience دارای قابلیت های زیر است:

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

1 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: تنظیمات را در رابط کاربری شبکه متا مخاطبان تنظیم کنید

مرحله 2: تقاضای شبکه Meta Audience را در آن تنظیم کنید Ad Manager UI

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

مراحل را دنبال کنیدتنظیمات GDPRوتنظیمات مقررات ایالتی ایالات متحدهبرای اضافه کردنFacebook به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده در Ad Manager UI.

،

مراحل را دنبال کنیدتنظیمات GDPRوتنظیمات مقررات ایالتی ایالات متحدهبرای اضافه کردنFacebook به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده در Ad Manager UI.

،

مراحل را دنبال کنیدتنظیمات GDPRوتنظیمات مقررات ایالتی ایالات متحدهبرای اضافه کردنFacebook به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده در Ad Manager UI.

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

OpenUPM-CLI

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

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

OpenUPM

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

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

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

جزئیات OpenUPM

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

ثبت واحدها

بسته میانجی شبکه متا مخاطبین تبلیغات Google Mobile را انتخاب کنید و روی Install کلیک کنید.

از OpenUPM نصب کنید

پکیج یونیتی

آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل برای شبکه متا مخاطبان را از لینک دانلود در 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 Network SDK اجرا کنید

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

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

قوانین حفظ حریم خصوصی ایالات متحده

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

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

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

اندروید

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

iOS

ادغام SKAdNetwork

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

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

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

مرحله 6: اجرای خود را آزمایش کنید

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

کش در اندروید 9

اندروید

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

iOS

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

کدهای خطا

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

اندروید 

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

iOS 

GADMAdapterFacebook
GADMediationAdapterFacebook

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

اندروید

کد خطا دلیل
101 پارامترهای سرور نامعتبر (به عنوان مثال شناسه مکان وجود ندارد).
102 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از شبکه متا مخاطب مطابقت ندارد.
103 ناشر باید تبلیغاتی با زمینه Activity درخواست کند.
104 SDK شبکه Meta Audience راه اندازی نشد.
105 ناشر برای تبلیغات بومی Unified درخواست نکرده است.
106 تبلیغ بومی بارگیری شده شی متفاوت از چیزی است که انتظار می رود.
107 شی Context استفاده شده نامعتبر است.
108 آگهی بارگیری شده دارایی‌های مورد نیاز تبلیغات بومی را ندارد.
109 ایجاد یک آگهی بومی از محموله پیشنهادی انجام نشد.
110 Meta Audience Network 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 مراجعه کنید.

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

نسخه 3.12.2

نسخه 3.12.1

نسخه 3.12.0

نسخه 3.11.0

نسخه 3.10.0

نسخه 3.9.1

نسخه 3.9.0

نسخه 3.8.0

نسخه 3.7.0

نسخه 3.6.1

نسخه 3.6.0

نسخه 3.5.0

نسخه 3.4.0

نسخه 3.3.2

نسخه 3.3.1

نسخه 3.3.0

نسخه 3.2.0

نسخه 3.1.0

نسخه 3.0.0

نسخه 2.12.0

نسخه 2.11.1

نسخه 2.11.0

نسخه 2.10.0

نسخه 2.9.2

نسخه 2.9.1

نسخه 2.9.0

نسخه 2.8.1

نسخه 2.8.0

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