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

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

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

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

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

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

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

المتطلبات

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

المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى

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

الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم Meta Audience Network

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

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

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

إنشاء موقع

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

الخطوة التالية هي اختيار المنصّة لتحقيق الربح.

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

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

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

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

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

انقر على تم.

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

اطّلع على دليل تنفيذ شبكة جمهور اختبار للحصول على تعليمات تفصيلية حول كيفية تفعيل الإعلانات الاختبارية "شبكة جمهور Meta".

الخطوة 2: إعداد طلب شبكة Meta Audience Network في واجهة مستخدم AdMob

ضبط إعدادات التوسّط لوحدتك الإعلانية

عليك إضافة Meta Audience Network إلى إعداد التوسّط لوحدتك الإعلانية.

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

لإنشاء مجموعة توسّط جديدة، اختَر إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصّة، ثمّ انقر على متابعة.

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

اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية AdMob الحالية. بعد ذلك، انقر على تمّ.

من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية التي تمت تعبئتها بالوحدات الإعلانية التي حدّدتها:

إضافة Meta Audience Network كمصدر إعلان

ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، اختَر إضافة مصدر الإعلان. بعد ذلك، اختَر Meta Audience Network.

انقر على كيفية توقيع اتّفاقية شراكة وإعداد شراكة مستندة إلى عروض الأسعار مع Meta Audience Network.

انقر على إقرار وموافقة، ثم انقر على متابعة.

إذا كان لديك تعيين بالفعل لـ Meta Audience Network، يمكنك تحديده. بخلاف ذلك، انقر على إضافة تعيين.

بعد ذلك، أدخِل Placement ID التي تم الحصول عليها في القسم السابق. بعد ذلك، انقر على تمّ.

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

اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة Facebook إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في AdMob واجهة المستخدم.

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

الدمج مع "استوديو Android" (يُنصح به)

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

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

الدمج اليدوي

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

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

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

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

اتّبِع الإرشادات الواردة في مستندات Meta. للّائحة العامة لحماية البيانات والإعلانات الوصفية

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

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

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

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

وليس عليك استخدام رمز إضافي لدمج شبكة Meta Audience Network.

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

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

احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم Meta Audience Network .

التحقّق من الإعلانات الاختبارية

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

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

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

بعض الإشعارات الإعلان المدمج مع المحتوى على شبكة 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 بدون 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) لشبكة Audience Network

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

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

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

بدءًا من الإصدار 9 من نظام التشغيل Android (المستوى 28 من واجهة برمجة التطبيقات)، يتم إيقاف دعم cleartext تلقائيًا ما سيؤثر في وظائف التخزين المؤقت للوسائط في Meta Audience حزمة تطوير البرامج (SDK) للشبكة ويمكن أن تؤثر في تجربة المستخدم وأرباح الإعلانات. متابعة مستندات 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 لمزيد من التفاصيل.