تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

يوضّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من Pangle باستخدام التوسّط، ويشمل ذلك دمج كلّ من العرض الإعلاني بدون انقطاع وعروض الأسعار. ويتناول هذا الدليل كيفية إضافة Pangle إلى إعدادات التوسّط للوحدة الإعلانية وكيفية دمج حزمة تطوير البرامج (SDK) وبرنامج Pangle المتوافق مع Flutter في تطبيق 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.

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

عروض الأسعار

اختَر شكل الإعلان واسم موضع الإعلان، ثم اختَر عروض الأسعار داخل التطبيق كـ نوع التسعير. املأ بقية النموذج وانقر على إرسال.

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

Android

iOS

شلال

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

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

Android

iOS

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

عروض الأسعار

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

شلال

دوِّن رقم تعريف المستخدم في أسفل يمين الصفحة.

انقر على عمليات الدمج > حزمة تطوير البرامج وواجهة برمجة التطبيقات > Pangle Reporting API 2.0. دوِّن رقم تعريف الدور ومفتاح الأمان.

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

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

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

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

Android

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

iOS

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

الخطوة 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: إضافة الرمز المطلوب

Android

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

iOS

دمج SKAdNetwork

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

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

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

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

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

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

رموز الخطأ

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

Android

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

iOS

GADMediationAdapterPangle

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

Android

رمز الخطأ	النطاق	السبب
101	com.google.ads.mediation.pangle	مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف التطبيق أو رقم تعريف موضع الإعلان)
102	com.google.ads.mediation.pangle	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع Pangle.
103	com.google.ads.mediation.pangle	استجابة عرض السعر غير متوفّرة أو غير صالحة
-1-60000	com.pangle.ads	عرَضت حزمة تطوير البرامج (SDK) من Pangle خطأً. اطّلِع على مستندات Pangle للحصول على مزيد من التفاصيل.

iOS

رمز الخطأ	النطاق	السبب
101	com.google.ads.mediation.pangle	مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف التطبيق أو رقم تعريف موضع الإعلان)
102	com.google.ads.mediation.pangle	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع Pangle.
-1-60000	تم إرسالها من خلال حزمة تطوير البرامج (SDK) من Pangle	عرَضت حزمة تطوير البرامج (SDK) من Pangle خطأً. اطّلِع على مستندات 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 على الأجهزة الجوّالة".