تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

دمج Meta Audience Network مع عروض الأسعار

يوضّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من "شبكة جمهور Facebook" باستخدام التوسّط، ويتناول الدمج مع عروض الأسعار. ويتناول هذا الدليل كيفية إضافة Meta Audience Network إلى إعدادات التوسّط لوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوِّل Meta Audience Network في تطبيق Android.

عمليات الدمج وأشكال الإعلانات المتوافقة

تتوفر لبرنامج "محوِّل التوسّط" في Meta Audience Network الإمكانات التالية:

التكامل
عروض الأسعار
العرض بدون انقطاع ¹
التنسيقات
بانر
إعلان بيني
تم منح المكافأة
إعلان بيني يضمّ مكافأة
مدمجة مع المحتوى

¹ أصبحت منصّة Meta Audience Network تتيح عروض الأسعار فقط في عام 2021.

المتطلبات

أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
إكمال التوسّط دليل البدء

المستوى 21 من واجهة برمجة التطبيقات لنظام التشغيل Android أو إصدار أحدث

محوِّل Meta Audience Network‏ 5.10.0.0 أو إصدار أحدث (ننصح باستخدام أحدث إصدار)

الخطوة 1: إعداد الإعدادات في واجهة مستخدم "شبكة جمهور Facebook"

سجِّل الدخول إلى صفحة البدء في "مركز إدارة النشاط التجاري".

انقر على البدء ثم على إنشاء حساب جديد.

املأ الحقول المطلوبة بتفاصيل نشاطك التجاري وانقر على التالي.

إنشاء موقع

بعد ملء المعلومات المطلوبة، سيُطلب منك إنشاء موقع لتطبيقك. أدخِل الاسم المطلوب للموقع الخاص بتطبيقك وانقر على التالي.

بعد ذلك، اختَر المنصة التي تريد تحقيق الربح منها.

أضِف تفاصيل تطبيقك وانقر على التالي.

يمكنك إعداد حساب الدفع بالنقر على إضافة حساب دفع جديد. ستتم إعادة توجيهك إلى صفحة جديدة لإدخال معلومات الدفع. املأ التفاصيل اللازمة، ثم انقر على التالي.

اختَر Google AdMob كمنصّة توسّط، ثمّ انقر على إنشاء موضع إعلان.

اختَر تنسيقًا، واملأ النموذج وانقر على إنشاء.

دوِّن رقم تعريف موضع الإعلان.

انقر على تم.

تفعيل وضع الاختبار

اطّلِع على دليل اختبار تنفيذ Audience Network للحصول على تعليمات detallada حول كيفية تفعيل الإعلانات الاختبارية في Meta Audience Network.

الخطوة 2: إعداد طلب Meta Audience Network في واجهة مستخدم "مدير إعلانات Google"

سجِّل الدخول إلى حسابك على "مدير إعلانات Google".

تفعيل ميزة "مشاركة الإشارات الآمنة"

انتقِل إلى المشرف > الإعدادات العامة. انتقِل إلى علامة التبويب إعدادات حساب Ad Exchange وراجِع مشاركة الإشارات الآمنة وفعِّلها. انقر على حفظ.

مشاركة إشارة آمنة في طلبات عروض الأسعار

انتقِل إلى المستودع > الإشارات الآمنة. ضمن الإشارات الآمنة، ابحث عن Facebook وفعِّل تفعيل دمج التطبيقات.

انقر على حفظ.

السماح بمشاركة الإشارات الآمنة في عروض الأسعار باستخدام حِزم تطوير البرامج (SDK)

انتقِل إلى عرض الإعلانات > إعدادات قناة المستودع الإعلاني. في علامة التبويب الإعدادات التلقائية، فعِّل السماح بمشاركة الإشارات الآمنة في عروض أسعار برمجة التطبيقات (SDK) .

انقر على حفظ.

ضبط عروض الأسعار الوصفية

انتقِل إلى العرض > مقدّمو عروض الأسعار، ثمّ انقر على الانتقال إلى عروض الأسعار باستخدام حِزم تطوير البرامج (SDK).

انقر على مقدّم عروض أسعار جديد.

اختَر Meta كمقدّم عروض الأسعار.

انقر على متابعة لتفعيل ميزة "عروض الأسعار باستخدام حِزم تطوير البرامج (SDK)" لمقدّم عروض الأسعار هذا.

انقر على تم.

ضبط ربط الوحدات الإعلانية

اختَر الشركة التي تريد استخدامها في Meta Audience Network.

انتقِل إلى علامة التبويب ربط الوحدات الإعلانية وانقر على تعيين وحدة إعلانية جديد.

اختَر وحدة إعلانية محدّدة. اختَر وحدة إعلانية وتنسيقًا، والتطبيق المتوافق مع الأجهزة الجوّالة كنوع المستودع، والتطبيق المتوافق مع الأجهزة الجوّالة. بعد ذلك، أدخِل رقم تعريف موضع الإعلان الذي حصلت عليه في القسم السابق.

في حال كنت بصدد ضبط تعيين الوحدة الإعلانية لشدَّة الإعلان البيني بمكافأة ضمن واجهة مستخدم "مدير إعلانات Google"، اختَر شكل الإعلانات بمكافأة واستخدِم رقم تعريف موضع الإعلان البيني بمكافأة.

أخيرًا، انقر على حفظ.

إضافة "ميتا" إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" واللوائح التنظيمية السارية في الولايات الأمريكية

اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Meta إلى قائمة شركاء الإعلانات بموجب اللوائح التنظيمية الأوروبية وتلك في الولايات الأمريكية في واجهة مستخدِم "مدير إعلانات Google".

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوِّل Meta Audience Network

دمج "استوديو Android" (إجراء يُنصح به)

في ملف build.gradle.kts على مستوى التطبيق، أضِف الإعدادات التالية للتبعيات والإعدادات. استخدِم أحدث إصدارات من حزمة تطوير البرامج (SDK) ومحوّل Meta Audience Network:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:facebook:6.18.0.0")
}

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network لنظام التشغيل Android. استخرِج AudienceNetwork.aar ضمن مجلد AudienceNetwork/bin وأضِفه إلى مشروعك.
انتقِل إلى ملفّات محوِّل Meta Audience Network الترميز في مستودع Maven من Google. اختَر أحدث إصدار، ونزِّل ملف .aar لمحوِّل Meta Audience Network، وأضِفه إلى مشروعك.

الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network

موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامّة لحماية البيانات"

بموجب سياسة موافقة المستخدِم في الاتّحاد الأوروبي المتّبَعة في Google، عليك التأكّد من تقديم بيانات الإفصاح المعيّنة إلى المستخدِمين في المنطقة الاقتصادية الأوروبية والحصول على موافقاتهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR). عند طلب الموافقة، عليك تحديد كل شبكة إعلانية في سلسلة التوسّط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، و تقديم معلومات عن استخدام كل شبكة. لا يمكن لشركة Google حاليًا تمرير اختيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.

اتّبِع الإرشادات الواردة في مستندات Meta لتطبيق "اللائحة العامّة لحماية البيانات" (GDPR) والإعلانات على Meta.

قوانين الخصوصية في الولايات الأمريكية

تتطلّب قوانين الخصوصية في الولايات الأمريكية منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن لا يمكن لشركة Google تطبيق هذا الإعداد على كل شبكة إعلانية في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة مواقع إعلانية في سلسلة التوسّط التي قد تشارك في بيع المَعلومات الشخصية واتباع الإرشادات الواردة من كلّ من هذه الشبكات لضمان الامتثال.

اتّبِع الإرشادات الواردة في مستندات Meta لمعرفة خيارات معالجة البيانات للمستخدمين في كاليفورنيا.

الخطوة 5: إضافة الرمز المطلوب

لا يلزم استخدام رمز إضافي لدمج Meta Audience Network.

الخطوة 6: اختبار عملية التنفيذ

تفعيل الإعلانات الاختبارية

تأكَّد من تسجيل جهازك الاختباري في "مدير إعلانات Google" وتفعيل وضع الاختبار في واجهة مستخدم "شبكة جمهور Meta".

إثبات صحة الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من Meta Audience Network، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات في Meta Audience Network (عروض الأسعار).

الخطوات الاختيارية

إعلانات مدمجة مع المحتوى

لا تتمّ ربط بعض مواد عرض الإعلانات المدمجة مع المحتوى في Meta Audience Network بمواد عرض الإعلانات المدمجة مع المحتوى في Google بشكلٍ مباشر. ويتم تمرير مواد العرض هذه إلى الناشر في حِزمة من خلال طريقة getExtras() في NativeAd. يتيح المحوِّل تمرير مواد العرض التالية:

مَعلمات الطلب وقِيمه
`FacebookMediationAdapter.KEY_ID`	سلسلة: معرّف فريد للإعلان المدمج مع المحتوى
`FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET`	سلسلة: السياق الاجتماعي للإعلان

في ما يلي مثال على رمز برمجي يوضّح كيفية استخراج مواد العرض هذه:

مثال:

Java

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

Kotlin

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

استخدام الإعلانات المدمجة مع المحتوى في Meta Audience Network بدون MediaView

يتطلّب شكل الإعلان المدمج في Meta Audience Network عرض مادة العرض MediaView. إذا كنت تخطّط لعرض إعلانات مدمجة مع المحتوى بدون مادة العرض هذه، احرص على استخدام شكل إعلان بانر مدمج مع المحتوى في Meta Audience Network.

لاستخدام إعلانات البانر المدمجة مع المحتوى في Meta Audience Network بدلاً من ذلك، عليك اختيار شكل Native Banner عند إعداد Meta Audience Network وسيحمِّل ملف المحوِّل تلقائيًا شكل الإعلان المدمج المقابل.

عرض الإعلانات

يعرض محوِّل "شبكة الجمهور" إعلاناته المدمجة مع المحتوى على هيئة عناصر NativeAd. وتعبِّئ هذه العملية الحقول التالية لجدول NativeAd.

الحقل	تتم تعبئة هذه السمة بواسطة محوّل Meta Audience Network.
العنوان
صورة	1
النص
رمز التطبيق
الحث على اتخاذ إجراء
اسم المعلن
التقييم النجمي
المتجر
السعر

¹ لا يقدّم محوِّل Meta Audience Network إمكانية الوصول مباشرةً إلى مادة عرض الصورة الرئيسية لإعلاناته المدمجة مع المحتوى. بدلاً من ذلك، يملؤه المحوِّل MediaView بفيديو أو صورة.

تتبُّع مرّات الظهور والنقرات

يوضّح الجدول التالي الحالات التي تسجِّل فيها "حزمة SDK لإعلانات Google على الأجهزة الجوّالة" مرّات ظهور الإعلانات المدمَجة مع المحتوى والنقرات عليها.

تسجيل مرّات الظهور	انقر على التسجيل.
‫1 بكسل من مادة عرض الإعلانات المدمجة مع المحتوى في Meta Audience Network على الشاشة + متطلبات عرض مادة العرض	طلب إعادة الاتصال لحزمة تطوير البرامج (SDK) في Meta Audience Network

تفرض Meta Audience Network متطلبات معيّنة لعرض مواد العرض من أجل اعتبار مرّة الظهور صالحة، وذلك استنادًا إلى ما إذا اخترت شكل الإعلان المدمج مع المحتوى أو إعلان البانر المدمج مع المحتوى عند إعداد Meta Audience Network.

التنسيق المدمج مع المحتوى في Meta Audience Network	مادة العرض المطلوبة	فئة العرض المطلوبة
مدمجة مع المحتوى	عرض الوسائط	`MediaView`
إعلان بانر مضمّن	رمز التطبيق	`ImageView`

التخزين المؤقت على Android 9

بدءًا من Android 9 (المستوى 28 من واجهة برمجة التطبيقات)، يكون خيار استخدام النص الواضح غير مفعّل تلقائيًا، ما سيؤثّر في وظيفة تخزين الوسائط المؤقت لحزمة تطوير البرامج (SDK) لشبكة قياس الجمهور في Meta، وقد يؤثّر ذلك في تجربة المستخدم وأرباح الإعلانات. اتّبِع مستندات Meta لتعديل إعدادات أمان الشبكة في تطبيقك.

رموز الخطأ

إذا تعذّر على المُحوِّل تلقّي إعلان من Audience Network، يمكنك التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo.getAdapterResponses() ضمن الفئات التالية:

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

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل "شبكة الجمهور" عند تعذُّر تحميل إعلان:

رمز الخطأ	السبب
101	مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف موضع الإعلان)
102	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع Meta Audience Network.
103	على الناشر طلب الإعلانات التي تتضمّن سياق `Activity`.
104	تعذّر إعداد حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network.
105	لم يطلب الناشر الإعلانات المدمجة الموحّدة مع المحتوى.
106	الإعلان المدمَج الذي تم تحميله هو عنصر مختلف عن العنصر المتوقّع.
107	عنصر `Context` المستخدَم غير صالح.
108	لا يتضمّن الإعلان المحمَّل مواد عرض الإعلانات المدمجة مع المحتوى المطلوبة.
109	تعذّر إنشاء إعلان مضمّن من الحمولة البرمجية لعرض السعر.
110	تعذّر على حزمة تطوير البرامج (SDK) في Meta Audience Network عرض الإعلان البيني/الإعلان ذي المكافأة.
111	تم طرح استثناء عند إنشاء عنصر `AdView` في Meta Audience Network.
1000-9999	عرَض Meta Audience Network خطأً خاصًا بحزمة تطوير البرامج (SDK). يمكنك الاطّلاع على مستندات Meta Audience Network لمزيد من التفاصيل.