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

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

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

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

يملك محوّل التوسّط في AdMob لـ Moloco Ads SDK الإمكانات التالية:

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

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

قبل المتابعة، تأكَّد مما يلي:

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_moloco: ^3.5.0

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

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

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

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

لا يلزم توفير أي رمز برمجي إضافي لدمج Moloco Ads SDK.

الخطوة 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.5.1 (قيد التطوير)

الإصدار 3.5.0

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