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

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

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

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

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

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫Unity 5.6 أو إصدار أحدث
  • الإصدار 1.2.0 أو إصدار أحدث من إضافة Moloco Unity
  • للنشر على Android
    • المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
  • للنشر على أجهزة iOS
    • الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث
  • مشروع Unity يعمل وتم إعداده باستخدام حزمة "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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت إضافة التوسّط بين "إعلانات Moloco" و"حزمة تطوير البرامج لإعلانات Google على الأجهزة الجوّالة" في Unity على مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

openupm add com.google.ads.mobile.mediation.moloco

OpenUPM

في أداة تعديل مشروع Unity، اختَر تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحِزم (Package Manager) لفتح إعدادات إدارة حِزم Unity (Unity Package Manager Settings).

ضمن علامة التبويب المستودعات المسجّلة ذات النطاق المحدود، أضِف OpenUPM كمستودع مسجّل ذي نطاق محدود مع التفاصيل التالية:

  • الاسم: OpenUPM
  • عنوان URL: https://package.openupm.com
  • النطاقات: com.google

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.

Unity Registries

اختَر حزمة Google Mobile Ads Moloco Mediation وانقر على تثبيت.

التثبيت من OpenUPM

حزمة Unity

نزِّل أحدث إصدار من إضافة التوسّط في "إعلانات Google على الأجهزة الجوّالة" الخاصة بحزمة تطوير البرامج (SDK) من Moloco Ads من رابط التنزيل في سجلّ التغيير، واستخرِج GoogleMobileAdsMolocoMediation.unitypackage من ملف ZIP.

في أداة تعديل مشروع Unity، اختَر Assets > Import Package > Custom Package، وابحث عن ملف GoogleMobileAdsMolocoMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

الاستيراد من Unity

بعد ذلك، اختَر مواد العرض (Assets) > أداة إدارة التبعيات الخارجية (External Dependency Manager) > أداة حلّ المشاكل في Android (Android Resolver) > فرض الحلّ (Force Resolve). ستنفّذ مكتبة External Dependency Manager عملية تحديد العناصر التابعة من البداية، وستنسخ العناصر التابعة المحدّدة إلى الدليل Assets/Plugins/Android في تطبيق Unity.

فرض الحل

الخطوة 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 Unity

الإصدار 1.6.1

الإصدار 1.6.0

الإصدار 1.5.0

الإصدار 1.4.0

الإصدار 1.3.1

الإصدار 1.3.0

الإصدار 1.2.1

الإصدار 1.2.0

الإصدار 1.1.0

الإصدار 1.0.0