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

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

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

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

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

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

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

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

  • أحدث إصدار من Google Mobile Ads Unity Plugin
  • الإصدار 5.6 من Unity Editor أو إصدار أحدث
  • [لتقديم عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم إضافة التوسّط في "إعلانات Google على الأجهزة الجوّالة" للإصدار 1.4.0 أو إصدار أحدث من Mintegral (يُنصح باستخدام أحدث إصدار).
  • للنشر على أجهزة Android
    • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
  • للنشر على iOS
    • الإصدار 13.0 من نظام التشغيل iOS أو إصدار أحدث
  • مشروع Unity يعمل بشكل صحيح وتم ضبطه باستخدام Google Mobile Ads Unity Plugin. لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Unity Plugin.
  • إعداد التوسّط
  • الخطوة 1: ضبط الإعدادات في واجهة مستخدم Mintegral

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

    العثور على مفتاح التطبيق

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

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

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

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

    Android

    iOS

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

    Android

    iOS

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

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

    Android

    iOS

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

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

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

    Android

    iOS

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

    Android

    iOS

    العثور على مفتاح واجهة برمجة التطبيقات لإعداد التقارير في Mintegral

    عروض الأسعار

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

    شلال

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

    تعديل ملف app-ads.txt

    مبادرة "البائعون المعتمَدون للتطبيقات" (app-ads.txt) هي مبادرة من "المختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقاتك إلا من خلال القنوات التي حدّدتها على أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، عليك إنشاء ملف app-ads.txt في "إدارة إعلانات Google".

    لتنفيذ app-ads.txt في Mintegral، يُرجى الاطّلاع على كيفية مساهمة ملف app-ads.txt في مكافحة الاحتيال الإعلاني.

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

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

    Android

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

    iOS

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

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

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

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

    OpenUPM-CLI

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

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

    OpenUPM

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

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

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

    تفاصيل‫ OpenUPM

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

    Unityمستودعات ‫

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

    التثبيت من‫ OpenUPM

    حزمة Unity

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

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

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

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

    فرض الحلّ

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

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

    يتيح الإصدار 2.2.3 والإصدارات الأحدث من برنامج Mintegral Unity الوسيط تمرير إشارات الموافقة بموجب "اللائحة العامة لحماية البيانات" من منصات إدارة الموافقة المتكاملة مع "إطار الشفافية والموافقة" الصادر عن مكتب IAB إلى حزمة تطوير البرامج (SDK) من Mintegral. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات بيان الامتثال للخصوصية في حزمة تطوير البرامج (SDK) لنظامَي التشغيل Android وiOS من Mintegral.

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

    Android

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

    iOS

    دمج SKAdNetwork

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

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

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

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

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

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

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

    رموز الخطأ

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

    Android

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

    iOS

    GADMediationAdapterMintegral
    

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

    Android

    رمز الخطأ النطاق السبب
    100 com.mbridge.msdk عرضت حزمة تطوير البرامج (SDK) من Mintegral ردّ اتصال يشير إلى حدوث خطأ.
    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 خطأ تعذُّر عرض الإعلان.
    105 com.mbridge.msdk تعذّر إعداد حزمة تطوير البرامج (SDK) الخاصة بمنصة Mintegral.
    106 com.google.ads.mediation.mintegral تم تحميل إعلان في خانة 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 الإضافي

    الإصدار 2.2.6

    الإصدار 2.2.5

    الإصدار 2.2.4

    الإصدار 2.2.3

    الإصدار 2.2.2

    الإصدار 2.2.1

    الإصدار 2.2.0

    الإصدار 2.1.0

    الإصدار 2.0.6

    الإصدار 2.0.5

    الإصدار 2.0.4

    الإصدار 2.0.3

    الإصدار 2.0.2

    الإصدار 2.0.1

    الإصدار 2.0.0

    الإصدار 1.9.8

    الإصدار 1.9.7

    الإصدار 1.9.6

    الإصدار 1.9.5

    الإصدار 1.9.4

    الإصدار 1.9.3

    الإصدار 1.9.2

    الإصدار 1.9.1

    الإصدار 1.9.0

    الإصدار 1.8.4

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