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

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

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

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

يتميّز AdMob محوّل التوسّط لشبكة 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 على مستوى التطبيق، أضِف تبعيات التنفيذ وعمليات الضبط التالية. استخدِم أحدث إصدارات من حزمة تطوير البرامج (SDK) لشبكات Meta Audience Network ومحوّلها:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.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. اختَر أحدث إصدار، ونزِّل ملف .aar لمحوّل شبكة الجمهور Meta، وأضِفه إلى مشروعك.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إنّ بعض مواد عرض الإعلانات المدمجة مع المحتوى في 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 وسيتولّى المعدِّل تحميل شكل الإعلان المدمج المناسب تلقائيًا.

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

يعرض محوّل 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	مادة العرض المطلوبة	فئة العرض المطلوبة
مدمجة مع المحتوى	عرض الوسائط	`MediaView`
إعلان بانر مدمج مع المحتوى	رمز التطبيق	`ImageView`

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

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

رموز الخطأ

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

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	تعذّر على Meta Audience Network SDK عرض الإعلان البيني/إعلان المكافأة.
111	تم طرح استثناء عند إنشاء كائن `AdView` في Meta Audience Network.
101	معلمات خادم غير صالحة (على سبيل المثال، رقم تعريف موضع الإعلان غير موجود).
102	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع شبكة Meta Audience Network.
103	تعذّر إعداد كائن الإعلان Meta Audience Network.
104	تعذّر على Meta Audience Network SDK عرض الإعلان البيني/إعلان المكافأة.
105	وحدة التحكّم في العرض الجذري لإعلان البانر هي `nil`.
106	تعذّر إعداد حزمة تطوير البرامج (SDK) للشبكة Meta Audience Network.
1000-9999	عرضت Meta Audience Network خطأً متعلقًا بحزمة SDK. يمكنك الاطّلاع على مستندات Meta Audience Network للحصول على مزيد من التفاصيل.