این راهنما به شما نشان میدهد که چگونه از GMA Next-Gen SDK برای بارگذاری و نمایش تبلیغات از Meta Audience Network با استفاده از میانجیگری استفاده کنید و ادغامهای پیشنهاد قیمت را پوشش میدهد. این راهنما نحوه اضافه کردن Meta Audience Network به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام Meta Audience Network SDK و آداپتور آن را در یک برنامه اندروید پوشش میدهد.
ادغامها و قالبهای تبلیغاتی پشتیبانیشده
آداپتور میانجیگری برای شبکه مخاطبان متا (Meta Audience Network) قابلیتهای زیر را دارد:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار ۱ | |
| قالبها | |
| بنر ۲ | |
| بینابینی | |
| پاداش داده شده | |
| تبلیغات بینابینی پاداشدار | |
| بومی | |
۱ شبکه مخاطبان متا فقط در سال ۲۰۲۱ به مناقصه تبدیل شد.
۲- شبکه مخاطبان متا از بنرهای تطبیقی درونخطی و لنگردار پشتیبانی نمیکند.
الزامات
آخرین GMA Next-Gen SDK .
راهنمای شروع میانجیگری را تکمیل کنید.
- اندروید API سطح ۲۴ یا بالاتر
- آداپتور شبکه Meta Audience نسخه ۵.۱۰.۰.۰ یا بالاتر ( آخرین نسخه توصیه میشود )
مرحله ۱: تنظیمات را در رابط کاربری شبکه مخاطبان متا تنظیم کنید
ثبت نام کنید و به صفحه شروع مدیر کسب و کار وارد شوید.
روی شروع به کار (Get started) و سپس ایجاد حساب کاربری جدید (Create new account) کلیک کنید.
فیلدهای مورد نیاز را با جزئیات کسب و کار خود پر کنید و روی «بعدی» کلیک کنید.
ایجاد یک ملک
پس از پر کردن اطلاعات مورد نیاز، از شما خواسته میشود که یک ویژگی برای برنامه خود ایجاد کنید. نام دلخواه ویژگی برنامه خود را وارد کنید و روی «بعدی» کلیک کنید.
در مرحله بعد، پلتفرم خود را برای کسب درآمد انتخاب کنید.
جزئیات برنامه خود را اضافه کنید و روی «بعدی» کلیک کنید.
با کلیک روی «افزودن یک حساب پرداخت جدید»، حساب پرداخت خود را تنظیم کنید. برای وارد کردن اطلاعات پرداخت خود به صفحه جدیدی هدایت خواهید شد. جزئیات لازم را پر کنید، سپس روی «بعدی» کلیک کنید.
Google Ad Manager را به عنوان پلتفرم میانجیگری انتخاب کنید، سپس روی ایجاد جایگاه کلیک کنید.
یک قالب انتخاب کنید، فرم را پر کنید و روی ایجاد کلیک کنید.
شناسهی محل قرارگیری را یادداشت کنید.
روی انجام شد کلیک کنید.
فایل app-ads.txt خود را بهروزرسانی کنید.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .
برای پیادهسازی app-ads.txt برای شبکه مخاطبان متا، به شناسایی فروشندگان مجاز با app-ads.txt مراجعه کنید.
حالت تست را روشن کنید
برای دستورالعملهای دقیق در مورد نحوه فعالسازی تبلیغات آزمایشی شبکه مخاطبان متا، به راهنمای پیادهسازی شبکه مخاطبان آزمایشی مراجعه کنید.
مرحله ۲: تنظیم تقاضای شبکه مخاطبان متا در رابط کاربری مدیریت تبلیغات
وارد حساب مدیر تبلیغات خود شوید.
فعال کردن اشتراکگذاری امن سیگنال
به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراکگذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.
سیگنال امن را در درخواستهای پیشنهاد به اشتراک بگذارید
به بخش موجودی > سیگنالهای امن بروید. در زیر سیگنالهای امن ، فیسبوک را جستجو کنید و گزینه فعال کردن ادغام برنامه را فعال کنید.
روی ذخیره کلیک کنید.
امکان اشتراکگذاری امن سیگنال برای مناقصه SDK
به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیشفرض ، گزینه «اجازه اشتراکگذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.
روی ذخیره کلیک کنید.
پیکربندی پیشنهاد قیمت متا
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
روی پیشنهاددهنده جدید کلیک کنید.
متا را به عنوان پیشنهاد دهنده انتخاب کنید.
برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.
روی انجام شد کلیک کنید.
پیکربندی نگاشت واحد تبلیغات
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
شرکت مربوط به شبکه مخاطبان متا (Meta Audience Network) را انتخاب کنید.
به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.
واحد تبلیغاتی خاص را انتخاب کنید. یک واحد تبلیغاتی و قالب آن، برنامه موبایل را به عنوان نوع موجودی و برنامه موبایل خود انتخاب کنید. سپس، شناسه قرارگیری (Placement ID) به دست آمده در بخش قبل را وارد کنید.
اگر در حال پیکربندی نگاشت واحد تبلیغاتی برای یک تبلیغ بینابینی پاداشدار در رابط کاربری مدیر تبلیغات هستید، قالب پاداشدار را انتخاب کنید و از شناسه قرارگیری بینابینی پاداشدار استفاده کنید.
در نهایت، روی ذخیره کلیک کنید.
اضافه کردن متا به فهرست شرکای تبلیغاتی مقررات GDPR و ایالت ایالات متحده
برای افزودن متا به فهرست شرکای تبلیغاتی با مقررات ایالتی اروپا و ایالات متحده در رابط کاربری مدیر تبلیغات، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
مرحله ۳: SDK و آداپتور Meta Audience Network را وارد کنید
ادغام با اندروید استودیو (توصیه میشود)
در فایل gradle سطح برنامه خود، وابستگیها و پیکربندیهای پیادهسازی زیر را اضافه کنید:
کاتلین
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02") 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-beta02' 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 و تبلیغات متا، راهنماییهای موجود در مستندات متا را دنبال کنید.
قوانین حفظ حریم خصوصی ایالتهای آمریکا
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
برای گزینههای پردازش دادهها برای کاربران در کالیفرنیا، از راهنماییهای موجود در مستندات متا پیروی کنید.
مرحله ۵: اضافه کردن کد مورد نیاز
برای ادغام شبکه مخاطبان متا، هیچ کد اضافی لازم نیست.
مرحله ۶: پیادهسازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کردهاید و حالت آزمایشی را در رابط کاربری Meta Audience Network فعال کردهاید .
تأیید تبلیغات آزمایشی
برای تأیید اینکه تبلیغات آزمایشی را از شبکه مخاطبان متا دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی شبکه مخاطبان متا (مناقصه ) فعال کنید.
مراحل اختیاری
تبلیغات بومی
برخی از داراییهای تبلیغات بومی Meta Audience Network به صورت یک به یک به داراییهای تبلیغات بومی Google نگاشت نمیشوند. چنین داراییهایی از طریق متد getExtras() در NativeAd به صورت یک بسته به ناشر ارسال میشوند. آداپتور از ارسال داراییهای زیر پشتیبانی میکند:
| درخواست پارامترها و مقادیر | |
|---|---|
FacebookMediationAdapter.KEY_ID | رشته . شناسه منحصر به فرد تبلیغ بومی |
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET | رشته . زمینه اجتماعی تبلیغ |
در اینجا یک نمونه کد وجود دارد که نحوه استخراج این داراییها را نشان میدهد:
مثال:
کاتلین
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 |
|---|---|
| تیتر | |
| تصویر | ۱ |
| بدن | |
| آیکون برنامه | |
| فراخوان برای اقدام | |
| نام تبلیغ کننده | |
| رتبهبندی ستارهای | |
| فروشگاه | |
| قیمت |
آداپتور شبکه مخاطبان متا (Meta Audience Network) دسترسی مستقیم به تصویر اصلی تبلیغات بومی خود را فراهم نمیکند. در عوض، این آداپتور، MediaView را با یک ویدیو یا تصویر پر میکند.
ردیابی نمایش و کلیک
جدول زیر زمان ثبت نمایشها و کلیکهای تبلیغات بومی توسط GMA Next-Gen SDK را نشان میدهد.
| ثبت برداشت | روی ضبط کلیک کنید |
|---|---|
| ۱ پیکسل از محتوای تبلیغاتی بومی شبکه مخاطبان متا روی صفحه نمایش + الزامات رندر محتوا | فراخوانی SDK شبکه مخاطبان متا |
شبکه مخاطبان متا، بسته به اینکه هنگام تنظیم شبکه مخاطبان متا، قالب بنر بومی یا بومی را انتخاب کرده باشید، الزامات خاصی برای نمایش محتوا دارد تا یک نمایش معتبر تلقی شود.
| قالب بومی شبکه مخاطبان متا | دارایی مورد نیاز | کلاس رندر مورد نیاز |
|---|---|---|
| بومی | نمای رسانه | MediaView |
| بنر بومی | آیکون برنامه | ImageView |
ذخیره سازی در حافظه پنهان (caching) در اندروید ۹
از اندروید ۹ (سطح API 28)، پشتیبانی از متن واضح (cleartext) به طور پیشفرض غیرفعال است ، که بر عملکرد ذخیرهسازی رسانهای SDK شبکه مخاطبان متا (Meta Audience Network SDK) تأثیر میگذارد و میتواند بر تجربه کاربری و درآمد تبلیغات تأثیر بگذارد. برای بهروزرسانی پیکربندی امنیت شبکه در برنامه خود، مستندات متا را دنبال کنید.
کدهای خطا
اگر آداپتور نتواند تبلیغی از شبکه مخاطبان دریافت کند، میتوانید خطای اساسی را از پاسخ تبلیغ با استفاده از ResponseInfo.getAdSourceResponses() تحت کلاسهای زیر بررسی کنید:
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
در اینجا کدها و پیامهای همراه که توسط آداپتور شبکه Audience هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آمده است:
| کد خطا | دلیل |
|---|---|
| ۱۰۱ | پارامترهای سرور نامعتبر است (مثلاً شناسه قرارگیری وجود ندارد). |
| ۱۰۲ | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط شبکه مخاطبان متا مطابقت ندارد. |
| ۱۰۳ | ناشر باید تبلیغاتی با زمینه Activity (Activity context) درخواست کند. |
| ۱۰۴ | SDK شبکه مخاطبان متا (Meta Audience Network SDK) نتوانست مقداردهی اولیه شود. |
| ۱۰۵ | ناشر درخواستی برای تبلیغات بومی یکپارچه (Unified Native ads) ارائه نکرده بود. |
| ۱۰۶ | تبلیغ بومی بارگذاری شده، شیء متفاوتی نسبت به آنچه انتظار میرفت، است. |
| ۱۰۷ | شیء Context استفاده شده نامعتبر است. |
| ۱۰۸ | تبلیغ بارگذاری شده فاقد ویژگیهای لازم برای تبلیغات همسان است. |
| ۱۰۹ | ایجاد تبلیغ بومی از طریق ظرفیت پیشنهاد قیمت ناموفق بود. |
| ۱۱۰ | SDK شبکه مخاطبان متا (Meta Audience Network SDK) نتوانست تبلیغ بینابینی/پاداشدار خود را ارائه دهد. |
| ۱۱۱ | هنگام ایجاد شیء AdView شبکه مخاطبان متا، استثنا ایجاد میشود. |
| ۱۰۰۰-۹۹۹۹ | شبکه مخاطبان متا (Meta Audience Network) یک خطای مختص SDK را برگرداند. برای جزئیات بیشتر به مستندات شبکه مخاطبان متا مراجعه کنید. |