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

توجه: شبکه مخاطبان فیس بوک اکنون شبکه مخاطبان متا است. برای اطلاعات بیشتر به اطلاعیه متا مراجعه کنید.

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

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

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

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

¹ Meta Audience Network فقط در سال 2021 مناقصه شد.

الزامات

• جدیدترین SDK تبلیغات موبایل گوگل
• فلاتر 3.7.0 یا بالاتر
• برای استقرار در اندروید
  • Android API سطح 21 یا بالاتر
• برای استقرار در iOS
  • هدف استقرار iOS 10.0 یا بالاتر
  • آخرین نسخه متا مخاطبان شبکه SDK معمولاً به آخرین نسخه Xcode نیاز دارد.
• یک پروژه Flutter در حال کار که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
• راهنمای شروع میانجیگری را کامل کنید

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

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

روی شروع و سپس ایجاد حساب جدید کلیک کنید.

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

یک ملک ایجاد کنید

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

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

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

اندروید

iOS

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

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

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

توجه: فرمت بنر شبکه Meta Audience از فرمت نمایش مستطیل متوسط ​​و بنرهای عرض انعطاف پذیر با ارتفاع 50، 90 یا 250 پشتیبانی می کند.

شناسه مکان را یادداشت کنید.

روی Done کلیک کنید.

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

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

مرحله 2: درخواست شبکه Meta Audience را در رابط کاربری Ad Manager تنظیم کنید

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

اندروید

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

iOS

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

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

برای افزودن Meta به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری Ad Manager، مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

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

توجه: ادغام نشدن نسخه‌های متا مخاطب شبکه و نسخه‌های SDK تبلیغات تلفن همراه Google سازگار ممکن است منجر به مشکلات ساخت شود.

ادغام از طریق pub.dev

وابستگی زیر را با آخرین نسخه SDK و آداپتور Meta Audience Network در فایل pubspec.yaml بسته خود اضافه کنید:

dependencies:
  gma_mediation_meta: ^1.0.0

ادغام دستی

آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل را برای شبکه متا مخاطبان دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه فلاتر خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml خود مراجعه کنید:

dependencies:
  gma_mediation_meta:
    path: path/to/local/package

مرحله 4: تنظیمات حریم خصوصی را در Meta Audience Network SDK اجرا کنید

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

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

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

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

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

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

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

اندروید

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

iOS

ادغام SKAdNetwork

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

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

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

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

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

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

نکته کلیدی: هنگام آزمایش، مطمئن شوید که برنامه فیس بوک را روی دستگاه آزمایشی نصب کرده اید و با یک لاگین معتبر فیس بوک وارد شده اید. برای جزئیات بیشتر به مستندات متا مراجعه کنید.

مهم: قبل از انتشار برنامه، حالت آزمایشی را برای Ad Manager و Meta Audience Network غیرفعال کنید.

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

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

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

کش در اندروید 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 مراجعه کنید.

تغییرات آداپتور میانجی گری فلوتر شبکه متا مخاطبان

نسخه بعدی

• ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.

1.1.0

• سازگاری تایید شده با آداپتور متا اندروید نسخه 6.17.0.0
• سازگاری تایید شده با آداپتور Meta iOS نسخه 6.15.2.0
• با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.

1.0.1

• کلاس دارت اضافه شد تا امکان تجزیه و تحلیل سازگاری صحیح با پلتفرم های میزبان را فراهم کند
• سازگاری تایید شده با آداپتور متا اندروید نسخه 6.17.0.0
• سازگاری تایید شده با آداپتور Meta iOS نسخه 6.15.0.0
• با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.

1.0.0

• انتشار اولیه
• سازگاری تایید شده با آداپتور متا اندروید نسخه 6.17.0.0
• سازگاری تایید شده با آداپتور Meta iOS نسخه 6.15.0.0
• با افزونه Flutter Ads Google Mobile نسخه 5.0.0 ساخته و آزمایش شده است.