يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض من Pangle باستخدام التوسّط، تغطي كل من العرض الإعلاني بدون انقطاع وعروض الأسعار عمليات دمج يتناول كيفية إضافة Pangle إلى تهيئة التوسط لوحدة إعلانية وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل Pangle في Flutter تطبيق.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمّن AdMob محوّل التوسّط في Pangle الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
إعلان بيني يضم مكافأة |
المتطلبات
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Flutter عامل تم إعداده باستخدام SDK لإعلانات Google على الأجهزة الجوّالة. عرض البدء لمعرفة التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: ضبط الإعدادات في واجهة مستخدم 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/")
}
}
أضف التبعية التالية مع أحدث إصدارات
Pangle حزمة تطوير البرامج (SDK) والمحوّل في حزمتك
ملف 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 (Bidding) and Pangle (Waterfall) مصادر الإعلانات.
رموز الخطأ
وفي حال تعذّر على المحوّل تلقّي إعلان من 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 | تم الإرسال من خلال Pangle SDK | حدث خطأ في حزمة تطوير البرامج (SDK) في Pangle. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات Pangle. |
سجلّ تغييرات مهايئ وساطة Pangle Flutter
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 على الأجهزة الجوّالة.