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

دمج الزاوية مع عروض الأسعار

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

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

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

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

¹ يكون دمج الشلال في إصدار تجريبي مغلق.

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

المتطلبات

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

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

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

شلال

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

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

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

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

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

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

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

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

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