ادغام شبکه مخاطبان فیس بوک با مناقصه

این راهنما برای ناشرانی در نظر گرفته شده است که می خواهند از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از شبکه مخاطبان فیس بوک از طریق مناقصه استفاده کنند. نحوه ادغام SDK و آداپتور شبکه مخاطبان فیس بوک در برنامه Unity را پوشش می دهد.

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

آداپتور میانجی AdMob برای شبکه مخاطبان فیس بوک دارای قابلیت های زیر است:

ادغام
مناقصه
آبشار
فرمت ها
بنر
بینابینی
پاداش داده شد
بینابینی پاداش

الزامات

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

مرحله 1: شبکه مخاطبان فیس بوک را راه اندازی کنید

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

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

یک ویژگی فیس بوک ایجاد کنید

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

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

مشخص کنید که آیا برنامه شما فعال است یا نه و روی ارسال کلیک کنید.

اندروید

iOS

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

Banner برای همه اندازه های بنر، از جمله برای 300x250 انتخاب کنید. فیس بوک از فرمت نمایش Medium Rectangle ​​در مناقصه پشتیبانی نمی کند، اما هنگام استفاده از قالب نمایش Banner ، از یک بنر با عرض انعطاف پذیر با ارتفاع 50، 90 یا 250 پشتیبانی می کند.

اگر می‌خواهید قالب تبلیغاتی با پاداش را ادغام کنید، قالب فیسبوک مربوطه Rewarded Video است.

مرحله بعدی نمای کلی از جایگاهی که ایجاد کرده اید را ارائه می دهد. شناسه قرارگیری را در قسمت افزودن شناسه قرارگیری یادداشت کنید.

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

باید فیسبوک را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید. ابتدا وارد حساب AdMob خود شوید.

اندروید

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

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

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

به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس وضعیت گروه میانجی را روی Enabled تنظیم کنید. سپس روی افزودن واحدهای تبلیغاتی کلیک کنید، که پوشش انتخاب واحد تبلیغات باز می شود.

این گروه میانجی را با واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید. اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کرده اید پر کنید.

شبکه مخاطبان فیس بوک را به عنوان منبع تبلیغاتی اضافه کنید

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

در نهایت روی Save کلیک کنید.

iOS

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

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

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

به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس وضعیت گروه میانجی را روی Enabled تنظیم کنید. سپس روی افزودن واحدهای تبلیغاتی کلیک کنید، که پوشش انتخاب واحد تبلیغات باز می شود.

این گروه میانجی را با واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کرده اید پر کنید.

شبکه مخاطبان فیس بوک را به عنوان منبع تبلیغاتی اضافه کنید

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

در نهایت روی Save کلیک کنید.

استفاده از تبلیغات پاداش

در تنظیمات واحد تبلیغات پاداش داده شده، مقادیری را برای مقدار پاداش و نوع پاداش ارائه کنید. سپس، برای اطمینان از ارائه همان پاداش به کاربر صرف نظر از اینکه کدام شبکه تبلیغاتی ارائه می شود، کادر Apply to all networks in Mediation groups را علامت بزنید.

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

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

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

آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل برای فیس بوک را از لینک دانلود در Changelog دانلود کنید و GoogleMobileAdsFacebookMediation.unitypackage را از فایل فشرده استخراج کنید.

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

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

مرحله 4: کد اضافی مورد نیاز است

اندروید

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

iOS

ادغام SKAdNetwork

فیس بوک از شما می خواهد که شناسه های SKAdNetwork زیر را به فایل Info.plist پروژه خود اضافه کنید:

<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>v9wttpbfk9.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>n38lu8286q.skadnetwork</string>
    </dict>
</array>

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

اگر برای iOS 14 یا جدیدتر می‌سازید، لطفاً دستورالعمل‌های فیس‌بوک در مورد نحوه تنظیم پرچم ردیابی تبلیغات خود را بررسی کنید.

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

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

خودشه! شما اکنون یک ادغام میانجی کاری با شبکه مخاطبان فیس بوک دارید.

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

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

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

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

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

CCPA

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

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

فیس بوک را به لیست شرکای تبلیغاتی CCPA اضافه کنید

مراحل را در تنظیمات CCPA دنبال کنید تا Facebook را به لیست شرکای تبلیغاتی CCPA در رابط کاربری AdMob اضافه کنید.

کدهای خطا

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

اندروید

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

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

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

اندروید

کد خطا دلیل
101 پارامترهای سرور نامعتبر (به عنوان مثال شناسه مکان موجود نیست).
102 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از شبکه مخاطبان فیس بوک مطابقت ندارد.
103 ناشر باید تبلیغاتی با زمینه Activity درخواست کند.
104 SDK شبکه مخاطبان فیس بوک راه اندازی نشد.
105 ناشر برای تبلیغات بومی Unified درخواست نکرده است.
106 تبلیغ بومی بارگیری شده شی متفاوت از آنچه مورد انتظار است است.
107 شی Context استفاده شده نامعتبر است.
108 آگهی بارگیری شده دارایی های مورد نیاز تبلیغات بومی را ندارد.
109 ایجاد یک آگهی بومی از محموله پیشنهادی انجام نشد.
110 SDK شبکه مخاطبان فیس بوک نتوانست تبلیغ بینابینی/پاداش خود را ارائه دهد.
111 هنگام ایجاد یک شیء AdView شبکه مخاطبان فیس بوک، استثنا وجود دارد.
1000-9999 شبکه مخاطبان فیس بوک یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات فیسبوک مراجعه کنید.

iOS

کد خطا دلیل
101 پارامترهای سرور نامعتبر (به عنوان مثال شناسه مکان موجود نیست).
102 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از شبکه مخاطبان فیس بوک مطابقت ندارد.
103 شیء تبلیغاتی شبکه مخاطبان فیس بوک راه اندازی نشد.
104 SDK شبکه مخاطبان فیس بوک نتوانست تبلیغ بینابینی/پاداش خود را ارائه دهد.
105 کنترلر نمای ریشه بنر تبلیغاتی nil است.
106 SDK شبکه مخاطبان فیس بوک راه اندازی نشد.
1000-9999 شبکه مخاطبان فیس بوک یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات فیسبوک مراجعه کنید.

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

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