دمج ميزة Pangle مع ميزة التوسّط

يوضّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات من Pangle وعرضها باستخدام التوسّط، ويتناول كلّ من عروض الأسعار وعروض الأسعار بدون انقطاع. ويتناول هذا الدليل كيفية إضافة Pangle إلى إعدادات التوسّط للوحدة الإعلانية وكيفية دمج حزمة تطوير البرامج (SDK) ومحوِّل Pangle في Unity تطبيق.

عمليات الدمج وأشكال الإعلانات المتوافقة

يتضمّن Ad Manager محوِّل التوسّط في Pangle الإمكانات التالية:

التكامل
عروض الأسعار
شلال	^1
التنسيقات
بانر
إعلان بيني
تم منح المكافأة
إعلان بيني يضم مكافأة

¹ يتوفّر دمج العرض الإعلاني بدون انقطاع في مرحلة اختبار مغلق.

المتطلبات

• أحدث حزمة تطوير برامج (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

عروض الأسعار

هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.

شلال

دوِّن رقم تعريف المستخدم في أسفل يمين الصفحة.

انقر على عمليات الدمج > حزمة تطوير البرامج وواجهة برمجة التطبيقات > Pangle Reporting API 2.0. دوِّن رقم تعريف الدور ومفتاح الأمان.

تفعيل وضع الاختبار

اتّبِع التعليمات الواردة في دليل Pangle بشأن كيفية إضافة إعلان اختباري للتعرّف على كيفية تفعيل الإعلانات الاختبارية في Pangle.

الخطوة 2: إعداد طلب Pangle في Ad Manager واجهة المستخدم

ضبط إعدادات التوسّط لوحدتك الإعلانية

Android

للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوِّل Pangle

ملاحظة: قد يؤدي عدم دمج الإصدارات المتوافقة من Pangle و"SDK لإعلانات Google على الأجهزة الجوّالة" إلى حدوث مشاكل في الإصدار.

OpenUPM-CLI

ملاحظة مهمة: في حال كنت بصدد نقل البيانات من استخدام .unitypackage إلى استخدام OpenUPM-CLI، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم من خلال حذف جميع الملفات من المجلد Assets/GoogleMobileAds/Mediation/Pangle.

في حال تثبيت OpenUPM-CLI، يمكنك تثبيت المكوّن الإضافي لبرنامج Unity من إعلانات Google للأجهزة الجوّالة من Google على مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذري لمشروعك:

openupm add com.google.ads.mobile.mediation.pangle

OpenUPM

ملاحظة مهمة: في حال نقل البيانات من استخدام .unitypackage إلى استخدام OpenUPM، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم من خلال حذف جميع الملفات من المجلد Assets/GoogleMobileAds/Mediation/Pangle.

في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > مدير الحِزم لفتح إعدادات مدير حِزم Unity.

ضمن علامة التبويب السجلّات على مستوى النطاق، أضِف OpenUPM كسجلّ على مستوى النطاق باستخدام التفاصيل التالية:

• الاسم: OpenUPM
• عنوان URL: https://package.openupm.com
• النطاقات: com.google

بعد ذلك، انتقِل إلى النافذة > مدير الحِزم لفتح مدير حِزم Unity و اختَر السجلّات الخاصة بي من القائمة المنسدلة.

اختَر حزمة Google Mobile Ads Pangle Mediation وانقر على تثبيت.

حزمة Unity

نزِّل أحدث إصدار من مكوّن "توسّط إعلانات Google للأجهزة الجوّالة" للخدمة Pangle من رابط التنزيل في سجلّ التغييرات واسحب ملف GoogleMobileAdsPangleMediation.unitypackage من ملف zip .

في محرِّر مشروعات Unity، انقر على Assets (مواد العرض) > Import Package (استيراد حزمة) > Custom Package (الحزمة المخصّصة) وابحث عن ملف GoogleMobileAdsPangleMediation.unitypackage الذي نزَّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

بعد ذلك، اختَر مواد العرض > مدير التبعيات الخارجية > Android Resolver > Force Resolve (حلّ المشاكل بالقوة). ستنفذ مكتبة مدير التبعية الخارجية حل التبعية من البداية وتنسخ التبعيات المُعلنة إلى دليل Assets/Plugins/Android في تطبيق Unity.

الخطوة 4: إضافة الرمز المطلوب

Android

ما مِن رمز إضافي مطلوب لدمج Pangle.

iOS

دمج SKAdNetwork

اتّبِع مستندات Pangle لإضافة معرّفات SKAdNetwork إلى ملف Info.plist في مشروعك.

الخطوة 5: اختبار عملية التنفيذ

تفعيل الإعلانات الاختبارية

تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم Pangle.

ملاحظة مهمة: أوقِف وضع الاختبار في 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	تم الإرسال من خلال Pangle SDK	ظهرت رسالة خطأ في حزمة تطوير البرامج (SDK) من Pangle. اطّلِع على مستندات Pangle للحصول على مزيد من التفاصيل.

سجلّ التغييرات في مكوّن Pangle Unity Mediation Plugin

الإصدار 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 من محوّل Android Pangle.
• متوافق مع الإصدار 6.2.0.9.0 من محوِّل Pangle لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 9.2.1 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".

الإصدار 4.3.2

• يتوافق مع الإصدار 6.2.0.6.0 من محوّل Android Pangle.
• متوافق مع الإصدار 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.
• متوافق مع الإصدار 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 من مكوّن 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 من محوِّل 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 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 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 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".

الإصدار 2.5.0

• متوافق مع الإصدار 5.7.0.1.0 من محوِّل Pangle لنظام التشغيل Android.
• متوافق مع الإصدار 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 لنظام التشغيل 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 من محوِّل Pangle لنظام التشغيل Android.
• متوافق مع الإصدار 5.1.1.0.0 من محوِّل Pangle لنظام التشغيل iOS.
• تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 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 من محوِّل Pangle لنظام التشغيل Android.
• متوافق مع الإصدار 4.9.0.8.0 من محوِّل Pangle لنظام التشغيل iOS.
• تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.4.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.5.0

• متوافق مع الإصدار 4.9.0.6.0 من محوِّل Pangle لنظام التشغيل Android.
• يتوافق مع الإصدار 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 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".

الإصدار 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 لنظام التشغيل Android.
• يتوافق مع الإصدار 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 من "مكوّن إعلانات 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 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.