دمج 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
    • هدف نشر iOS‏ 13.0 أو إصدار أحدث
  • مشروع Flutter يعمل بشكل صحيح تم إعداده باستخدام Google Mobile Ads Flutter Plugin. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads Flutter Plugin.
  • إعداد التوسّط

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

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

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

    انتقِل إلى علامة التبويب إعدادات التطبيق (APP Setting)، ثمّ دوِّن مفتاح التطبيق (APP Key).

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

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

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

    Android

    iOS

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

    Android

    iOS

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

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

    Android

    iOS

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

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

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

    Android

    iOS

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

    Android

    iOS

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

    عروض الأسعار

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

    شلال

    ستحتاج إلى مفتاح Reporting API في Mintegral لإعداد رقم تعريف الوحدة الإعلانية في "إدارة الإعلانات". انتقِل إلى الحساب > أدوات واجهة برمجة التطبيقات. دوِّن 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

    الدمج من خلال 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.5

    الدمج اليدوي

    نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط "إعلانات 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) لنظامَي التشغيل 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.

    سجلّ التغييرات في محوّل التوسّط في 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