حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في وضع الصيانة للحصول على آخر التحديثات والميزات، عليك migrate وإعداد "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة".

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

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

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

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

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

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

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

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

أحدث إصدار من Google Mobile Ads SDK (Legacy)
إعداد ميزة "توسّط AdMob"

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

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

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

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

إنشاء موقع

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

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

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

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

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

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

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

انقر على تم.

تعديل ملف app-ads.txt

مبادرة "البائعون المعتمَدون للتطبيقات" (app-ads.txt) هي مبادرة من "المختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقاتك إلا من خلال القنوات التي حدّدتها على أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، أعِدّ ملف app-ads.txt لتطبيقك.

لتنفيذ app-ads.txt في Meta Audience Network، يُرجى الاطّلاع على مقالة تحديد البائعين المعتمَدين باستخدام ملف app-ads.txt.

تفعيل "الوضع التجريبي"

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

الخطوة 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، يمكنك اختياره. بخلاف ذلك، انقر على إضافة عملية ربط.

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

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

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

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

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

في ملف gradle على مستوى التطبيق، أضِف تبعيات التنفيذ التالية:

Kotlin

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

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:facebook:6.22.0.1'
}

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (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). أنت مسؤول عن التحقّق من نشر الموافقة على كل مصدر إعلان في سلسلة التوسّط.

شركة Meta غير مسجَّلة في "قائمة المورّدين العالميين" (GVL) الصادرة عن مكتب IAB في أوروبا. بدلاً من ذلك، يجب استخدام المواصفات الفنية للموافقة الإضافية. لمزيد من التفاصيل، يُرجى الاطّلاع على مكوّنات "الموافقة الإضافية". تعمل مواصفات "الموافقة الإضافية" بالتزامن مع الإصدار 2 من "إطار الشفافية والموافقة" الصادر عن مكتب IAB في أوروبا. تتيح لك هذه المواصفات، إلى جانب منصّات إدارة الموافقة (CMP) والشركاء، جمع إشارات الموافقة التكميلية ونقلها للشركات المُدرَجة في قائمة مزوّدي التكنولوجيا الإعلانية (ATP) من Google، ولكنّها ليست جزءًا من قائمة المورّدين العالميين (GVL) الصادرة عن مكتب IAB في أوروبا.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مثال:

جافا

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

Kotlin

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

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

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

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

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

يعرض محوّل Audience Network إعلاناته المدمجة مع المحتوى كعناصر NativeAd. يتم ملء الحقول التالية: أوصاف حقول الإعلانات المدمجة مع المحتوى لـ NativeAd.

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

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

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

يوضّح الجدول التالي الحالات التي يتم فيها تسجيل مرّات ظهور "الإعلانات المدمجة مع المحتوى" والنقرات عليها من خلال "Google Mobile Ads SDK (Legacy)".

تسجيل مرّات الظهور	تسجيل النقرات
بكسل واحد من مادة عرض "الإعلان المدمج مع المحتوى" في 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 Audience Network، وقد يؤثر في تجربة المستخدم وإيرادات الإعلانات. اتّبِع مستندات Meta لتعديل إعدادات أمان الشبكة في تطبيقك.

رموز الخطأ

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

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

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل Audience Network عندما يتعذّر تحميل إعلان:

رمز الخطأ	السبب
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.

سجلّ التغييرات في محوّل التوسّط في Meta Audience Network لنظام التشغيل Android