تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

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

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

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

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

مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث

أحدث إصدار من GMA Next-Gen SDK
إعداد التوسّط

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

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

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

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

لوحة بيانات التطبيقات

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

ضمن مسار الدمج، اختَر Android (Java / Kotlin) واختَر AdMob - عروض أسعار SDK كـ مسار الدمج الفرعي. بعد ذلك، انقر على الزر إضافة تطبيق.

نموذج التطبيق الجديد

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

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

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

app-aps.txt

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

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

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

رقم تعريف ملف التطبيق

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

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

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

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

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

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

رقم تعريف الوحدة الإعلانية في التطبيق

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

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

الرقم التعريفي للناشر

الخطوة 2: إعداد طلب PubMatic في واجهة مستخدم "إدارة الإعلانات"

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

إضافة حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap في "الشركات"

عروض الأسعار

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

شلال

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

اختَر حزمة SDK الخاصة بمنصة PubMatic OpenWrap بصفتها شبكة الإعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط.

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

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

عروض الأسعار

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

شلال

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

مشاركة الإشارة الآمنة في طلبات عروض الأسعار

عروض الأسعار

انتقِل إلى المساحات الإعلانية المتاحة > الإشارات الآمنة. ضمن الإشارات الآمنة، ابحث عن PubMatic وفعِّل تفعيل دمج التطبيق.

انقر على حفظ.

شلال

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

السماح بمشاركة الإشارات الآمنة في عروض أسعار SDK

عروض الأسعار

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

انقر على حفظ.

شلال

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

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

عروض الأسعار

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

انقر على مقدِّم عرض سعر جديد.

اختَر حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap كمقدِّم عرض السعر.

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

انقر على تم.

شلال

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

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

عروض الأسعار

اختَر الشركة التي توفّر حزمة SDK الخاصة بمنصة PubMatic OpenWrap.

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

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

أخيرًا، انقر على حفظ.

شلال

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

انتقِل إلى شركاء الأرباح وانقر على إضافة شريك توسّط.

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

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

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

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

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

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

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:pubmatic:5.4.1.0")
}

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

الخطوة 4: تطبيق إعدادات الخصوصية على PubMatic

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

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

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

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

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

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

لا حاجة إلى رمز إضافي لدمج حزمة SDK الخاصة بمنصة PubMatic OpenWrap.

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

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

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

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

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

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

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

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

يعرض محوّل PubMatic "الإعلانات المدمجة مع المحتوى" كعناصر NativeAd. يتم ملء الحقول التالية لـ NativeAd.

الحقل	مواد العرض التي يضمّنها محوّل PubMatic دائمًا
العنوان
صورة
النص
رمز
الحث على اتخاذ إجراء
التقييم بالنجوم
المتجر
السعر
المعلِن

رموز الخطأ

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

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

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

رمز الخطأ	النطاق	السبب
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.