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

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

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

يتضمّن محوّل التوسّط في "مدير إعلانات Google" الخاص بحزمة تطوير البرامج (SDK) لعرض إعلانات Moloco الميزات التالية:

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

قبل المتابعة، يُرجى التأكّد مما يلي:

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

الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم حزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات Moloco"

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

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

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

Android

iOS

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

Android

iOS

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

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

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

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

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

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

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

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

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

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

dependencies:
  gma_mediation_moloco: ^3.7.1

عملية الدمج اليدوية

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

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

الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) من Moloco

موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامّة لحماية البيانات"

للامتثال لسياسة موافقة المستخدِم في الاتحاد الأوروبي التي تتّبعها Google، عليك تقديم إفصاحات معيّنة للمستخدِمين في المنطقة الاقتصادية الأوروبية والمملكة المتحدة وسويسرا، والحصول على موافقتهم على استخدام ملفات تعريف الارتباط أو غيرها من وسائل التخزين المحلية حيثما يكون ذلك مطلوبًا بموجب القانون، وعلى جمع البيانات الشخصية ومشاركتها واستخدامها لتخصيص الإعلانات. تعكس هذه السياسة شروط "التوجيه الأوروبّي بشأن الخصوصية الإلكترونية" و"اللائحة العامّة لحماية البيانات" (GDPR) في الاتّحاد الأوروبّي. تتحمّل أنت مسؤولية التأكّد من نقل الموافقة إلى كل مصدر إعلان في سلسلة التوسّط.

يتيح الإصدار 1.0.0 من محوّل Moloco Ads SDK Flutter أو الإصدارات الأحدث نقل إشارات الموافقة بموجب اللائحة العامة لحماية البيانات (GDPR) من منصات إدارة الموافقة المتكاملة مع "إطار الشفافية والموافقة" الصادر عن مكتب IAB إلى حزمة Moloco Ads SDK. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات MolocoPrivacy لنظام التشغيل Android و سلسلة الموافقة في إطار الشفافية والموافقة لنظام التشغيل iOS.

قوانين الخصوصية في الولايات الأمريكية

تتطلّب قوانين الخصوصية في الولايات الأمريكية منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية إمكانية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن لا يمكن لـ Google تطبيق هذا الإعداد على كل شبكة إعلانات في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية واتّباع الإرشادات المقدَّمة من كل شبكة من هذه الشبكات لضمان الامتثال.

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

import 'package:gma_mediation_moloco/gma_mediation_moloco.dart';
// ...

GmaMediationMoloco.setDoNotSell(true);

اطّلِع على تعليمات التنفيذ المقترَحة لحزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات Moloco" على Android وiOS لمزيد من التفاصيل.

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

لا يلزم استخدام أي رمز إضافي لدمج حزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات Moloco".

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

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

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

تأكيد الإعلانات الاختبارية

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

رموز الخطأ

إذا لم يتمكّن المحوّل من تلقّي إعلان من Moloco، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo ضمن الفئات التالية:

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

MolocoSDK.MolocoError
GADMediationAdapterMoloco

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل Moloco عند تعذُّر تحميل إعلان:

سجلّ تغييرات "محوّل التوسّط" في Moloco Flutter

الإصدار 3.7.1

• يتوافق مع الإصدار 4.12.0.1 من محوّل Moloco Android.
• يتوافق مع الإصدار 4.10.0.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 3.7.0

• يتوافق مع الإصدار 4.12.0.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 4.10.0.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 3.6.1

• تم التحديث لدعم الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• تمت إضافة إمكانية استخدام أداة Swift Package Manager.
• يتوافق مع الإصدار 4.11.1.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 4.9.0.0 من محوّل Moloco على iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 3.6.0

• يتوافق مع الإصدار 4.11.0.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 4.9.0.0 من محوّل Moloco على iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 3.5.1

• يتوافق مع الإصدار 4.10.1.0 من محوّل Moloco لنظام التشغيل Android.
• يتوافق مع الإصدار 4.8.1.0 من محوّل Moloco iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 3.5.0

• يتوافق مع الإصدار 4.10.0.0 من برنامج Moloco Android الإضافي.
• يتوافق مع الإصدار 4.8.0.0 من محوّل Moloco iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 3.4.0

• تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1
• تم تعديلها لتتوافق مع الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
• يتوافق مع الإصدار 4.7.0.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 4.5.1.0 من محوّل Moloco لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 3.3.0

• يتوافق مع الإصدار 4.5.0.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 4.3.0.2 من محوّل Moloco لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 3.2.0

• يتوافق مع الإصدار 4.4.0.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 4.2.0.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 3.1.0

• تم تعديل الحدّ الأدنى لإصدار Flutter إلى 3.35.1
• يتوافق مع الإصدار 4.4.0.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 4.1.2.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 3.0.0

• يتوافق مع الإصدار 4.3.1.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 4.1.0.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.1.0

• يتوافق مع الإصدار 4.2.0.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 3.13.0.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.0.0

• يتوافق مع الإصدار 4.0.0.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 3.13.0.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.6.0

• يتوافق مع الإصدار 3.12.0.0 من برنامج Moloco Android الإضافي.
• يتوافق مع الإصدار 3.12.0.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.5.0

• يتوافق مع الإصدار 3.11.0.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 3.11.0.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.4.0

• يتوافق مع الإصدار 3.10.0.0 من محوّل Moloco لنظام التشغيل Android.
• يتوافق مع الإصدار 3.10.0.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.3.1

• يتوافق مع الإصدار 3.9.0.0 من برنامج Moloco Android الإضافي.
• يتوافق مع الإصدار 3.9.1.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.3.0

• يتوافق مع الإصدار 3.9.0.0 من برنامج Moloco Android الإضافي.
• يتوافق مع الإصدار 3.9.0.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.2.0

• يتوافق مع الإصدار 3.8.0.1 من محوّل Moloco Android.
• يتوافق مع الإصدار 3.8.0.0 من محوّل Moloco iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.1.0

• يتوافق مع الإصدار 3.7.0.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 3.6.0.0 من محوّل Moloco لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.0

• الإصدار الأوّلي
• يتوافق مع الإصدار 3.6.1.0 من محوّل Moloco Android.
• يتوافق مع الإصدار 3.6.0.0 من محوّل Moloco لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.