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

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

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

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

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

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

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

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

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

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

هدف نشر iOS‏ 13.0 أو إصدار أحدث

أحدث إصدار من Google Mobile Ads SDK
إعداد التوسّط

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

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

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

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

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

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

ضمن مسار الدمج، اختَر iOS (Objective-C / Swift) واختَر 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 Bidding.

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

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

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

انقر على تم.

شلال

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

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

عروض الأسعار

انتقِل إلى عرض الإعلانات > مقدّمو عروض الأسعار، وانقر على الانتقال إلى SDK Bidding.

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

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

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

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

شلال

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

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

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

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

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

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

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

استخدام Swift Package Manager

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

لإضافة حزمة تابعة إلى مشروعك، اتّبِع الخطوات التالية:

في Xcode، انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة... (File > Add Package Dependencies...).
في الطلب الذي يظهر، ابحث عن عنوان URL للحزمة التالية:
```
https://github.com/googleads/googleads-mobile-ios-mediation-pubmatic.git
```
في قاعدة التبعية، اختَر الفرع.
في حقل النص، أدخِل main.

استخدام CocoaPods

أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:
```
pod 'GoogleMobileAdsMediationPubMatic'
```
من سطر الأوامر، شغِّل:
```
pod install --repo-update
```

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap لنظام التشغيل iOS واربط جميع ملفات وحِزم .xcframework في مشروعك.
نزِّل أحدث إصدار من محوِّل PubMatic من رابط التنزيل في سجلّ التغييرات واربط PubMaticAdapter.xcframework في مشروعك.

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

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

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

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

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

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

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

تنفيذ SKAdNetwork

اتّبِع مستندات PubMatic لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

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

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

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

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

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

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

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

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

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

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

رموز الخطأ

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

GADMediationAdapterPubMatic

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

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