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

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

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

يمتلك محوِّل توسّط AdMob لخدمة Mintegral الإمكانات التالية:

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

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

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
    • ‫Unity 5.6 أو إصدار أحدث
    • [لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم مكوّن إضافي لدمج إعلانات Google على الأجهزة الجوّالة في Mintegral‏ 1.4.0 أو إصدار أحدث (ننصح باستخدام أحدث إصدار).
    • للنشر على Android
      • المستوى 21 لواجهة برمجة التطبيقات Android أو مستوى أعلى
    • للنشر على أجهزة iOS
      • إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
    • مشروع Unity صالح تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" اطّلِع على البدء لمعرفة التفاصيل.
    • إكمال التوسّط دليل البدء

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

اشترِك أو سجِّل الدخول إلى حسابك على Mintegral.

تحديد موقع مفتاح التطبيق

انتقِل إلى علامة التبويب إعدادات التطبيق ودوِّن مفتاح التطبيق.

إضافة تطبيق جديد

من علامة التبويب إعدادات التطبيق، انقر على الزر إضافة تطبيق.

اختَر النظام الأساسي واملأ بقية النموذج. بعد ذلك، انقر على حفظ.

Android

iOS

دوِّن رقم تعريف التطبيق.

Android

iOS

إنشاء موضع إعلان

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

Android

iOS

أدخِل اسم موضع الإعلان وشكل الإعلان.

عروض الأسعار

اختَر عروض الأسعار في الرؤوس كـ نوع عروض الأسعار. املأ بقية النموذج وانقر على حفظ.

شلال

اختَر تقليدية كـ نوع عروض الأسعار. املأ بقية النموذج وانقر على حفظ.

بعد إنشاء موضع إعلانك، دوِّن معرّف موضع الإعلان.

Android

iOS

انقر على القائمة المنسدلة وحدة إعلانية واحدة ودوِّن رقم تعريف الوحدة الإعلانية.

Android

iOS

تحديد موضع مفتاح واجهة برمجة التطبيقات Reporting API في Mintegral

عروض الأسعار

هذه الخطوة غير مطلوبة لدمج عروض الأسعار.

شلال

ستحتاج إلى مفتاح واجهة برمجة التطبيقات Reporting API في Mintegral لإعداد رقم تعريف الوحدة الإعلانية في AdMob. انتقِل إلى الحساب > أدوات واجهة برمجة التطبيقات. دوِّن Skey وSecret.

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

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

Android

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

iOS

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

إضافة Mobvista/Mintegral إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية

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

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

OpenUPM-CLI

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

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

OpenUPM

في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > مدير الحِزم لفتح إعدادات مدير حِزم Unity.

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

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

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى النافذة > مدير الحِزم لفتح مدير حِزم Unity و اختَر السجلّات الخاصة بي من القائمة المنسدلة.

سجلّات Unity

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

التثبيت من OpenUPM

حزمة Unity

نزِّل أحدث إصدار من المكوّن الإضافي لوسيط "إعلانات Google على الأجهزة الجوّالة" لتطبيق Mintegral من رابط التنزيل في سجلّ التغييرات واستخرِج ملف GoogleMobileAdsMintegralMediation.unitypackage من ملف zip.

في محرِّر مشروع Unity، اختَر مواد العرض > استيراد حزمة > حزمة مخصّصة وابحث عن GoogleMobileAdsMintegralMediation.unitypackage الملف الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

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

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

حلّ المشكلة بالقوة

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

Android

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

iOS

دمج SKAdNetwork

اتّبِع مستندات Mintegral لإضافة معرّفات SKAdNetwork إلى ملف Info.plist في مشروعك.

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

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

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

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

إثبات صحة الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من Mintegral، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصدرَي الإعلانات Mintegral (عروض الأسعار) وMintegral (العرض بدون انقطاع).

رموز الخطأ

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

Android

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

iOS

GADMediationAdapterMintegral

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

Android

رمز الخطأ النطاق السبب
101 com.google.ads.mediation.mintegral مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف التطبيق أو رقم تعريف موضع الإعلان)
102 com.google.ads.mediation.mintegral لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع Mintegral.
103 com.google.ads.mediation.mintegral استجابة عرض السعر غير متوفّرة أو غير صالحة
104 com.google.ads.mediation.mintegral عرَضت حزمة SDK من Mintegral خطأً يفيد بأنّه لم تتم التعبئة.

iOS

رمز الخطأ النطاق السبب
101 com.google.mediation.mintegral مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف التطبيق أو رقم تعريف موضع الإعلان)
102 com.google.mediation.mintegral عرَضت حزمة SDK من Mintegral خطأً يفيد بأنّه لم تتم التعبئة.
103 com.google.mediation.mintegral تعذّر على حزمة تطوير البرامج (SDK) من Mintegral عرض إعلان.
104 com.google.mediation.mintegral لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع Mintegral.

سجلّ التغييرات في المكوّن الإضافي Mintegral Unity Mediation Plugin

الإصدار 1.8.3

الإصدار 1.8.2

الإصدار 1.8.1

الإصدار 1.8.0

الإصدار 1.7.0

الإصدار 1.6.5

الإصدار 1.6.4

الإصدار 1.6.3

الإصدار 1.6.2

الإصدار 1.6.1

الإصدار 1.6.0

الإصدار 1.5.0

الإصدار 1.4.0

الإصدار 1.3.0

الإصدار 1.2.1

الإصدار 1.2.0

الإصدار 1.1.0

الإصدار 1.0.0