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

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

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

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

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

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

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

المتطلبات

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

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

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

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

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

إنشاء موقع

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

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

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

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

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

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

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

انقر على تم.

تعديل ملف 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 في واجهة مستخدم "إدارة الإعلانات"

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

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

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

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

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

انقر على حفظ.

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

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

انقر على حفظ.

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

انتقِل إلى التسليم > مقدّمو عروض الأسعار، ثمّ انقر على الانتقال إلى SDK Bidding.

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

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

انقر على متابعة لتفعيل SDK Bidding لمقدّم عرض السعر هذا.

انقر على تم.

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

انتقِل إلى التسليم > مقدّمو عروض الأسعار، ثمّ انقر على الانتقال إلى SDK Bidding.

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

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

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

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

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

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

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

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

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

Kotlin

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")
}

Groovy

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'
}

الدمج اليدوي

الخطوة 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: اختبار عملية الإعداد

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

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

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

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

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

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

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

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

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

مثال:

Kotlin 

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
العنوان
صورة 1
النص
رمز التطبيق
الحث على اتخاذ إجراء
اسم المعلن
التقييم بالنجوم
المتجر
السعر

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

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

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

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

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

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

التخزين المؤقت على 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 عند تعذّر تحميل إعلان:

رمز الخطأ السبب
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 لمزيد من التفاصيل.