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

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

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

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

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

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

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

المتطلبات

المستوى 21 أو إصدار أحدث لواجهة برمجة التطبيقات Android
[لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم محوِّل Pangle 5.5.0.4.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

دمج "استوديو Android" (إجراء يُنصح به)

في ملف settings.gradle.kts على مستوى المشروع، أضِف موارد الالتقاط التالية:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifact.bytedance.com/repository/pangle/")
    }
  }
}

بعد ذلك، أضِف في ملف build.gradle.kts على مستوى التطبيق الإعدادات وتبعيات التنفيذ التالية. استخدِم أحدث إصدارات حزمة تطوير البرامج (SDK) ومحوِّل Pangle:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:pangle:6.3.0.4.0")
}

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Pangle واسحب open_ad_sdk.aar من مجلد الأرشيف الذي تم تنزيله وأضِفه إلى مشروعك.
انتقِل إلى عناصر محوِّل Pangle في مستودع Maven من Google. اختَر أحدث إصدار، ونزِّل ملف .aar الخاص بمحوِّل Pangle ، وأضِفه إلى مشروعك.

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

تشويش ProGuard

إذا كنت تستخدم ProGuard لإخفاء رمز Android، اتّبِع التعليمات الواردة في مستندات Pangle لضمان عدم إخفاء رمز حزمة SDK من Pangle.

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

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

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

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

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

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

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

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

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

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

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

رموز الخطأ

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

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل 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 للحصول على مزيد من التفاصيل.