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

اختيار النظام الأساسي: Android (إصدار تجريبي) Android iOS Unity Flutter

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

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

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

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

المتطلبات

• أحدث GMA Next-Gen SDK

• أكمِل دليل البدء الخاص بالتوسّط.

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

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

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

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

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

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

إنشاء موقع

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

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

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

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

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

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

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

انقر على تم.

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

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

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

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

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

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

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

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

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

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

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

انقر على حفظ.

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

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

انقر على حفظ.

إعداد ميزة "عروض الأسعار الوصفية"

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

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

اختَر Meta كمقدِّم عرض سعر.

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

انقر على تم.

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

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

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

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

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

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

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

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

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

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    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.25.0-beta01'
    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) لشبكة Meta Audience Network على Android. استخرِج AudienceNetwork.aar من المجلد AudienceNetwork/bin وأضِفه إلى مشروعك.

• انتقِل إلى عناصر محوّل Meta Audience Network في مستودع Maven من Google. اختَر أحدث إصدار، ونزِّل ملف .aar الخاص بمحوّل شبكة Meta Audience Network، وأضِفه إلى مشروعك.

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

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

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

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

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

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

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

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

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

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

الخطوة 6: اختبار عملية الإعداد

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

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

تأكيد الإعلانات الاختبارية

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

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

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

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

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

مثال:

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);
    // ...
}

استخدام "الإعلانات المدمجة مع المحتوى" من 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 إمكانية الوصول المباشر إلى مادة عرض الصورة الرئيسية للإعلانات المدمجة مع المحتوى. بدلاً من ذلك، يملأ المحوّل MediaView بفيديو أو صورة.

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

يوضّح الجدول التالي الحالات التي يتم فيها تسجيل مرّات ظهور الإعلانات المدمجة مع المحتوى والنقرات عليها من خلال GMA Next-Gen SDK.

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

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

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

رموز الخطأ

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

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

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