دمج ميزة Pangle مع ميزة التوسّط

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

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

يتضمّن AdMob محوِّل التوسّط في Pangle الإمكانات التالية:

المتطلبات

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

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

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

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

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

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

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

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

بعد إنشاء طلبك، انقر على الزر إضافة لإنشاء موضع إعلانك.

تحديد موضع مفتاح Pangle Reporting API

تفعيل وضع الاختبار

اتّبِع التعليمات الواردة في دليل Pangle بشأن كيفية إضافة إعلان اختباري للتعرّف على كيفية تفعيل الإعلانات الاختبارية في Pangle.

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

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

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

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

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

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifact.bytedance.com/repository/pangle/")
      }
  }

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

dependencies:
  gma_mediation_pangle: ^1.0.0

الدمج اليدوي

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

dependencies:
  gma_mediation_pangle:
    path: path/to/local/package

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

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

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

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

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

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

رموز الخطأ

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

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

GADMediationAdapterPangle

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

سجلّ التغييرات في محوِّل التوسّط Pangle Flutter

النسخة التالية

• تم إنشاؤه واختباره باستخدام الإصدار 5.2.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".

2.0.0

• تم التحقّق من التوافق مع الإصدار 6.1.0.9.0 من محوِّل Pangle لنظام التشغيل Android.
• تم التحقّق من التوافق مع الإصدار 6.2.0.5.0 من محوِّل Pangle لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 5.1.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".

1.1.0

• تم التحقّق من التوافق مع الإصدار 5.9.0.4.0 من محوِّل Pangle لنظام التشغيل Android.
• تم التحقّق من التوافق مع الإصدار 5.9.0.7.0 من محوِّل Pangle لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 5.1.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".

1.0.0

• الإصدار الأولي
• التوافق مع الإصدار 5.8.0.9.0 من محوِّل Pangle لنظام التشغيل Android
• تم التحقّق من التوافق مع الإصدار 5.8.0.8.0 من محوِّل Pangle لنظام التشغيل iOS
• تم إنشاؤه واختباره باستخدام الإصدار 5.0.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".