دمج Moloco مع التوسّط

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

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

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

يملك محوّل التوسّط في "إدارة الإعلانات" لـ Moloco الإمكانات التالية:

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

المتطلبات

  • أحدث Google Mobile Ads Flutter Plugin
  • ‫Flutter 3.7.0 أو إصدار أحدث
  • للنشر على Android:
    • مستوى واجهة برمجة التطبيقات 23 من Android أو إصدار أحدث
  • للنشر على iOS:
    • هدف النشر على iOS هو الإصدار 13.0 أو إصدار أحدث
  • مشروع Flutter قيد التشغيل تم إعداده باستخدام Google Mobile Ads Flutter Plugin. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads Flutter Plugin.
  • إعداد التوسّط

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

سجِّل الدخول إلى Moloco Publisher Portal.

انتقِل إلى نظرة عامة > علامة التبويب التطبيقات ، ثم انقر على الزر إضافة تطبيق لإنشاء تطبيق جديد.

اختَر نظام التشغيل وإعدادات الخصوصية لتطبيقك، واملأ باقي النموذج، ثم انقر على إنشاء.

Android

iOS

بعد إنشاء تطبيقك، اختَره من علامة التبويب التطبيقات لعرض التفاصيل واحتفِظ بـ مفتاح التطبيق.

Android

iOS

انتقِل إلى نظرة عامة > علامة التبويب الوحدات الإعلانية ، واختَر التطبيق من القائمة المنسدلة، ثم انقر على وحدة إعلانية جديدة.

اختَر عروض الأسعار داخل التطبيق كـ طريقة المزاد واملأ باقي النموذج. بعد ذلك، انقر على إنشاء.

انتقِل إلى الوحدة الإعلانية التي أنشأتها حديثًا ضمن علامة التبويب الوحدات الإعلانية لعرض تفاصيلها. احتفِظ بـ معرّف الوحدة الإعلانية.

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

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

Android

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

iOS

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

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

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

الخطوة 3: استيراد حزمة تطوير برامج (SDK) ومحوّل Moloco

التكامل من خلال pub.dev

أضِف مصدر الاعتمادية التالي مع أحدث إصدارَين من حزمة تطوير برامج (SDK) ومحوّل Moloco Ads في ملف pubspec.yaml لحزمتك:

dependencies:
  gma_mediation_moloco: ^3.3.0

الدمج اليدوي

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

dependencies:
  gma_mediation_moloco:
    path: path/to/local/package

الخطوة 4: إضافة الرمز البرمجي المطلوب

لا يلزم إضافة أي رمز برمجي إضافي لعملية دمج Moloco.

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

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

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

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

للتأكّد من أنّك تتلقّى إعلانات اختبارية من حزمة تطوير برامج (SDK) من Moloco Ads، فعِّل اختبار مصدر إعلان واحد في أداة فحص الإعلانات باستخدام مصدر (مصادر) الإعلان Moloco (عروض الأسعار).

رموز الخطأ

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

Android

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

iOS

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

Android

رمز الخطأ النطاق السبب
101 com.google.ads.mediation.moloco مفتاح تطبيق Moloco غير متوفّر أو غير صالح
102 com.google.ads.mediation.moloco معرّف الوحدة الإعلانية في Moloco غير متوفّر أو غير صالح
103 com.google.ads.mediation.moloco كان عنصر إعلان Moloco الذي تم عرضه فارغًا.
من -1 إلى 5000 com.moloco.sdk عرضت حزمة تطوير برامج (SDK) من Moloco خطأً. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Moloco.

iOS

رمز الخطأ النطاق السبب
101 com.google.ads.mediation.moloco لا تتيح حزمة تطوير برامج (SDK) من Moloco عرض الإعلانات على الإصدار 12 من نظام التشغيل iOS والإصدارات الأقدم.
102 com.google.ads.mediation.moloco مفتاح تطبيق Moloco غير متوفّر أو غير صالح
103 com.google.ads.mediation.moloco معرّف الوحدة الإعلانية في Moloco غير متوفّر أو غير صالح
104 com.google.ads.mediation.moloco الإعلان غير جاهز للعرض.
105 com.google.ads.mediation.moloco تعذّر عرض الإعلان.
106 com.google.ads.mediation.moloco بيانات العرض غير متاحة لعرض الإعلان.
من -1 إلى 5000 تم إرسالها بواسطة حزمة تطوير برامج (SDK) من Moloco عرضت حزمة تطوير برامج (SDK) من Moloco خطأً. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Moloco.

عملية تحقّق من جهة الخادم للإعلانات مقابل مكافأة

إذا كنت تتحقّق من معاودات الاتصال لعملية تحقّق من جهة الخادم (SSV)، يكون معرّف مصدر الإعلان لـ Moloco هو 8267622065755668722.

سجلّ التغييرات في محوّل التوسّط في Moloco Flutter

الإصدار 3.4.0 (قيد التطوير)

  • تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1
  • تم التعديل ليتوافق مع الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads

الإصدار 3.3.0

الإصدار 3.2.0

الإصدار 3.1.0

الإصدار 3.0.0

الإصدار 2.1.0

الإصدار 2.0.0

الإصدار 1.6.0

الإصدار 1.5.0

الإصدار 1.4.0

الإصدار 1.3.1

الإصدار 1.3.0

الإصدار 1.2.0

الإصدار 1.1.0

الإصدار 1.0.0