يوضّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من Pangle باستخدام التوسّط، ويشمل ذلك دمج الإعلانات الإعلانية بدون انقطاع وعروض الأسعار. ويتناول هذا الدليل كيفية إضافة Pangle إلى إعدادات التوسّط للوحدة الإعلانية وكيفية دمج حزمة تطوير البرامج (SDK) ومحوِّل Pangle في تطبيق Unity.
عمليات الدمج وأشكال الإعلانات المتوافقة
يمتلك محوِّل توسّط AdMob لمنصّة Pangle الإمكانات التالية:
التكامل | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
إعلان بيني يضمّ مكافأة |
المتطلبات
- أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 5.6 من Unity أو إصدار أحدث
- [لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم المكوّن الإضافي لدمج "إعلانات Google على الأجهزة الجوّالة" مع Pangle 2.4.0 أو إصدار أحدث (ننصح باستخدام أحدث إصدار).
- للنشر على Android
- المستوى 21 من واجهة برمجة التطبيقات لنظام التشغيل Android أو إصدار أحدث
- للنشر على أجهزة iOS
- إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
- مشروع Unity صالح تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" يُرجى الاطّلاع على البدء لمعرفة التفاصيل.
- إكمال التوسّط دليل البدء
الخطوة 1: إعداد الإعدادات في واجهة مستخدم Pangle
اشترِك أو سجِّل الدخول إلى حسابك على Pangle.
إضافة تطبيق جديد
انتقِل إلى علامة التبويب التطبيقات وانقر على الزر إضافة تطبيق.
اختَر نظام التشغيل الذي تريد إنشاء تطبيق له واملأ باقي النموذج. بعد ذلك، انقر على إرسال.
دوِّن رقم تعريف التطبيق.
إنشاء موضع إعلان
بعد إنشاء طلبك، انقر على الزر إضافة لإنشاء موضع إعلانك.
اختَر شكل الإعلان واسم موضع الإعلان، ثم اختَر عروض الأسعار داخل التطبيق كـ نوع التسعير. املأ بقية النموذج وانقر على إرسال.
بعد إنشاء موضع الإعلان، دوِّن معرّف موضع الإعلان.
اختَر شكل الإعلان واسم موضع الإعلان والتكلفة المشترَكة لكل ألف ظهور عالميًا كـ نوع التسعير. املأ بقية النموذج وانقر على إرسال.
بعد إنشاء موضع الإعلان، دوِّن معرّف موضع الإعلان.
تحديد موضع مفتاح Pangle Reporting API
هذه الخطوة غير مطلوبة لدمج عروض الأسعار.
دوِّن رقم تعريف المستخدم في أسفل يمين الصفحة.
انقر على عمليات الدمج > حزمة تطوير البرامج وواجهة برمجة التطبيقات > Pangle Reporting API 2.0. سجِّل معرّف الدور ومفتاح الأمان.
تفعيل وضع الاختبار
اتّبِع التعليمات الواردة في دليل Pangle بشأن كيفية إضافة إعلان اختباري للتعرّف على كيفية تفعيل الإعلانات الاختبارية في Pangle.
الخطوة 2: إعداد طلب Pangle في واجهة مستخدم AdMob
ضبط إعدادات التوسّط لوحدتك الإعلانية
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل استخدام iOS.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوِّل Pangle
إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت "مكوّن إضافي لتوسّط Pangle في إعلانات Google للأجهزة الجوّالة" لنظام Unity في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:
openupm add com.google.ads.mobile.mediation.pangle
في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > مدير الحِزم لفتح إعدادات "مدير حِزم Unity".
ضمن علامة التبويب السجلّات على مستوى النطاق، أضِف OpenUPM كسجلّ على مستوى النطاق باستخدام التفاصيل التالية:
- الاسم:
OpenUPM
- عنوان URL:
https://package.openupm.com
- النطاقات:
com.google
بعد ذلك، انتقِل إلى النافذة (Window) > مدير الحِزم (Package Manager) لفتح مدير حِزم Unity (Unity Package Manager) و اختَر السجلّات الخاصة بي (My Registries) من القائمة المنسدلة.
اختَر حزمة Google Mobile Ads Pangle Mediation وانقر على تثبيت.
نزِّل أحدث إصدار من مكوّن "توسّط إعلانات Google للأجهزة الجوّالة" للخدمة
Pangle من رابط التنزيل في
سجلّ التغييرات
واسحب ملف
GoogleMobileAdsPangleMediation.unitypackage
من ملف zip.
في محرِّر مشروع Unity، اختَر مواد العرض > استيراد حزمة >
حزمة مخصّصة وابحث عن
GoogleMobileAdsPangleMediation.unitypackage
الملف الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض > مدير التبعيات الخارجية >
Android Resolver > Force Resolve (حلّ المشاكل بالقوة). ستُجري مكتبة "مدير التبعية الخارجية"
عملية حلّ التبعية من البداية وستنسخ
التبعيات المعلَن عنها إلى الدليل Assets/Plugins/Android
في
تطبيق Unity.
الخطوة 4: إضافة الرمز المطلوب
لا يلزم استخدام رمز إضافي لدمج Pangle.
دمج SKAdNetwork
اتّبِع مستندات Pangle
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist
في مشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم Pangle.
إثبات صحة الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من Pangle، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصدرَي الإعلانات Pangle (عروض الأسعار) وPangle (العرض بدون انقطاع).
رموز الخطأ
إذا تعذّر على المُحوِّل تلقّي إعلان من Pangle، يمكن للناشرين التحقّق من
الخطأ الأساسي من استجابة الإعلان باستخدام
ResponseInfo
ضمن
الفئات التالية:
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
GADMediationAdapterPangle
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل Pangle عند تعذُّر تحميل إعلان:
رمز الخطأ | النطاق | السبب |
---|---|---|
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 للحصول على مزيد من التفاصيل. |
رمز الخطأ | النطاق | السبب |
---|---|---|
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.5.4
- متوافق مع الإصدار 6.4.0.6.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.4.1.1.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤها واختبارها باستخدام الإصدار 9.5.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.5.3
- متوافق مع الإصدار 6.4.0.5.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.4.1.0.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤها واختبارها باستخدام الإصدار 9.5.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.5.2
- متوافق مع الإصدار 6.4.0.4.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.4.0.8.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤها واختبارها باستخدام الإصدار 9.5.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.5.1
- متوافق مع الإصدار 6.4.0.3.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.4.0.7.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤها واختبارها باستخدام الإصدار 9.5.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.5.0
- متوافق مع الإصدار 6.4.0.2.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.4.0.6.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤها واختبارها باستخدام الإصدار 9.5.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.4.2
- متوافق مع الإصدار 6.3.0.4.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.3.1.0.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.4.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.4.1
- متوافق مع الإصدار 6.3.0.4.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.3.0.8.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.3.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.4.0
- متوافق مع الإصدار 6.3.0.2.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.3.0.6.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.3.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.3.3
- متوافق مع الإصدار 6.2.0.7.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.2.0.9.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.2.1 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.3.2
- متوافق مع الإصدار 6.2.0.6.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.2.0.8.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.2.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.3.1
- متوافق مع الإصدار 6.2.0.5.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.2.0.7.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.2.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.3.0
- متوافق مع الإصدار 6.2.0.4.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.2.0.5.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 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 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.2.0
- تمت إعادة تسمية
DummyClient
إلىPlaceholderClient
. - متوافق مع الإصدار 6.1.0.6.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.1.0.5.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.2.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.1.0
- متوافق مع الإصدار 6.0.0.8.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.1.0.5.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.1.1 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.0.1
- متوافق مع الإصدار 6.0.0.5.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.0.0.6.0 من محوِّل Pangle لنظام التشغيل iOS
- تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 4.0.0
- متوافق مع الإصدار 6.0.0.5.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 6.0.0.5.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 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 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 5.9.0.8.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 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 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.6.0
- متوافق مع الإصدار 5.8.0.9.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 5.8.0.8.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 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 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 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 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.1.0
- متوافق مع الإصدار 5.1.0.9.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 5.1.1.0.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 8.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 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 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.5.1
- متوافق مع الإصدار 4.9.0.7.0 من محوِّل Pangle لنظام التشغيل Android
- متوافق مع الإصدار 4.9.0.8.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 7.4.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.5.0
- متوافق مع الإصدار 4.9.0.6.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 4.9.0.7.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 7.3.1 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.4.0
- متوافق مع الإصدار 4.8.1.0.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 4.8.1.0.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 7.3.1 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.3.1
- متوافق مع الإصدار 4.7.0.6.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 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 لنظام التشغيل Android.
- متوافق مع الإصدار 4.7.0.5.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 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 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.1.0
- متوافق مع الإصدار 4.5.0.3.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 4.5.1.3.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 7.0.2 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.0.0
- الإصدار الأولي.
- متوافق مع الإصدار 4.3.0.8.0 من محوِّل Pangle لنظام التشغيل Android.
- متوافق مع الإصدار 4.3.0.5.0 من محوِّل Pangle لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 7.0.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".