يوضّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل تحميل الإعلانات وعرضها من PubMatic باستخدام التوسّط في AdMob، مع تغطية عمليات الدمج المستندة إلى عروض الأسعار. توضّح هذه الصفحة كيفية إضافة PubMatic إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج PubMatic والمحوّل في تطبيق iOS.
عمليات الدمج وأشكال الإعلانات المتوافقة
يتضمّن وسيط الإعلانات على PubMatic الميزات التالية:
| التكامل | |
|---|---|
| عروض الأسعار | |
| عرض إعلاني بدون انقطاع | |
| التنسيقات | |
| إعلان على شاشة فتح التطبيق | |
| بانر | |
| إعلان بيني | |
| تم منح المكافأة | |
| إعلان بيني يضمّ مكافأة | |
| مدمجة مع المحتوى | |
المتطلبات
- الإصدار المستهدف من نظام التشغيل 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.
معرِّف الملف الشخصي
بعد إنشاء تطبيقك، انتقِل إلى علامة التبويب التطبيقات (Apps) واحتفِظ بمعرّف الملف الشخصي (Profile ID) الخاص بالتطبيق الذي أنشأته حديثًا.
إنشاء وحدة إعلانية
ضمن علامة التبويب الوحدات الإعلانية، اختَر التطبيق الذي أنشأته في القسم السابق وانقر على الزر إنشاء وحدة إعلانية.
املأ النموذج بتفاصيل وحدتك الإعلانية وانقر على حفظ.
دوِّن رقم تعريف الوحدة الإعلانية في OpenWrap الذي أنشأته حديثًا.
الحصول على الرقم التعريفي للناشر
انتقِل إلى لوحة بيانات "إحصاءات Google". مرِّر مؤشر الماوس فوق رمز الملف الشخصي ودوِّن رقم التعريف.
الخطوة 2: إعداد طلب PubMatic في واجهة مستخدم AdMob
ضبط إعدادات التوسّط للوحدة الإعلانية
عليك إضافة حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap إلى إعدادات التوسّط الخاصة بوحدتك الإعلانية.
أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، ثم انتقِل إلى إضافة حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap كمصدر إعلان.
لإنشاء مجموعة توسّط جديدة، انقر على إنشاء مجموعة توسّط.
أدخِل شكل الإعلان والمنصة، ثم انقر على متابعة.
أدخِل اسمًا لمجموعة التوسّط، واختَر المواقع الجغرافية التي تريد استهدافها. بعد ذلك، اضبط حالة مجموعة التوسّط على مفعّلة، ثمّ انقر على إضافة وحدات إعلانية.
اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية الحالية على AdMob. بعد ذلك، انقر على تم.
من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:
إضافة حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap كمصدر إعلان
ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، اختَر PubMatic OpenWrap SDK .انقر على كيفية التوقيع على اتفاقية شراكة وإعداد شراكة عروض أسعار مع حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap.
انقر على الإقرار والموافقة، ثم انقر على متابعة.
إذا كان لديك ربط لحزمة PubMatic OpenWrap SDK، يمكنك اختياره. بخلاف ذلك، انقر على إضافة عملية ربط.
بعد ذلك، أدخِل معرّف الوحدة الإعلانية في OpenWrap الذي حصلت عليه في القسم السابق. بعد ذلك، انقر على تم.
إضافة PubMatic إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية وإعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة PubMatic إلى قائمة الشركاء الإعلانيين بموجب اللوائح التنظيمية الأوروبية وفي الولايات الأمريكية في واجهة مستخدم AdMob.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوّل PubMatic
CocoaPods (يُنصح به)
أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:
pod 'GoogleMobileAdsMediationPubMatic'من سطر الأوامر، شغِّل:
pod install --repo-update
الدمج اليدوي
نزِّل أحدث إصدار من حزمة PubMatic OpenWrap SDK لنظام التشغيل iOS واربط جميع ملفات
.xcframeworkوالحِزم في مشروعك.نزِّل أحدث إصدار من برنامج PubMatic الوسيط من رابط التنزيل في سجلّ التغيير واربط
PubMaticAdapter.xcframeworkفي مشروعك.
الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic
للامتثال لسياسة موافقة المستخدم في الاتحاد الأوروبي المتّبعة في Google، عليك تقديم إفصاحات معيّنة للمستخدمين في المنطقة الاقتصادية الأوروبية والمملكة المتحدة وسويسرا، والحصول على موافقتهم على استخدام ملفات تعريف الارتباط أو غيرها من وسائل التخزين المحلية حيثما كان ذلك مطلوبًا بموجب القانون، وعلى جمع البيانات الشخصية ومشاركتها واستخدامها لتخصيص الإعلانات. تراعي هذه السياسة متطلبات التوجيه الأوروبي بشأن الخصوصية الإلكترونية واللائحة العامة لحماية البيانات (GDPR). أنت المسؤول عن التأكّد من نقل الموافقة إلى كل مصدر إعلان في سلسلة التوسّط.
تتولّى PubMatic تلقائيًا قراءة الموافقة على اللائحة العامة لحماية البيانات التي تم ضبطها من خلال منصات إدارة الموافقة المتوافقة مع مواصفات "الموافقة الإضافية" من Google، بما في ذلك حزمة تطوير البرامج لمنصة UMP. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تمرير الموافقة بموجب "اللائحة العامة لحماية البيانات".
قوانين الخصوصية في الولايات الأمريكية
تتطلّب قوانين الخصوصية في الولايات الأمريكية منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية إمكانية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات من Google، ولكن لا يمكن لـ Google تطبيق هذا الإعداد على كل شبكة إعلانية في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية، واتّباع الإرشادات المقدَّمة من كل شبكة من هذه الشبكات لضمان الامتثال.
تقرأ PubMatic تلقائيًا الموافقة التي تم ضبطها في إطار "قانون خصوصية المستهلك في كاليفورنيا" من خلال منصات إدارة الموافقة التي تتوافق مع مواصفات "الموافقة الإضافية" من 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 | مُرسَلة من حزمة PubMatic SDK | عرَضت حزمة تطوير البرامج (SDK) من PubMatic خطأً. يمكنك الاطّلاع على مستندات PubMatic لمزيد من التفاصيل. |
سجلّ تغييرات محوّل التوسّط في PubMatic على iOS
الإصدار 4.8.1.1 (قيد التطوير)
- تتيح شكل الإعلانات البينية بدون انقطاع.
- يتيح شكل الإعلان بمكافأة للعرض بدون انقطاع.
- تتيح شكل إعلان البانر المتسلسل.
- يتيح شكل الإعلانات المدمجة مع المحتوى المتسلسلة.
- تم إصلاح الخلل الذي لم يتم فيه ضبط وكيل الإعلانات المدمَجة مع المحتوى بشكلٍ صحيح.
- يتضمّن Info.plist في الأُطر.
الإصدار 4.8.1.0
- تم التأكّد من التوافق مع الإصدار 4.8.1 من حزمة تطوير البرامج (SDK) لمنصة OpenWrap من PubMatic.
تم إنشاؤه واختباره باستخدام:
- الإصدار 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) لمنصة OpenWrap من PubMatic.
تم إنشاؤه واختباره باستخدام:
- الإصدار 12.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 4.7.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة OpenWrap من PubMatic