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

پلتفرم مورد نظر را انتخاب کنید: اندروید (بتا) اندروید، iOS، یونیتی ، فلاتر

این راهنما به شما نشان می‌دهد که چگونه از GMA Next-Gen SDK برای بارگذاری و نمایش تبلیغات از Meta Audience Network با استفاده از AdMob Mediation استفاده کنید و ادغام‌های پیشنهاد قیمت را پوشش می‌دهد. این راهنما نحوه اضافه کردن Meta Audience Network به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام Meta Audience Network SDK و آداپتور آن را در یک برنامه اندروید پوشش می‌دهد.

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

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

^۱ شبکه مخاطبان متا فقط در سال ۲۰۲۱ به مناقصه تبدیل شد.
^۲- شبکه مخاطبان متا از بنرهای تطبیقی ​​درون‌خطی و لنگردار پشتیبانی نمی‌کند.

الزامات

• آخرین GMA Next-Gen SDK .

• راهنمای شروع میانجیگری را تکمیل کنید.

• اندروید API سطح ۲۴ یا بالاتر

• آداپتور شبکه Meta Audience نسخه ۵.۱۰.۰.۰ یا بالاتر ( آخرین نسخه توصیه می‌شود )

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

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

روی شروع به کار (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

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

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

ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به Add Meta Audience Network as an ad source بروید.

برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.

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

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

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

اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کرده‌اید پر شده است:

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

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

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

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

ادغام با اندروید استودیو (توصیه می‌شود)

در فایل gradle سطح برنامه خود، وابستگی‌ها و پیکربندی‌های پیاده‌سازی زیر را اضافه کنید:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta03")
    implementation("com.google.ads.mediation:facebook:6.21.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta03'
    implementation 'com.google.ads.mediation:facebook:6.21.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

ادغام دستی

• آخرین نسخه SDK شبکه مخاطبان متا برای اندروید را دانلود کنید. فایل AudienceNetwork.aar را از پوشه AudienceNetwork/bin استخراج کرده و به پروژه خود اضافه کنید.

• به مصنوعات آداپتور شبکه Meta Audience در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور شبکه Meta Audience را دانلود کنید و آن را به پروژه خود اضافه کنید.

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

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

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

متا در فهرست فروشندگان جهانی IAB اروپا (GVL) ثبت نشده است. در عوض، باید از مشخصات فنی «رضایت اضافی» استفاده کنید. برای جزئیات بیشتر، به «اجزای رضایت اضافی » مراجعه کنید. مشخصات رضایت اضافی در رابطه با نسخه ۲ چارچوب شفافیت و رضایت IAB اروپا (TCF) کار می‌کند. این مشخصات به شما، به همراه پلتفرم‌های مدیریت رضایت (CMPها) و شرکای آنها، اجازه می‌دهد سیگنال‌های رضایت تکمیلی را برای شرکت‌هایی که در فهرست ارائه‌دهندگان فناوری تبلیغات گوگل (ATP) فهرست شده‌اند، اما هنوز بخشی از GVL IAB اروپا نیستند، جمع‌آوری و ارسال کنید.

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

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

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

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

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

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

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

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

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

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

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

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

تبلیغات بومی

برخی از دارایی‌های تبلیغات بومی Meta Audience Network به صورت یک به یک به دارایی‌های تبلیغات بومی Google نگاشت نمی‌شوند. چنین دارایی‌هایی از طریق متد getExtras() در NativeAd به صورت یک بسته به ناشر ارسال می‌شوند. آداپتور از ارسال دارایی‌های زیر پشتیبانی می‌کند:

در اینجا یک نمونه کد وجود دارد که نحوه استخراج این دارایی‌ها را نشان می‌دهد:

مثال:

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
  var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
  // ...
}

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

استفاده از تبلیغات بومی شبکه مخاطبان متا بدون MediaView

قالب تبلیغات بومی Meta Audience Network نیاز به رندر کردن محتوای MediaView دارد. اگر قصد دارید تبلیغات بومی را بدون آن محتوا رندر کنید، حتماً از قالب بنر تبلیغاتی بومی Meta Audience Network استفاده کنید.

برای استفاده از بنرهای تبلیغاتی بومی Meta Audience Network، باید هنگام تنظیم Meta Audience Network، فرمت Native Banner را انتخاب کنید و آداپتور به طور خودکار فرمت تبلیغات بومی مربوطه را بارگذاری می‌کند.

رندرینگ آگهی

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

آداپتور شبکه مخاطبان ^متا (Meta Audience Network) دسترسی مستقیم به تصویر اصلی تبلیغات بومی خود را فراهم نمی‌کند. در عوض، این آداپتور، MediaView را با یک ویدیو یا تصویر پر می‌کند.

ردیابی نمایش و کلیک

جدول زیر زمان ثبت نمایش‌ها و کلیک‌های تبلیغات بومی توسط GMA Next-Gen SDK را نشان می‌دهد.

شبکه مخاطبان متا، بسته به اینکه هنگام تنظیم شبکه مخاطبان متا، قالب بنر بومی یا بومی را انتخاب کرده باشید، الزامات خاصی برای نمایش محتوا دارد تا یک نمایش معتبر تلقی شود.

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

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

کدهای خطا

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

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

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