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

دمج Pangle مع عروض الأسعار

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

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

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

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

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

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

المتطلبات

المستوى 21 أو إصدار أحدث لواجهة برمجة التطبيقات Android

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

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

شلال

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

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

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

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

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

سجِّل الدخول إلى حسابك على "مدير إعلانات Google".

إضافة Pangle في "الشركات"

عروض الأسعار

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

شلال

انتقِل إلى المشرف > الشركات، ثم انقر على الزر شركة جديدة في علامة التبويب جميع الشركات. اختَر شبكة الإعلانات.

اختَر Pangle كـ شبكة المواقع الإعلانية، وأدخِل اسمًا فريدًا وفعِّل التوسّط.

لست بحاجة إلى إدخال اسم مستخدم أو كلمة مرور. انقر على حفظ عند الانتهاء.

تفعيل ميزة "مشاركة الإشارات الآمنة"

عروض الأسعار

انتقِل إلى المشرف > الإعدادات العامة. انتقِل إلى علامة التبويب إعدادات حساب Ad Exchange راجِع مشاركة الإشارات الآمنة وفعِّلها. انقر على حفظ.

شلال

هذه الخطوة غير مطلوبة لعمليات دمج العرض الإعلاني بدون انقطاع.

ضبط Pangle عروض الأسعار

عروض الأسعار

انتقِل إلى العرض > مقدّمو عروض الأسعار، وانقر على مقدّم عروض أسعار جديد ضمن علامة التبويب عروض الأسعار باستخدام حِزم تطوير البرامج (SDK).

اختَر Pangle كمقدّم عروض الأسعار.

فعِّل الخيارَين إضافة مكتبة إشارات نظام عروض الأسعار هذا إلى قائمة الإشارات المسموح بها والسماح بمشاركة الإشارات مع نظام عروض الأسعار هذا. بعد ذلك، انقر على متابعة.

انقر على متابعة.

انقر على تم.

شلال

هذه الخطوة غير مطلوبة لعمليات دمج العرض الإعلاني بدون انقطاع.

ضبط ربط الوحدات الإعلانية

عروض الأسعار

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

انتقِل إلى علامة التبويب ربط الوحدات الإعلانية وانقر على تعيين وحدة إعلانية جديد.

اختَر وحدة إعلانية محدّدة. اختَر وحدة إعلانية وشكل إعلان، وتطبيق متوافق مع الأجهزة الجوّالة كنوع المستودع، وتطبيقك المتوافق مع الأجهزة الجوّالة. بعد ذلك، أدخِل App ID and Ad Placement ID المُسجَّلة في القسم السابق. أخيرًا، انقر على حفظ.

شلال

انتقِل إلى العرض > مجموعات الأرباح وانقر على الزر مجموعة أرباح جديدة. اختَر تطبيقك المتوافق مع الأجهزة الجوّالة.

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

اختَر الشركة التي أنشأت حسابًا لها Pangle في القسم السابق. اختَر توسّط حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كنوع الدمج، وAndroid كنظام أساسي، ونشط كحالة.

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

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

الدمج اليدوي

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

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

تشويش ProGuard

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

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

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

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