دمج PubMatic مع "توسّط AdMob"

اختيار النظام الأساسي: Android iOS Unity Flutter React Native Android (قديم)

يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads SDK for React Native لتحميل الإعلانات وعرضها من PubMatic باستخدام توسّط AdMob، مع تغطية عمليات دمج عروض الأسعار. توضّح هذه الصفحة كيفية إضافة PubMatic إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل PubMatic في تطبيق React Native.

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

يوفّر محوّل توسّط AdMob لـ PubMatic الإمكانات التالية:

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

^‫1 يتوفّر هذا الشكل الإعلاني في إصدار تجريبي. يُرجى التواصل مع مدير حسابك لطلب الوصول.

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

• أحدث إصدار من Google Mobile Ads SDK for React Native
• الإصدار 0.85.0 أو إصدار أحدث من إطار عمل React Native
• للنشر على أجهزة Android
  • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
• للنشر على أجهزة iOS
  • أن يكون هدف نشر iOS هو الإصدار 13.0 أو إصدار أحدث
• مشروع React Native يعمل بشكل صحيح وتم ضبطه باستخدام Google Mobile Ads SDK for React Native يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads SDK for React Native لمزيد من التفاصيل.
  • تأكَّد من تنزيل مجلد adapters واستخراجه من مجلد gma-sdk-react-native. إذا لم يكن لديك مجلد adapters، اتّبِع الخطوات الأولى والثانية والثالثة في تثبيت Google Mobile Ads SDK for React Native.
• إعداد ميزة "توسّط AdMob"

الخطوة 1: ضبط الإعدادات في واجهة مستخدم حزمة SDK الخاصة بمنصة PubMatic OpenWrap

اشترِك أو سجِّل الدخول إلى حسابك على PubMatic واختَر بطاقة حزمة SDK الخاصة بمنصة OpenWrap.

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

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

اختَر النظام الأساسي، بالإضافة إلى عنوان URL لمتجر التطبيقات واسم التطبيق.

Android

ضمن مسار الدمج، اختَر React Native واختَر AdMob - SDK Bidding كـ مسار الدمج الفرعي. بعد ذلك، انقر على الزر إضافة تطبيق.

iOS

ضمن مسار الدمج، اختَر React Native واختَر AdMob - SDK Bidding كـ مسار الدمج الفرعي. بعد ذلك، انقر على الزر إضافة تطبيق.

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

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

قبل الانتهاء من تطبيقك، ستظهر لك الإدخالات المناسبة لإضافتها إلى app-ads.txt.

لمزيد من المعلومات حول كيفية تنفيذ app-ads.txt في PubMatic، يُرجى الاطّلاع على كيفية تنفيذ ملف app-ads.txt.

معرِّف الملف الشخصي

بعد إنشاء تطبيقك، انتقِل إلى علامة التبويب التطبيقات واطّلِع على رقم تعريف الملف الشخصي لتطبيقك الذي تم إنشاؤه حديثًا.

إنشاء وحدة إعلانية

ضمن علامة التبويب الوحدات الإعلانية، اختَر التطبيق الذي أنشأته في القسم السابق وانقر على الزر إنشاء وحدة إعلانية.

املأ النموذج بتفاصيل وحدتك الإعلانية وانقر على حفظ.

دوِّن معرّف الوحدة الإعلانية في OpenWrap الذي تم إنشاؤه حديثًا.

الحصول على الرقم التعريفي للناشر

انتقِلوا إلى لوحة بيانات الإحصاءات. مرِّر مؤشر الماوس فوق رمز الملف الشخصي وسجِّل رقم التعريف.

الخطوة 2: إعداد طلب حزمة SDK الخاصة بمنصة PubMatic OpenWrap في واجهة مستخدم AdMob

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

Android

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

إضافة PubMatic إلى قائمة الشركاء الإعلانيين في "اللائحة العامة لحماية البيانات" (GDPR) واللوائح التنظيمية في الولايات الأمريكية

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

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

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) والمحوِّل الخاصَين بمنصة PubMatic OpenWrap

ملاحظة: قد يؤدي عدم دمج إصدارات PubMatic وGoogle Mobile Ads SDK for React Native المتوافقة إلى حدوث مشاكل في الإصدار.

في الدليل الجذري لمشروعك، ثبِّت Google Mobile Ads SDK for React Native محوِّل التوسّط لحزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap. يُرجى إكمال الخطوات التالية:

1. انسخ ملف tar الخاص بمحوّل Google Mobile Ads SDK for React Native من دليل gma-sdk-react-native/adapters/pubmatic/ إلى دليل local_packages/ في مشروعك. إذا لم يكن لديك المجلد adapters، يُرجى الاطّلاع على المتطلبات الأساسية.

   mkdir -p local_packages
   cp EXTRACT_DIR/gma-sdk-react-native/adapters/pubmatic/gma-mediation-pubmatic-0.1.0.tgz local_packages/
   

   استبدِل EXTRACT_DIR بالمسار إلى الدليل الذي استخرجت الأرشيف فيه.

2. ثبِّت حزمة المحوّل باستخدام أداة إدارة الحِزم المفضّلة لديك:

   npm

   npm install ./local_packages/gma-mediation-pubmatic-0.1.0.tgz
   

   خيط غزل

   yarn add ./local_packages/gma-mediation-pubmatic-0.1.0.tgz
   

3. إذا كنت تنشئ تطبيقًا لنظام التشغيل Android، أضِف المستودع التالي إلى ملف build.gradle في دليل android الخاص بمشروعك:

   repositories {
       google()
       mavenCentral()
       maven {
           url = uri("https://repo.pubmatic.com/artifactory/public-repos")
       }
   }
   

الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامة لحماية البيانات"

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

يتيح الإصدار 0.1.0 والإصدارات الأحدث من محوّل PubMatic OpenWrap SDK React Native تمرير إشارات الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) من منصات إدارة الموافقة التي تتكامل مع "إطار الشفافية والموافقة" (TCF) الصادر عن مكتب IAB إلى حزمة PubMatic OpenWrap SDK. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة تمرير معلّمتَي GDPR وGDPR consent.

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

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

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

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

Android

لا حاجة إلى استخدام رمز إضافي لدمج PubMatic.

iOS

تكامل SKAdNetwork

اتّبِع مستندات حزمة تطوير البرامج (SDK) PubMatic OpenWrap لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

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

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

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

ملاحظة مهمة: عليك إيقاف وضع الاختبار في AdMob وPubMatic OpenWrap SDK قبل إصدار تطبيقك.

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

للتأكّد من تلقّي إعلانات اختبارية من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap، يُرجى تفعيل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر إعلانات PubMatic OpenWrap.

رموز الخطأ

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

Android

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

iOS

GADMediationAdapterPubMatic

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

Android

رمز الخطأ	النطاق	السبب
101	com.google.ads.mediation.pubmatic	لا تتضمّن إعدادات الخادم الرقم التعريفي المطلوب للناشر.
102	com.google.ads.mediation.pubmatic	شكل الإعلان غير متوافق مع PubMatic أو غير متوفّر في بيانات إشارات عروض الأسعار في الوقت الفعلي.
103	com.google.ads.mediation.pubmatic	تعذّر عرض الإعلان لأنّه لم يكن جاهزًا.
104	com.google.ads.mediation.pubmatic	معرّف الملف الشخصي غير متوفّر أو غير صالح.
105	com.google.ads.mediation.pubmatic	معرّف الوحدة الإعلانية غير متوفّر أو فارغ.
106	com.google.ads.mediation.pubmatic	"الإعلان مقابل مكافأة" الذي تم عرضه فارغ.
107	com.google.ads.mediation.pubmatic	حجم إعلان البانر غير صالح.
1001-5002	تم إرسالها من خلال حزمة SDK الخاصة بمنصة PubMatic	عرضت حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic خطأً. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات PubMatic.

iOS

رمز الخطأ	النطاق	السبب
101	com.google.ads.mediation.pubmatic	لا تتضمّن إعدادات الخادم الرقم التعريفي المطلوب للناشر.
102	com.google.ads.mediation.pubmatic	تعذّر طلب جمع إشارات عروض الأسعار بسبب تحديد تنسيقات متعددة أو عدم تحديد أي تنسيق أو تحديد تنسيق غير متوافق في معلَمات الطلب.
103	com.google.ads.mediation.pubmatic	إعدادات الإعلان غير صالحة لتحميل إعلان.
104	com.google.ads.mediation.pubmatic	تعذّر عرض "إعلان بيني" لأنّه لم يكن جاهزًا.
105	com.google.ads.mediation.pubmatic	تعذّر عرض "إعلان مقابل مكافأة" لأنّه لم يكن جاهزًا.
106	com.google.ads.mediation.pubmatic	تعذّر تحميل أحد مصادر صور الإعلانات المدمجة مع المحتوى.
107	com.google.ads.mediation.pubmatic	لا تتضمّن إعدادات الإعلان الرقم التعريفي للناشر.
108	com.google.ads.mediation.pubmatic	لا تتضمّن إعدادات الإعلان رقم تعريف الملف الشخصي.
109	com.google.ads.mediation.pubmatic	تحتوي إعدادات الإعلان على معرّف ملف شخصي غير رقمي.
110	com.google.ads.mediation.pubmatic	لا تتضمّن إعدادات الإعلان معرّف وحدة إعلانية.
111	com.google.ads.mediation.pubmatic	تعذّر على حزمة SDK الخاصة بمنصة PubMatic OpenWrap إنشاء مثيل لحجم الإعلان.
1001-5002	تم إرسالها من خلال حزمة SDK الخاصة بمنصة PubMatic	عرضت حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic خطأً. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات PubMatic.

الإصدار 0.1.0

• الإصدار الأوّلي

• متوافق مع الإصدار 5.3.0.1 من محوّل PubMatic لنظام التشغيل Android.
• يتوافق مع الإصدار 5.3.0.0 من محوّل PubMatic لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 0.1.0 من المكوّن الإضافي React Native لـ "إعلانات Google على الأجهزة الجوّالة".