يوضّح لك هذا الدليل كيفية استخدام حزمة "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
اشترِك أو سجِّل الدخول إلى حسابك على Pangle.
إضافة تطبيق جديد
انتقِل إلى علامة التبويب التطبيقات وانقر على الزر إضافة تطبيق.
اختَر نظام التشغيل الذي تريد إنشاء تطبيق له واملأ بقية النموذج. بعد ذلك، انقر على إرسال.
Android
iOS
دوِّن رقم تعريف التطبيق.
Android
iOS
إنشاء موضع إعلان
بعد إنشاء طلبك، انقر على الزر إضافة لإنشاء موضع إعلانك.
Android
iOS
عروض الأسعار
اختَر شكل الإعلان واسم موضع الإعلان، ثم اختَر عروض الأسعار داخل التطبيق كـ نوع التسعير. املأ باقي النموذج وانقر على إرسال
بعد إنشاء موضع الإعلان، دوِّن رقم تعريف موضع الإعلان.
Android
iOS
شلال
اختَر شكل الإعلان واسم موضع الإعلان والتكلفة لكل ألف ظهور العالمية باعتبارها نوع التسعير. املأ بقية النموذج وانقر على إرسال.
بعد إنشاء موضع الإعلان، دوِّن معرّف موضع الإعلان.
Android
iOS
تحديد موقع مفتاح واجهة برمجة تطبيقات Pangle Reporting
عروض الأسعار
هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
دوِّن رقم تعريف المستخدم في أسفل يمين الصفحة.
انقر على عمليات الدمج > حزمة تطوير البرامج وواجهة برمجة التطبيقات > Pangle Reporting API 2.0. دوِّن رقم تعريف الدور ومفتاح الأمان.
تفعيل وضع الاختبار
اتّبِع التعليمات الواردة في دليل Pangle بشأن كيفية إضافة إعلان اختباري للتعرّف على كيفية تفعيل الإعلانات الاختبارية في Pangle.
الخطوة 2: إعداد طلب Pangle في AdMob واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوّل Pangle
الدمج من خلال pub.dev
(لأجهزة Android فقط) أضِف المستودعات التالية إلى ملف build.gradle
داخل دليل android
الخاص بمشروعك:
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 (عروض الأسعار) و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 على الأجهزة الجوّالة".