يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض من Pangle باستخدام التوسّط، تغطي كل من العرض الإعلاني بدون انقطاع وعروض الأسعار عمليات دمج يتناول كيفية إضافة Pangle إلى تهيئة التوسط لوحدة إعلانية وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل Pangle في Unity تطبيق.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمّن AdMob محوّل التوسّط في Pangle الإمكانات التالية:
| الدمج | |
|---|---|
| عروض الأسعار | |
| شلال | |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| تم منح المكافأة | |
| إعلان بيني يضم مكافأة | |
المتطلبات
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- Unity 5.6 أو إصدار أحدث
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع 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 Services
تحليل التبعية من البداية ونسخ التبعيات المعلنة إلى
الدليل 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. |
سجلّ تغييرات المكوّن الإضافي لتوسّط Unity في Pangle
الإصدار التالي
- تمت إعادة تسمية "
DummyClient" إلى "PlaceholderClient".
الإصدار 4.1.0
- يتوافق مع الإصدار 6.0.0.8.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 6.1.0.5.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.0.1
- يتوافق مع الإصدار 6.0.0.5.0 من محوّل Android Pangle.
- يتيح استخدام الإصدار 6.0.0.6.0 من محوّل Pangle في نظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.0.0
- يتوافق مع الإصدار 6.0.0.5.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 6.0.0.5.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.0.0
- يتوافق مع الإصدار 6.0.0.3.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 5.9.0.9.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.8.1
- يتوافق مع الإصدار 5.9.0.6.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 5.9.0.8.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.8.0
- يتوافق مع الإصدار 5.9.0.4.0 من محوّل Pangle.
- يتوافق مع الإصدار 5.9.0.7.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.7.0
- يتوافق مع الإصدار 5.9.0.2.0 من محوّل Pangle.
- يتوافق مع الإصدار 5.8.0.8.0 من محوّل Pangle في نظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.6.0
- يتوافق مع الإصدار 5.8.0.9.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 5.8.0.8.0 من محوّل Pangle في نظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.5.0
- يتوافق مع الإصدار 5.7.0.1.0 من محوّل Pangle.
- يتوافق مع الإصدار 5.7.0.7.0 من محوّل Pangle في نظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.6.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.4.0
- يتوافق مع الإصدار 5.5.0.9.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 5.5.0.9.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.6.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.3.0
- يتوافق مع الإصدار 5.3.0.6.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 5.3.1.2.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.4.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.2.0
- يتوافق مع الإصدار 5.2.0.6.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 5.2.0.9.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.3.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.1.0
- يتوافق مع الإصدار 5.1.0.9.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 5.1.1.0.0 من محوّل 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 من محوّل Pangle في نظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.4.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.5.1
- يتوافق مع الإصدار 4.9.0.7.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 4.9.0.8.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 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 من محوّل Pangle.
- يتوافق مع الإصدار 4.8.1.0.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 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 من محوّل Pangle.
- يتوافق مع الإصدار 4.7.0.5.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 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.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.2 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.0.0
- الإصدار الأولي.
- يتوافق مع الإصدار 4.3.0.8.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 4.3.0.5.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.