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

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

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

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

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

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

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

المتطلبات

المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

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

شلال

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

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

تحديد موقع مفتاح واجهة برمجة التطبيقات Pangle Reporting API

عروض الأسعار

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

شلال

دوِّن User ID في أسفل يمين الصفحة.

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

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

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

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

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

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

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

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

بعد ذلك، أدخِل App ID and Ad Placement ID التي تم الحصول عليها في القسم السابق. بعد ذلك، انقر على تمّ.

ملاحظة مهمة: يجب App ID ربط التطبيق المستهدَف بالتطبيق، كما هو الحال في Pangle واجهة المستخدم.

شلال

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

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

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

بعد ذلك، أدخِل App ID and Ad Placement ID التي تم الحصول عليها في القسم السابق. بعد ذلك، انقر على تمّ.

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

الدمج مع "استوديو Android" (يُنصح به)

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

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

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

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

الدمج اليدوي

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

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

التشويش في ProGuard

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

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

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

احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم Pangle .

التحقّق من الإعلانات الاختبارية

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

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

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

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

يعرض محوّل 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.