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

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

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

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

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

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 3.7.0 من Flutter أو إصدار أحدث
  • للنشر على Android
    • المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
  • للنشر على أجهزة iOS
    • الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث
  • مشروع Flutter يعمل وتم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لمزيد من التفاصيل، يُرجى الاطّلاع على البدء.
  • أكمِل دليل البدء الخاص بالتوسّط

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

سجِّل الدخول إلى "بوابة الناشرين" في Moloco.

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

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

Android

iOS

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

Android

iOS

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_moloco: ^

الدمج اليدوي

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

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

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

لا يلزم استخدام رمز إضافي لدمج Moloco.

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

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

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

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

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

إثبات صحة الإعلانات بمكافأة من جانب الخادم

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

سجلّ التغيير في محوّل التوسّط لمنصة Moloco على Flutter

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

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

الإصدار 1.5.0

الإصدار 1.4.0

الإصدار 1.3.1

الإصدار 1.3.0

الإصدار 1.2.0

الإصدار 1.1.0

الإصدار 1.0.0