يوضّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل تحميل الإعلانات وعرضها من PubMatic باستخدام التوسّط في AdMob، مع تغطية عمليات الدمج المستندة إلى عروض الأسعار. توضّح هذه الصفحة كيفية إضافة حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل PubMatic OpenWrap في تطبيق iOS.
عمليات الدمج وأشكال الإعلانات المتوافقة
يتضمّن وسيط PubMatic الميزات التالية:
| التكامل | |
|---|---|
| عروض الأسعار | 1 |
| شلال | |
| التنسيقات | |
| إعلان على شاشة فتح التطبيق | |
| بانر | |
| إعلان بيني | 2 |
| تمت المكافأة | 2 |
| إعلان بيني يقدّم مكافأة | |
| مدمجة مع المحتوى | 2 |
1 تتوفّر ميزة دمج عروض الأسعار في إصدار تجريبي مغلق، لذا يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
2 تتوفّر جميع أشكال الإعلانات الأخرى المتوافقة باستثناء "إعلانات البانر" في مرحلة الإصدار الأوّلي.
المتطلبات
- الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث
أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
أكمِل دليل البدء الخاص بالتوسّط.
الخطوة 1: إعداد الإعدادات في واجهة مستخدم PubMatic
سجِّل الدخول إلى حسابك على PubMatic واختَر بطاقة OpenWrap SDK.
إضافة تطبيق جديد
انتقِل إلى علامة التبويب التطبيقات وانقر على الزر إضافة تطبيق.
اختَر النظام الأساسي، بالإضافة إلى عنوان URL لمتجر التطبيقات واسم التطبيق.
ضمن مسار الدمج، اختَر iOS (Objective-C / Swift) واختَر AdMob - عروض أسعار حزمة تطوير البرامج (SDK) كـ مسار الدمج الفرعي. بعد ذلك، انقر على الزر إضافة تطبيق.
تعديل ملف app-ads.txt
مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك سوى من خلال القنوات التي حدَّدت أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt.
إذا لم يسبق لك إجراء ذلك، عليك إعداد ملف app-ads.txt لتطبيقك.
قبل الانتهاء من تطبيقك، سيتم عرض الإدخالات المناسبة التي يجب إضافتها إلى app-ads.txt.
للحصول على معلومات إضافية حول كيفية تنفيذ app-ads.txt لشبكة PubMatic،
يُرجى الاطّلاع على كيفية تنفيذ ملف app-ads.txt.
معرِّف الملف الشخصي
بعد إنشاء تطبيقك، انتقِل إلى علامة التبويب التطبيقات واحتفظ بمعرّف الملف الشخصي الخاص بالتطبيق الذي أنشأته حديثًا.
إنشاء وحدة إعلانية
ضمن علامة التبويب الوحدات الإعلانية، اختَر التطبيق الذي أنشأته في القسم السابق وانقر على الزر إنشاء وحدة إعلانية.
املأ النموذج بتفاصيل وحدتك الإعلانية وانقر على حفظ.
دوِّن معرّف الوحدة الإعلانية في OpenWrap الذي أنشأته حديثًا.
الحصول على الرقم التعريفي للناشر
انتقِل إلى لوحة بيانات "إحصاءات Google". مرِّر مؤشر الماوس فوق رمز الملف الشخصي واحتفظ برقم التعريف.
الخطوة 2: إعداد طلب PubMatic في واجهة مستخدم AdMob
ضبط إعدادات التوسّط للوحدة الإعلانية
عليك إضافة حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap إلى إعدادات التوسّط الخاصة بوحدتك الإعلانية.
أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، ثم انتقِل إلى إضافة حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap كمصدر إعلان.
لإنشاء مجموعة توسّط جديدة، انقر على إنشاء مجموعة توسّط.
أدخِل شكل الإعلان والمنصة، ثم انقر على متابعة.
أدخِل اسمًا لمجموعة التوسّط، واختَر المواقع الجغرافية التي تريد استهدافها. بعد ذلك، اضبط حالة مجموعة التوسّط على مفعّلة، ثمّ انقر على إضافة وحدات إعلانية.
اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية الحالية على AdMob. بعد ذلك، انقر على تم.
من المفترض أن تظهر الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:
إضافة حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap كمصدر إعلان
ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، اختَر حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.انقر على كيفية التوقيع على اتفاقية شراكة وإعداد شراكة في عروض الأسعار مع حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.
انقر على الإقرار والموافقة، ثم انقر على متابعة.
إذا كان لديك ربط لحزمة PubMatic OpenWrap SDK، يمكنك اختياره. بخلاف ذلك، انقر على إضافة عملية ربط.
بعد ذلك، أدخِل معرّف الوحدة الإعلانية في OpenWrap الذي حصلت عليه في القسم السابق. بعد ذلك، انقر على تم.
إضافة PubMatic إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" (GDPR) واللوائح التنظيمية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية وإعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة PubMatic إلى قائمة الشركاء الإعلانيين بموجب اللوائح التنظيمية الأوروبية واللوائح التنظيمية في الولايات الأمريكية ضمن واجهة مستخدم AdMob.
الخطوة 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 تلقائيًا الموافقة على اللائحة العامة لحماية البيانات التي تم ضبطها من خلال منصات إدارة الموافقة المتوافقة مع مواصفات "الموافقة الإضافية" من Google، بما في ذلك حزمة تطوير البرامج لمنصة UMP. لمزيد من المعلومات، يُرجى الاطّلاع على تمرير الموافقة بموجب "اللائحة العامة لحماية البيانات".
قوانين الخصوصية في الولايات الأمريكية
تتطلّب قوانين الخصوصية في الولايات الأمريكية منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية إمكانية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات من Google، ولكن لا يمكن لـ Google تطبيق هذا الإعداد على كل شبكة إعلانية في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية واتّباع الإرشادات المقدَّمة من كل شبكة من هذه الشبكات لضمان الامتثال.
تقرأ PubMatic تلقائيًا الموافقة على GPP التي تم ضبطها من خلال منصّات إدارة الموافقة التي تتوافق مع مواصفات "الموافقة الإضافية" من Google، بما في ذلك حزمة تطوير البرامج (SDK) لمنصّة UMP. لمزيد من المعلومات، راجِع مقالة تمرير الموافقة في إطار الشفافية والموافقة على مستوى العالم (GPP).
الخطوة 5: إضافة الرمز المطلوب
تكامل SKAdNetwork
اتّبِع مستندات PubMatic
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 6: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob.
التحقّق من الإعلانات الاختبارية
للتحقّق من أنّك تتلقّى إعلانات اختبارية من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap، فعِّل اختبار مصدر إعلان فردي في "فاحص الإعلانات" باستخدام مصادر الإعلانات PubMatic(عروض الأسعار).
خطوات اختيارية
إعلانات مدمجة مع المحتوى
عرض الإعلانات
يعرض محوّل 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 | تعذّر تحميل أحد مصادر صور الإعلانات المحلية. |
| 1001-5002 | تم إرسالها من خلال حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic | عرضت حزمة تطوير البرامج (SDK) من PubMatic خطأً. يمكنك الاطّلاع على مستندات PubMatic لمزيد من التفاصيل. |
سجلّ التغيير في محوّل التوسّط على iOS من PubMatic
الإصدار 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 على الأجهزة الجوّالة"
- PubMatic OpenWrap SDK الإصدار 4.8.1
الإصدار 4.8.0.0
- تم التأكّد من التوافق مع الإصدار 4.8.0 من حزمة تطوير البرامج (SDK) لمنصة OpenWrap من PubMatic.
تم إنشاؤه واختباره باستخدام:
- الإصدار 12.8.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- PubMatic OpenWrap SDK الإصدار 4.8.0
الإصدار 4.7.0.0
- الإصدار الأوّلي.
- تتيح عروض الأسعار لأشكال الإعلانات التالية: إعلانات البانر والإعلانات البينية والإعلانات مقابل مكافأة والإعلانات المدمجة مع المحتوى.
- تم إثبات التوافق مع الإصدار 4.7.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.
تم إنشاؤه واختباره باستخدام:
- الإصدار 12.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 4.7.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap