دمج 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 API أو إصدار أحدث
  • للنشر على 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 (قيد التطوير)

الإصدار 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