تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

تتوفر لبرنامج التوسّط في Pangle الإمكانات التالية:

التكامل
عروض الأسعار
شلال
التنسيقات
إعلان على شاشة فتح التطبيق	¹
بانر
إعلان بيني
تم منح المكافأة
إعلان بيني يضمّ مكافأة
مدمجة مع المحتوى

¹ دمج عروض الأسعار في هذا التنسيق متوفّر في إصدار تجريبي مفتوح.

المتطلبات

إصدار 10.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
[لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم محوِّل Pangle 5.4.1.1.0 أو إصدار أحدث (ننصح باستخدام أحدث إصدار).

أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
إكمال التوسّط دليل البدء

الخطوة 1: إعداد الإعدادات في واجهة مستخدم Pangle

اشترِك أو سجِّل الدخول إلى حسابك على Pangle.

إضافة تطبيق جديد

انتقِل إلى علامة التبويب التطبيقات وانقر على الزر إضافة تطبيق.

اختَر نظام التشغيل الذي تريد إنشاء تطبيق له واملأ باقي النموذج. بعد ذلك، انقر على إرسال.

دوِّن رقم تعريف التطبيق.

إنشاء موضع إعلان

بعد إنشاء طلبك، انقر على الزر إضافة لإنشاء موضع إعلانك.

عروض الأسعار

اختَر شكل الإعلان واسم موضع الإعلان، ثم اختَر عروض الأسعار داخل التطبيق كـ نوع التسعير. املأ بقية النموذج وانقر على إرسال.

بعد إنشاء موضع إعلانك، دوِّن معرّف موضع الإعلان.

شلال

اختَر شكل الإعلان واسم موضع الإعلان والتكلفة المشترَكة لكل ألف ظهور عالميًا كـ نوع التسعير. املأ بقية النموذج وانقر على إرسال.

بعد إنشاء موضع إعلانك، دوِّن معرّف موضع الإعلان.

تحديد موضع مفتاح Pangle Reporting API

عروض الأسعار

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

شلال

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

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

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

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

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

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

عليك إضافة Pangle إلى إعدادات التوسّط لوحدتك الإعلانية.

أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، وانتقِل إلى إضافة Pangle كمصدر إعلان.

لإنشاء مجموعة توسّط جديدة، اختَر إنشاء مجموعة توسّط.

أدخِل تنسيق الإعلان والمنصّة، ثم انقر على متابعة.

أدخِل اسمًا لمجموعة التوسّط، واختَر المواقع الجغرافية التي تريد استهدافها. بعد ذلك، اضبط حالة مجموعة التوسّط على مفعّلة، ثمّ انقر على إضافة وحدات إعلانية.

اربط مجموعة التوسّط هذه بوحدة إعلانية واحدة أو أكثر من وحدات AdMob الإعلانية الحالية. بعد ذلك، انقر على تم.

من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:

إضافة Pangle كمصدر إعلان

عروض الأسعار

ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، اختَر Pangle .
انقر على كيفية التوقيع على اتفاقية شراكة وإعداد شراكة مستندة إلى عروض الأسعار مع Pangle.

انقر على الإقرار والموافقة، ثم انقر على متابعة.

إذا كان لديك تعيين لـ Pangle، يمكنك اختياره. بخلاف ذلك، انقر على إضافة تعيين.

بعد ذلك، أدخِل رقم تعريف التطبيق ورقم تعريف موضع الإعلان الذي حصلت عليه في القسم السابق. بعد ذلك، انقر على تم.

شلال

ضمن بطاقة العرض بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، اختَر Pangle.

اختَر Pangle. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور للخدمة Pangle وانقر على متابعة.

إذا كان لديك تعيين ل Pangle، يمكنك اختياره. بخلاف ذلك، انقر على إضافة تعيين.

بعد ذلك، أدخِل رقم تعريف التطبيق ورقم تعريف موضع الإعلان اللذين حصلت عليهما في القسم السابق. بعد ذلك، انقر على تم.

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

استخدام CocoaPods (إجراء يُنصح به)

أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:
```
pod 'GoogleMobileAdsMediationPangle'
```
من سطر الأوامر، شغِّل:
```
pod install --repo-update
```

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) لمنصة Pangle لنظام التشغيل iOS وصِّل جميع ملفات وحزمات .framework في مشروعك.
نزِّل أحدث إصدار من محوِّل Pangle من رابط التنزيل في سجلّ التغييرات والرابط PangleAdapter.xcframework في مشروعك.

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

دمج SKAdNetwork

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

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

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

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

إثبات صحة الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من Pangle، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصدرَي الإعلانات Pangle (عروض الأسعار) وPangle (العرض بدون انقطاع).

الخطوات الاختيارية

إعلانات مدمجة مع المحتوى

عرض الإعلانات

يعرض محوِّل Pangle إعلاناته المدمجة مع المحتوى على شكل عناصر GADNativeAd . وتعبئ الحقول لملف GADNativeAd.

الحقل	مواد العرض التي يتم تضمينها دائمًا من خلال محوِّل Pangle
العنوان
صورة	1
الجسم
الرمز
الحث على اتخاذ إجراء
التقييم النجمي
المتجر
السعر
المعلِن

¹ لا يقدّم محوِّل Pangle إمكانية الوصول المباشر إلى مادة عرض الصورة الرئيسية للإعلانات المدمجة مع المحتوى. بدلاً من ذلك، يملؤه المحوِّل بالرمز GADMediaView في حال توفّر فيديو أو صورة.

رموز الخطأ

إذا تعذّر على المُحوِّل تلقّي إعلان من Pangle، يمكنك التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام GADResponseInfo.adNetworkInfoArray ضمن الفئات التالية:

GADMediationAdapterPangle

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل Pangle عند تعذُّر تحميل أحد الإعلانات:

رمز الخطأ	النطاق	السبب
101	com.google.ads.mediation.pangle	مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف التطبيق أو رقم تعريف موضع الإعلان)
102	com.google.ads.mediation.pangle	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع Pangle.
-1-60000	تم إرسالها من خلال حزمة تطوير البرامج (SDK) من Pangle	ظهرت رسالة خطأ في حزمة تطوير البرامج (SDK) من Pangle. اطّلِع على مستندات Pangle للحصول على مزيد من التفاصيل.