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

اختيار النظام الأساسي: Android (إصدار تجريبي) Android iOS Unity Flutter

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

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

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

المتطلبات

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

• [بالنسبة إلى عروض الأسعار]: لدمج جميع أشكال الإعلانات المتاحة في عروض الأسعار، استخدِم محوّل Pangle الإصدار 5.5.0.4.0 أو إصدارًا أعلى (يُنصح بأحدث إصدار)

• أحدث إصدار من GMA Next-Gen SDK

• أكمِل دليل الخطوات الأولى في التوسّط

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

اشترِك في حساب Pangle أو سجِّل الدخول إليه.

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

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

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

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

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

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

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

تعديل ملف app-ads.txt

مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة "للمختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنها مخوّلة. للحيلولة دون حدوث خسارة كبيرة في إيرادات الإعلانات، عليك تنفيذ ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، عليك إعداد ملف app-ads.txt لتطبيقك.

لتنفيذ app-ads.txt لـ Pangle، اطّلِع على مقالة كيفية إضافة Pangle إلى ملف app-ads.txt.

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

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

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

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

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



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



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



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

عرض إعلاني بدون انقطاع

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

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



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

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

إضافة Pangle DSP إلى قائمة شركاء الإعلانات للوائح الخصوصية في الولايات الأمريكية واللائحة العامة لحماية البيانات (GDPR)

اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Pangle DSP إلى قائمة شركاء الإعلانات للوائح التنظيمية الأوروبية واللوائح التنظيمية في الولايات الأمريكية في واجهة مستخدِم AdMob.

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

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

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

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

في ملف gradle على مستوى التطبيق، أضِف تبعيات وعمليات ضبط التنفيذ التالية:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:pangle:7.9.1.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:pangle:7.9.1.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

عملية الدمج اليدوي

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

2. انتقِل إلى عناصر محوّل Pangle على مستودع Maven من Google. اختَر أحدث إصدار، ونزِّل ملف .aar الخاص بمحوّل Pangle، وأضِفه إلى مشروعك.

الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة Pangle SDK

للامتثال لسياسة موافقة المستخدم في الاتحاد الأوروبي المُتبعة في Google، يجب الإفصاح عن معلومات محدّدة للمستخدمين داخل المنطقة الاقتصادية الأوروبية والمملكة المتحدة وسويسرا والحصول على موافقتهم على استخدام ملفات تعريف الارتباط أو غير ذلك من البيانات المحفوظة على أجهزتهم المحلية وفقًا للمتطلبات القانونية، وكذلك موافقتهم على جمع البيانات الشخصية ومشاركتها واستخدامها في تخصيص الإعلانات. تعكس هذه السياسة شروط "التوجيه الأوروبّي بشأن الخصوصية الإلكترونية" و"اللائحة العامّة لحماية البيانات" (GDPR) في الاتّحاد الأوروبّي. أنت مسؤول عن التأكّد من نقل الموافقة إلى كل مصدر إعلان في سلسلة التوسّط. لا يمكن لشركة Google نقل خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.

اعتبارًا من الإصدار 7.9.0.9 من حزمة Pangle SDK، تقرأ Pangle تلقائيًا الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) التي تضبطها منصات إدارة الموافقة التي تتيح مواصفات "الموافقة الإضافية" من Google، بما في ذلك حزمة UMP SDK.

قوانين الخصوصية في الولايات الأمريكية

تتطلب قوانين الخصوصية في الولايات الأمريكية منح المستخدمين حق إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين) ، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن لا يمكن لشركة Google تطبيق هذا الإعداد على كل شبكة إعلانات في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية واتّباع إرشادات كل شبكة من هذه الشبكات لضمان الامتثال.

يوفّر محوّل Pangle الطريقة PangleMediationAdapter.setPAConsent() التي تعيد توجيه معلومات الموافقة إلى محوّل Pangle، ثم إلى حزمة Pangle SDK. يوضّح نموذج الرمز البرمجي التالي كيفية تمرير معلومات الموافقة إلى حزمة Pangle SDK. اضبط معلومات الموافقة قبل التهيئة GMA Next-Gen SDK لضمان إعادة توجيهها بشكلٍ صحيح إلى حزمة Pangle SDK.

import com.google.ads.mediation.pangle.PangleMediationAdapter;
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT);

import com.google.ads.mediation.pangle.PangleMediationAdapter
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT)

لمزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة، اطّلِع على دليل دمج Android من Pangle.

الخطوة 5: إضافة الرمز البرمجي المطلوب

تشويش ProGuard

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

الخطوة 6: اختبار عملية الإعداد

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

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

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

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

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

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

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

يعرض محوّل Pangle إعلاناته المدمجة مع المحتوى كعناصر NativeAd. ويملأ الحقول التالية لـ NativeAd.

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

رموز الخطأ

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

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

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