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

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

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

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

يوفّر محوّل التوسّط في "مدير إعلانات Google" لشبكة Meta Audience Network الميزات التالية:

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

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

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

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

  • أحدث إصدار من Google Mobile Ads Flutter Plugin
  • الإصدار 3.7.0 أو إصدار أحدث من إطار عمل Flutter
  • للنشر على أجهزة Android
    • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
  • للنشر على أجهزة iOS
    • الإصدار 15.0 أو إصدار أحدث من iOS deployment target
    • يتطلّب أحدث إصدار من حزمة تطوير البرامج (SDK) لشبكة Meta Audience Network عادةً أحدث إصدار من Xcode.
  • مشروع Flutter يعمل بشكل صحيح وتم إعداده باستخدام Google Mobile Ads Flutter Plugin لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads Flutter Plugin.
  • إعداد التوسّط

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

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

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

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

    إنشاء موقع

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

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

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

    Android

    iOS

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

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

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

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

    انقر على تم.

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

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

    ضبط إعدادات التوسّط لوحدتك الإعلانية

    Android

    للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

    iOS

    للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

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

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

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

    الدمج من خلال pub.dev

    أضِف التبعية التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) والمحوّل لشبكة Meta Audience Network في ملف pubspec.yaml الخاص بالحزمة:

    dependencies:
  gma_mediation_meta: ^1.7.1

    الدمج اليدوي

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

    dependencies:
  gma_mediation_meta:
    path: path/to/local/package

    الخطوة 4: تطبيق إعدادات الخصوصية على حزمة تطوير البرامج (SDK) لـ Meta Audience Network

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

    يُرجى مراجعة إرشادات Meta للحصول على معلومات حول "اللائحة العامة لحماية البيانات" والإعلانات على Meta.

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

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

    بالنسبة إلى المستخدمين في كاليفورنيا، يُرجى مراجعة خيارات معالجة البيانات في Meta.

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

    Android

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

    iOS

    تكامل SKAdNetwork

    اتّبِع مستندات Meta Audience Network لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

    تم تفعيل ميزة تتبُّع الإعلانات

    إذا كنت تنشئ تطبيقًا لنظام التشغيل iOS 14 أو إصدار أحدث، اطّلِع على تعليمات Meta Audience Network حول كيفية ضبط علامة تتبُّع الإعلانات.

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

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

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

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

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

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

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

    Android

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

    iOS

    لا ينطبق ذلك على عمليات الدمج مع أجهزة iOS.

    رموز الخطأ

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

    Android

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

    iOS

    GADMAdapterFacebook
GADMediationAdapterFacebook

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

    Android

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

    iOS

    رمز الخطأ السبب
    101 معلَمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف موضع الإعلان).
    102 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع Meta Audience Network.
    103 تعذّر إعداد عنصر إعلان Meta Audience Network.
    104 تعذّر على حزمة تطوير البرامج (SDK) لـ Meta Audience Network عرض "الإعلان البيني" أو "الإعلان مقابل مكافأة".
    105 وحدة التحكّم في العرض الجذر لإعلان البانر هي nil.
    106 تعذّر إعداد حزمة تطوير البرامج (SDK) لشبكة Meta Audience Network.
    1000-9999 عرضت Meta Audience Network خطأً خاصًا بحزمة تطوير البرامج (SDK). لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Meta Audience Network.

    سجلّ التغييرات في محوّل التوسّط في Flutter لـ Meta Audience Network

    الإصدار 1.7.1

    الإصدار 1.7.0

    الإصدار 1.6.0

    الإصدار 1.5.4

    الإصدار 1.5.3

    الإصدار 1.5.2

    الإصدار 1.5.1

    الإصدار 1.5.0

    الإصدار 1.4.3

    الإصدار 1.4.2

    الإصدار 1.4.1

    الإصدار 1.4.0

    الإصدار 1.3.0

    الإصدار 1.2.0

    الإصدار 1.1.0

    الإصدار 1.0.1

    الإصدار 1.0.0