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

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

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

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

يتضمّن محوّل التوسّط في AdMob لـ 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.
  • إعداد ميزة "توسّط AdMob"

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

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

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

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

Android

iOS

بعد إنشاء تطبيقك، اختَره من علامة التبويب التطبيقات للاطّلاع على التفاصيل وسجِّل مفتاح التطبيق.

Android

iOS

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_moloco: ^3.4.0

التكامل اليدوي

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

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

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

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

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

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

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

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

للتحقّق من أنّك تتلقّى إعلانات اختبارية من حزمة تطوير برامج Moloco Ads SDK، فعِّل اختبار مصدر إعلان واحد في أداة فحص الإعلانات باستخدام مصدر (مصادر) الإعلان 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 عرضت حزمة تطوير برامج Moloco SDK خطأً. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Moloco.

iOS

رمز الخطأ النطاق السبب
101 com.google.ads.mediation.moloco لا تتيح حزمة تطوير برامج Moloco SDK عرض الإعلانات على الإصدار 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 تم إرسالها من حزمة تطوير برامج Moloco SDK عرضت حزمة تطوير برامج Moloco SDK خطأً. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات 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