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

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

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

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

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

انقر على تم.

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

مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك سوى من خلال القنوات التي حدَّدت أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف 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 إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) ولوائح الولايات الأمريكية

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

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    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.24.0-beta02'
    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 في ما يتعلّق باللائحة العامة لحماية البيانات (GDPR) وإعلانات Meta.

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

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

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

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

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

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

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

تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم 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، وقد يؤثر أيضًا في تجربة المستخدم وإيرادات الإعلانات. اتّبِع مستندات Meta لتعديل إعدادات أمان الشبكة في تطبيقك.

رموز الخطأ

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

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

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