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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Android

    iOS

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

    Android

    iOS

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

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

    Android

    iOS

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

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

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

    Android

    iOS

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

    Android

    iOS

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

    عروض الأسعار

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

    شلال

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

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

    مبادرة البائعون المعتمَدون للتطبيقات app-ads.txt هي مبادرة يقدّمها مختبر IAB التقني للمساعدة في ضمان عدم بيع مساحات إعلانية متاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف 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

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

    (على Android فقط) أضِف المستودعات التالية إلى ملف build.gradle داخل دليل android الخاص بمشروعك:

      repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
      }
  }

    أضِف الاعتمادية التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) ومحوّل Mintegral في ملف pubspec.yaml الخاص بالحزمة:

    dependencies:
  gma_mediation_mintegral: ^2.1.4

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

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

    dependencies:
  gma_mediation_mintegral:
    path: path/to/local/package

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

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

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

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

    سجلّ التغييرات في محوّل التوسّط في Flutter من Mintegral

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

    الإصدار 2.1.4

    الإصدار 2.1.3

    الإصدار 2.1.2

    الإصدار 2.1.1

    الإصدار 2.1.0

    الإصدار 2.0.3

    الإصدار 2.0.2

    الإصدار 2.0.1

    الإصدار 2.0.0

    الإصدار 1.2.6

    الإصدار 1.2.5

    الإصدار 1.2.4

    الإصدار 1.2.3

    الإصدار 1.2.2

    الإصدار 1.2.1

    الإصدار 1.2.0

    الإصدار 1.1.0

    الإصدار 1.0.0