يوضّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض إعلانات من Pangle باستخدام التوسّط، وتغطية كلّ من العرض الإعلاني بدون انقطاع وعروض الأسعار عروض الأسعار. كما يتناول كيفية إضافة Pangle إلى إعدادات توسّط الوحدة الإعلانية وكيفية دمج حزمة Pangle SDK ومحوّلها في أحد تطبيقات Unity.
عمليات الدمج وأشكال الإعلانات المتوافقة
يتميّز AdMob محوّل التوسّط لـ Pangle بالإمكانات التالية:
| الدمج | |
|---|---|
| عروض الأسعار | |
| شلال | |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| تم منح المكافأة | |
| الإعلانات البينية التي تضم مكافأة | |
المتطلّبات
- أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
- Unity 5.6 أو إصدار أحدث
- للنشر على Android:
- المستوى 21 من واجهة برمجة تطبيقات Android أو أعلى
- للنشر على iOS:
- هدف نشر iOS هو 12.0 أو إصدار أحدث
- مشروع Unity قيد العمل تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: ضبط الإعدادات في واجهة مستخدم Pangle
اشترِك أو سجِّل الدخول إلى حسابك على Pangle.
إضافة تطبيق جديد
انتقل إلى علامة التبويب التطبيقات وانقر على الزر إضافة تطبيق.
اختَر نظام التشغيل الذي تريد إنشاء طلب بشأنه واملأ بقية النموذج. بعد ذلك، انقر على إرسال.
Android
iOS
دوِّن رقم تعريف التطبيق لتطبيقك.
Android
iOS
إنشاء موضع إعلان
بعد إنشاء تطبيقك، انقر على الزر إضافة لإنشاء موضع الإعلان.
Android
iOS
عروض الأسعار
اختر شكل الإعلان واسم موضع الإعلان، ثم اختَر عرض الأسعار داخل التطبيق كنوع التسعير. املأ بقية النموذج وانقر على إرسال.
بعد إنشاء موضع الإعلان، دوِّن رقم تعريف موضع الإعلان.
Android
iOS
شلال
اختر شكل الإعلان واسم موضع الإعلان والتكلفة الألف ظهور العالمية لتكون نوع التسعير. املأ بقية النموذج وانقر على إرسال.
بعد إنشاء موضع الإعلان، دوِّن رقم تعريف موضع الإعلان.
Android
iOS
تحديد موقع مفتاح واجهة برمجة التطبيقات Pangle Reporting API
عروض الأسعار
هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
دوِّن User ID في أسفل يمين الصفحة.
انقر على عمليات الدمج > SDK وواجهة برمجة التطبيقات > Pangle Reporting API 2.0. دوِّن معرّف الدور ومفتاح الأمان.
تفعيل وضع الاختبار
اتّبِع التعليمات الواردة في دليل كيفية إضافة إعلان اختباري من Pangle حول كيفية تفعيل إعلانات Pangle الاختبارية.
الخطوة 2: إعداد طلب Pangle في AdMob واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) والمحوّل من Pangle
نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في Pangle من رابط التنزيل في سجلّ التغييرات واستخرج GoogleMobileAdsPangleMediation.unitypackage من ملف zip.
في محرر مشروع Unity، حدد مواد العرض > استيراد حزمة > حزمة
مخصصة وابحث عن الملف GoogleMobileAdsPangleMediation.unitypackage
الذي قمت بتنزيله. تأكَّد من اختيار جميع الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android >
فرض الحل. ستنفِّذ مكتبة أداة حلّ المشاكل في Unity Play حلّ مشكلة الاعتماد من البداية وستنسخ التبعيات المُعلَنة إلى دليل Assets/Plugins/Android في تطبيق Unity.
الخطوة 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 Unity
الإصدار 2.7.0
- يتوافق مع الإصدار 5.9.0.2.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 5.8.0.8.0 من محوّل iOS من Pangle.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 9.1.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.6.0
- متوافق مع الإصدار 5.8.0.9.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 5.8.0.8.0 من محوّل iOS من Pangle.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 9.0.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.5.0
- يتوافق مع الإصدار 5.7.0.1.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 5.7.0.7.0 من محوّل iOS من Pangle.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.6.0 من المكوّن الإضافي لبرنامج Unity إضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.4.0
- متوافق مع الإصدار 5.5.0.9.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 5.5.0.9.0 من محوّل Pangle لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.6.0 من المكوّن الإضافي لبرنامج Unity إضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.3.0
- متوافق مع الإصدار 5.3.0.6.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 5.3.1.2.0 من محوّل iOS من Pangle.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.4.1 من المكوّن الإضافي لبرنامج Unity إضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.2.0
- متوافق مع الإصدار 5.2.0.6.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 5.2.0.9.0 من محوّل iOS من Pangle.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.3.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.1.0
- يتوافق مع الإصدار 5.1.0.9.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 5.1.1.0.0 من محوّل iOS من Pangle.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.1.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.0.0
- تم نقل محتوى المحوّل إلى
GoogleMobileAds/Mediation/Pangle/. - تمت إعادة ضبط مساحة اسم المحوّل لاستخدام
GoogleMobileAds.Mediation.Pangle. - يتوافق مع الإصدار 5.0.0.7.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 5.0.0.6.0 من محوّل iOS من Pangle.
- تم إنشاء الإصدار 7.4.1 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.4.1.
الإصدار 1.5.1
- يتوافق مع الإصدار 4.9.0.7.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 4.9.0.8.0 من محوّل Pangle لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.4.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.5.0
- يتوافق مع الإصدار 4.9.0.6.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 4.9.0.7.0 من محوّل Pangle لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.3.1 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.4.0
- يتوافق مع الإصدار 4.8.1.0.0 من محوّل Android من Pangle.
- يتوافق مع الإصدار 4.8.1.0.0 من محوّل Pangle لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.3.1 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.3.1
- يتوافق مع الإصدار 4.7.0.6.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 4.7.0.6.0 من محوّل Pangle لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.2.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.3.0
- تمت إعادة تسمية الطرق التالية في الفئة
Pangle:SetGDPR()->SetGDPRConsent()SetCCPA()->SetDoNotSell()
- يتوافق مع الإصدار 4.7.0.5.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 4.7.0.5.0 من محوّل Pangle لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.2.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.2.0
- يتوافق مع الإصدار 4.5.0.6.1 من محوّل Android من Pangle
- يتوافق مع الإصدار 4.5.2.8.0 من محوّل Pangle لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.1.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.1.0
- يتوافق مع الإصدار 4.5.0.3.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 4.5.1.3.0 من محوّل Pangle لنظام التشغيل iOS.
- تم إنشاء الإصدار 7.0.2 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.0.2.
الإصدار 1.0.0
- الإصدار الأولي.
- يتوافق مع الإصدار 4.3.0.8.0 من محوّل Android من Pangle
- يتوافق مع الإصدار 4.3.0.5.0 من محوّل Pangle لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.0.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.