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

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

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

محوِّل التوسّط AdMob في Meta Audience توفّر الشبكة الإمكانات التالية:

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

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

المتطلبات

  • أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • Flutter 3.7.0 أو إصدار أحدث
  • للنشر على Android
    • المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
  • للنشر على iOS
    • الإصدار 10.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
    • عادةً ما تتطلب أحدث حزمة تطوير برامج (SDK) من Meta Audience Network أحدث المعلومات إصدار Xcode.
  • مشروع Flutter عامل مهيأ باستخدام SDK لإعلانات Google على الأجهزة الجوّالة. عرض البدء لمعرفة التفاصيل.
  • أكمِل دليل البدء الخاص بالتوسّط.

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

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

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

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

إنشاء موقع

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

الخطوة التالية هي اختيار المنصّة لتحقيق الربح.

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

Android

iOS

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

اختر Google AdMob باعتباره منصّة التوسّط، ثمّ انقر على إنشاء موضع إعلان.

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

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

انقر على تم.

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

اطّلع على دليل تنفيذ شبكة جمهور اختبار للحصول على تعليمات تفصيلية حول كيفية تفعيل الإعلانات الاختبارية "شبكة جمهور Meta".

الخطوة 2: إعداد طلب شبكة Meta Audience Network في واجهة مستخدم AdMob

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_meta: ^1.0.0

الدمج اليدوي

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

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

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

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

يمكنك مراجعة إرشادات Meta للحصول على معلومات عن اللائحة العامة لحماية البيانات (GDPR) والإعلان الوصفي.

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

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

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

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

Android

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

iOS

دمج SKAdNetwork

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

رموز الخطأ

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

Android

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

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

في ما يلي الرموز والرسائل المصاحبة التي يطرحها جمهور Meta محوّل الشبكة عند تعذُّر تحميل إعلان:

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

1.0.1

  • تمت إضافة فئة dart للسماح بتحليل التوافق الصحيح مع الأنظمة الأساسية المضيفة.
  • تم التحقّق من التوافق مع الإصدار 6.17.0.0 لمحوّل Meta Android.
  • تم التحقق من التوافق مع الإصدار 6.15.0.0 لمحوّل Meta iOS.
  • تم إنشاء هذا البرنامج واختباره باستخدام الإصدار 5.1.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.

1.0.0

  • الإصدار الأولي.
  • تم التحقّق من التوافق مع الإصدار 6.17.0.0 لمحوّل Meta Android.
  • تم التحقق من التوافق مع الإصدار 6.15.0.0 لمحوّل Meta iOS.
  • تم إنشاء هذا المكوّن الإضافي واختباره باستخدام الإصدار 5.0.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.