دمج PubMatic OpenWrap (إصدار تجريبي) مع ميزة "التوسّط"

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

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

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

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

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

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

• أن يكون هدف نشر iOS هو الإصدار 13.0 أو إصدار أحدث

• أحدث إصدار من Google Mobile Ads SDK

• إعداد ميزة "توسّط AdMob"

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

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

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

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

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

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

تعديل ملف 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: إعداد طلب PubMatic في واجهة مستخدم AdMob

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

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

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

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

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

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

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

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

إضافة حزمة SDK الخاصة بمنصة PubMatic OpenWrap كمصدر إعلان

عروض الأسعار

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

انقر على الإقرار والموافقة، ثم على حفظ.



إذا كان لديك تعيين حالي لحزمة SDK الخاصة بمنصة PubMatic OpenWrap، يمكنك اختياره. بخلاف ذلك، انقر على إضافة عملية ربط.



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

شلال

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

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




إذا سبق لك ربط حزمة SDK الخاصة بمنصة PubMatic OpenWrap، يمكنك اختيارها. بخلاف ذلك، انقر على إضافة عملية ربط.



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

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

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

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

الإجراء المقترَح: استخدام Swift Package Manager

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

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

1. في Xcode، انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة... (File > Add Package Dependencies...).

2. في الطلب الذي يظهر، ابحث عن عنوان URL للحزمة التالية:

   https://github.com/googleads/googleads-mobile-ios-mediation-pubmatic.git
   

3. في قاعدة التبعية، اختَر الفرع.

4. في حقل النص، أدخِل main.

الدمج اليدوي

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

2. نزِّل أحدث إصدار من محوِّل PubMatic من رابط التنزيل في سجلّ التغييرات واربط PubMaticAdapter.xcframework في مشروعك.

استخدام CocoaPods

• أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:

  pod 'GoogleMobileAdsMediationPubMatic'
  

• من سطر الأوامر، شغِّل:

  pod install --repo-update

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

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

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

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

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

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

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

تنفيذ SKAdNetwork

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

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

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

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

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

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

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

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

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

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

رموز الخطأ

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

GADMediationAdapterPubMatic

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

سجلّ التغييرات في محوّل التوسّط في PubMatic لنظام التشغيل iOS

الإصدار 5.5.0.0

• تم التحقّق من التوافق مع الإصدار 5.5.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.12.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.5.0 من حزمة SDK الخاصة بمنصة PubMatic OpenWrap

الإصدار 5.4.1.0

• تم التحقّق من التوافق مع الإصدار 5.4.1 من حزمة SDK الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.10.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.4.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 5.4.0.0

• تم التحقّق من التوافق مع الإصدار 5.4.0 من حزمة SDK الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.9.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.4.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 5.3.0.0

• تم التحقّق من التوافق مع الإصدار 5.3.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.8.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.3.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 5.2.0.0

• تم التحقّق من التوافق مع الإصدار 5.2.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.
• يتطلّب الآن الإصدار 13.6 أو إصدارًا أحدث من SDK لإعلانات Google على الأجهزة الجوّالة.
• تمت إضافة إمكانية استخدام مادة عرض الفيديو في "الإعلانات المدمجة مع المحتوى" باستخدام واجهة برمجة التطبيقات mediaView.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.7.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.2.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 5.1.1.0

• تم التحقّق من التوافق مع الإصدار 5.1.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.1.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 5.1.0.1

• يعيد المحوّل الآن توجيه علامة ageRestrictedTreatment في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى واجهة برمجة التطبيقات COPPA API في حزمة SDK لـ PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.1.0 من حزمة SDK الخاصة بمنصة PubMatic OpenWrap

الإصدار 5.1.0.0

• تم التحقّق من التوافق مع الإصدار 5.1.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.1.0 من حزمة SDK الخاصة بمنصة PubMatic OpenWrap

الإصدار 5.0.1.0

• تم التحقّق من التوافق مع الإصدار 5.0.1 من حزمة SDK الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.0.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 5.0.0.0

• تم التحقّق من التوافق مع الإصدار 5.0.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.0.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 4.12.0.0

• تم التحقّق من التوافق مع الإصدار 4.12.0 من حزمة SDK الخاصة بمنصة PubMatic OpenWrap.
• تم تعديل تبعية حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى الإصدار 13.0.0.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 4.12.0 من حزمة SDK الخاصة بمنصة PubMatic OpenWrap

الإصدار 4.11.0.2

• تم تعديل الحدّ الأدنى لإصدار iOS في CocoaPods إلى 13.0.

تم إنشاؤه واختباره باستخدام:

• الإصدار 13.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 4.11.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 4.11.0.1

• تمت إضافة إمكانية إعادة توجيه مَعلمتَي tagForChildDirectedTreatment وtagForUnderAgeOfConsent في "SDK لإعلانات Google على الأجهزة الجوّالة" إلى حزمة SDK الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 12.14.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 4.11.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 4.11.0.0

• تم التحقّق من التوافق مع الإصدار 4.11.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 12.14.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 4.11.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 4.10.0.0

• تم التحقّق من التوافق مع الإصدار 4.10.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 12.12.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 4.10.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 4.9.0.0

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

تم إنشاؤه واختباره باستخدام:

• الإصدار 12.12.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 4.9.0 من حزمة SDK الخاصة بمنصة PubMatic OpenWrap

الإصدار 4.8.1.0

• تم التحقّق من التوافق مع الإصدار 4.8.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 12.9.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 4.8.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 4.8.0.0

• تم التحقّق من التوافق مع الإصدار 4.8.0 من حزمة SDK الخاصة بمنصة PubMatic OpenWrap.

تم إنشاؤه واختباره باستخدام:

• الإصدار 12.8.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 4.8.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap

الإصدار 4.7.0.0

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

تم إنشاؤه واختباره باستخدام:

• الإصدار 12.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 4.7.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap