يوضّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات من Pangle وعرضها باستخدام التوسّط، ويتناول كلّ من عروض الأسعار وعروض الأسعار بدون انقطاع. وتتناول هذه المقالة كيفية إضافة Pangle إلى إعدادات توسّط الوحدة الإعلانية وكيفية دمج حزمة تطوير البرامج (SDK) وأداة Pangle في أحد التطبيقات Unity .
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمّن Ad Manager محوِّل التوسّط في Pangle الإمكانات التالية:
| التكامل | |
|---|---|
| عروض الأسعار | |
| شلال | 1 |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| تم منح المكافأة | |
| إعلان بيني يضمّ مكافأة | |
المتطلبات
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- الإصدار 5.6 من Unity أو إصدار أحدث
- للنشر على 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
عروض الأسعار
هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
دوِّن رقم تعريف المستخدم في أسفل يمين الصفحة.
انقر على عمليات الدمج > SDK وواجهة برمجة التطبيقات > Pangle Reporting API 2.0. دوِّن معرّف الدور ومفتاح الأمان.
تفعيل وضع الاختبار
اتّبِع التعليمات الواردة في دليل كيفية إضافة إعلان اختباري من Pangle حول طريقة تفعيل الإعلانات الاختبارية من Pangle.
الخطوة 2: إعداد طلب Pangle في Ad Manager واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوّل Pangle
OpenUPM-CLI
إذا كان لديك OpenUPM-CLI مثبّتًا، يمكنك تثبيت Google Mobile Ads Pangle Mediation Plugin لـ Unity في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:
openupm add com.google.ads.mobile.mediation.pangle
OpenUPM
في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > مدير الحِزم لفتح إعدادات مدير حزم Unity.
ضمن علامة التبويب السجلّات على مستوى النطاق، أضِف OpenUPM كسجلّ على مستوى النطاق باستخدام التفاصيل التالية:
- الاسم:
OpenUPM - عنوان URL:
https://package.openupm.com - النطاقات:
com.google
بعد ذلك، انتقِل إلى النافذة > مدير الحِزم لفتح مدير حِزم Unity و اختَر السجلّات الخاصة بي من القائمة المنسدلة.
اختَر حزمة Google Mobile Ads Pangle Mediation وانقر على تثبيت.
حزمة الانسجام
نزِّل أحدث إصدار من مكوّن "توسّط إعلانات Google للأجهزة الجوّالة" للخدمة
Pangle من رابط التنزيل في
سجلّ التغييرات
واسحب ملف
GoogleMobileAdsPangleMediation.unitypackage من ملف zip
.
في محرِّر مشروع Unity، اختَر مواد العرض > استيراد حزمة >
حزمة مخصّصة وابحث عن
GoogleMobileAdsPangleMediation.unitypackage
الملف الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض > مدير التبعيات الخارجية >
Android Resolver > Force Resolve (حلّ المشاكل بالقوة). ستنفِّذ مكتبة "مدير التبعية الخارجية"
عملية حلّ التبعية من البداية وستنسخ
التبعيات المعلَن عنها إلى الدليل Assets/Plugins/Android في
تطبيق Unity.
الخطوة 4: إضافة الرمز المطلوب
Android
لا يلزم استخدام رمز إضافي لدمج Pangle.
iOS
دمج SKAdNetwork
اتّبِع مستندات Pangle
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل Ad Manager وتفعيل وضع الاختبار في واجهة المستخدم 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 | تم إرسالها من خلال حزمة تطوير البرامج (SDK) من Pangle | ظهرت رسالة خطأ في حزمة تطوير البرامج (SDK) من Pangle. اطّلِع على مستندات Pangle للحصول على مزيد من التفاصيل. |
سجلّ التغييرات في مكوّن Pangle Unity Mediation Plugin
الإصدار 4.3.3
- متوافق مع الإصدار 6.2.0.7.0 من محوِّل Pangle لنظام التشغيل Android.
- يتوافق مع الإصدار 6.2.0.9.0 من محوّل Pangle في نظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.2.1 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.3.2
- يتوافق مع الإصدار 6.2.0.6.0 من محوّل Android Pangle.
- يتوافق مع الإصدار 6.2.0.8.0 من محوّل Pangle في نظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.2.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.3.1
- يتوافق مع الإصدار 6.2.0.5.0 من محوّل Pangle.
- متوافق مع الإصدار 6.2.0.7.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.2.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.3.0
- يتوافق مع الإصدار 6.2.0.4.0 من محوّل Pangle.
- يتوافق مع الإصدار 6.2.0.5.0 من محوّل Pangle.
- تم إنشاؤه واختباره باستخدام الإصدار 9.2.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.2.1
- متوافق مع الإصدار 6.1.0.7.0 من محوِّل Pangle لنظام التشغيل Android.
- يتوافق مع الإصدار 6.1.0.6.0 من محوّل Pangle في نظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.2.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.2.0
- تمت إعادة تسمية
DummyClientإلىPlaceholderClient. - متوافق مع الإصدار 6.1.0.6.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.1.0.5.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.2.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 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 من محوِّل Pangle لنظام التشغيل Android.
- يتوافق مع الإصدار 6.0.0.6.0 من محوّل Pangle في نظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.0.0
- متوافق مع الإصدار 6.0.0.5.0 من محوِّل Pangle لنظام التشغيل Android.
- يتوافق مع الإصدار 6.0.0.5.0 من محوّل Pangle.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.0.0
- متوافق مع الإصدار 6.0.0.3.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 5.9.0.9.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.8.1
- يتوافق مع الإصدار 5.9.0.6.0 من محوّل Android Pangle.
- متوافق مع الإصدار 5.9.0.8.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.8.0
- متوافق مع الإصدار 5.9.0.4.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 5.9.0.7.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.7.0
- متوافق مع الإصدار 5.9.0.2.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 5.8.0.8.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.6.0
- متوافق مع الإصدار 5.8.0.9.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 5.8.0.8.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.5.0
- متوافق مع الإصدار 5.7.0.1.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 5.7.0.7.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 8.6.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.4.0
- يتوافق مع الإصدار 5.5.0.9.0 من محوّل Android Pangle.
- متوافق مع الإصدار 5.5.0.9.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 8.6.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.3.0
- متوافق مع الإصدار 5.3.0.6.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 5.3.1.2.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 8.4.1 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.2.0
- متوافق مع الإصدار 5.2.0.6.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 5.2.0.9.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 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 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 5.0.0.6.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.4.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.5.1
- متوافق مع الإصدار 4.9.0.7.0 من محوِّل Pangle لنظام التشغيل Android.
- يتوافق مع الإصدار 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 لنظام التشغيل 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 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.3.0
- تمت إعادة تسمية الطرق التالية في فئة
Pangle:SetGDPR()->SetGDPRConsent()SetCCPA()->SetDoNotSell()
- يتوافق مع الإصدار 4.7.0.5.0 من محوّل Pangle.
- يتوافق مع الإصدار 4.7.0.5.0 من محوّل Pangle.
- تم إنشاؤه واختباره باستخدام الإصدار 7.2.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.2.0
- متوافق مع الإصدار 4.5.0.6.1 من محوِّل Pangle لنظام التشغيل Android.
- يتوافق مع الإصدار 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 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 4.3.0.5.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.