يوضّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل تحميل الإعلانات وعرضها من PubMatic باستخدام التوسّط، مع تغطية عمليات الدمج المستندة إلى عروض الأسعار. توضّح هذه الصفحة كيفية إضافة PubMatic إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج PubMatic والمحوّل في تطبيق Android.
عمليات الدمج وأشكال الإعلانات المتوافقة
يوفّر وسيط PubMatic الميزات التالية:
| التكامل | |
|---|---|
| عروض الأسعار | |
| عرض إعلاني بدون انقطاع | |
| التنسيقات | |
| إعلان على شاشة فتح التطبيق | |
| بانر | |
| إعلان بيني | |
| تم منح المكافأة | |
| إعلان بيني مقابل مكافأة | |
| مدمجة مع المحتوى | |
المتطلبات
- المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
أكمِل دليل البدء الخاص بالتوسّط.
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم PubMatic
سجِّل الدخول إلى حسابك على PubMatic واختَر بطاقة OpenWrap SDK.
إضافة تطبيق جديد
انتقِل إلى علامة التبويب التطبيقات وانقر على الزر إضافة تطبيق.
اختَر النظام الأساسي، بالإضافة إلى عنوان URL لمتجر التطبيقات واسم التطبيق.
ضمن مسار الدمج، اختَر Android (Java / Kotlin) واختَر AdMob - عروض أسعار حزمة تطوير البرامج (SDK) كـ مسار الدمج الفرعي. بعد ذلك، انقر على الزر إضافة تطبيق.
تعديل ملف app-ads.txt
مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt.
إذا لم يسبق لك إجراء ذلك،
أنشئ ملف app-ads.txt لـ "مدير إعلانات Google".
قبل الانتهاء من تطبيقك، سيتم عرض الإدخالات المناسبة التي يجب إضافتها إلى app-ads.txt.
للحصول على معلومات إضافية حول كيفية تنفيذ app-ads.txt لـ PubMatic،
يُرجى الاطّلاع على كيفية تنفيذ ملف app-ads.txt.
معرِّف الملف الشخصي
بعد إنشاء تطبيقك، انتقِل إلى علامة التبويب التطبيقات واحتفِظ بمعرّف الملف الشخصي الخاص بالتطبيق الذي أنشأته حديثًا.
إنشاء وحدة إعلانية
ضمن علامة التبويب الوحدات الإعلانية، اختَر التطبيق الذي أنشأته في القسم السابق وانقر على الزر إنشاء وحدة إعلانية.
املأ النموذج بتفاصيل وحدتك الإعلانية وانقر على حفظ.
دوِّن رقم تعريف الوحدة الإعلانية في OpenWrap الذي أنشأته حديثًا.
الحصول على الرقم التعريفي للناشر
انتقِل إلى لوحة بيانات "إحصاءات Google". مرِّر مؤشر الماوس فوق رمز الملف الشخصي ودوِّن رقم التعريف.
الخطوة 2: إعداد طلب PubMatic في واجهة مستخدم "مدير إعلانات Google"
سجِّل الدخول إلى حسابك على "مدير إعلانات Google".
تفعيل ميزة "مشاركة الإشارات الآمنة"
انتقِل إلى المشرف > الإعدادات العامة. انتقِل إلى علامة التبويب إعدادات حساب Ad Exchange وراجِع خيار مشاركة الإشارات الآمنة وفعِّله. انقر على حفظ.
مشاركة الإشارات الآمنة في طلبات عروض الأسعار
انتقِل إلى المستودع الإعلاني > الإشارات الآمنة. ضمن الإشارات الآمنة، ابحث عن PubMatic وفعِّل تفعيل تكامل التطبيق.
انقر على حفظ.
السماح بمشاركة الإشارات الآمنة في "عروض الأسعار باستخدام حِزم تطوير البرامج (SDK)"
انتقِل إلى عرض الإعلانات > إعدادات قناة طلبات الإعلانات. في علامة التبويب الإعدادات التلقائية، فعِّل خيار السماح بمشاركة الإشارات الآمنة في عروض أسعار حزمة تطوير البرامج (SDK).
انقر على حفظ.
ضبط عروض أسعار PubMatic
انتقِل إلى التسليم > مقدّمو عروض الأسعار، ثمّ انقر على الانتقال إلى SDK Bidding.
انقر على مقدّم عروض جديد.
اختَر PubMatic كمقدّم عروض.
انقر على متابعة لتفعيل SDK Bidding لمقدّم عرض السعر هذا.
انقر على تم.
ضبط ربط الوحدات الإعلانية
انتقِل إلى التسليم > مقدّمو عروض الأسعار، ثمّ انقر على الانتقال إلى SDK Bidding.
اختَر الشركة التي تستخدم حزمة PubMatic OpenWrap SDK.
انتقِل إلى علامة التبويب تعيين الوحدات الإعلانية وانقر على تعيين وحدة إعلانية جديدة.
اختَر وحدة إعلانية محدّدة. اختَر وحدة إعلانية وتنسيقًا، ثم تطبيق الأجهزة الجوّالة كـ نوع المستودع وتطبيق الأجهزة الجوّالة. بعد ذلك، أدخِل رقم تعريف الوحدة الإعلانية في OpenWrap الذي حصلت عليه في القسم السابق.
إذا كنت بصدد إعداد عملية ربط وحدات إعلانية لإعلان بيني مقابل مكافأة ضمن واجهة مستخدم "مدير إعلانات Google"، اختَر شكل الإعلان مقابل مكافأة واستخدِم رقم تعريف موضع الإعلان البيني مقابل مكافأة.
وأخيرًا، انقر على حفظ.
إضافة PubMatic إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة PubMatic إلى قائمة الشركاء الإعلانيين بموجب اللوائح التنظيمية الأوروبية وفي الولايات الأمريكية ضمن واجهة مستخدم "إدارة إعلانات Google".
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوّل PubMatic
دمج "استوديو Android" (يُنصح به)
في ملف settings.gradle.kts على مستوى المشروع، أضِف المستودعات التالية:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://repo.pubmatic.com/artifactory/public-repos")
}
}
}
بعد ذلك، في ملف build.gradle.kts على مستوى التطبيق، أضِف تبعيات التنفيذ والإعدادات التالية. استخدِم أحدث إصدارات من حزمة تطوير البرامج (SDK) والمحوّل من PubMatic:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.7.0")
implementation("com.google.ads.mediation:pubmatic:4.9.1.0")
}
الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic
للامتثال لسياسة موافقة المستخدم في الاتحاد الأوروبي المتّبعة في Google، عليك تقديم إفصاحات معيّنة للمستخدمين في المنطقة الاقتصادية الأوروبية والمملكة المتحدة وسويسرا، والحصول على موافقتهم على استخدام ملفات تعريف الارتباط أو غيرها من وسائل التخزين المحلية حيثما كان ذلك مطلوبًا بموجب القانون، وعلى جمع البيانات الشخصية ومشاركتها واستخدامها لتخصيص الإعلانات. تراعي هذه السياسة متطلبات التوجيه الأوروبي بشأن الخصوصية الإلكترونية واللائحة العامة لحماية البيانات (GDPR). أنت المسؤول عن التأكّد من نقل الموافقة إلى كل مصدر إعلان في سلسلة التوسّط.
تتولّى PubMatic تلقائيًا قراءة الموافقة على اللائحة العامة لحماية البيانات التي تم ضبطها من خلال منصات إدارة الموافقة المتوافقة مع مواصفات "الموافقة الإضافية" من Google، بما في ذلك حزمة تطوير البرامج لمنصة UMP. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تمرير الموافقة بموجب "اللائحة العامة لحماية البيانات".
قوانين الخصوصية في الولايات الأمريكية
تتطلّب قوانين الخصوصية في الولايات الأمريكية منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية إمكانية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات من Google، ولكن لا يمكن لـ Google تطبيق هذا الإعداد على كل شبكة إعلانية في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية، واتّباع الإرشادات المقدَّمة من كل شبكة من هذه الشبكات لضمان الامتثال.
تقرأ PubMatic تلقائيًا الموافقة التي تم ضبطها في إطار "قانون خصوصية المستهلك في كاليفورنيا" من خلال منصات إدارة الموافقة التي تتوافق مع مواصفات "الموافقة الإضافية" من Google، بما في ذلك حزمة تطوير البرامج (SDK) لمنصّة UMP. لمزيد من المعلومات، اطّلِع على مقالة تمرير الموافقة في إطار الشفافية والموافقة على مستوى العالم (GPP).
الخطوة 5: إضافة الرمز المطلوب
لا يلزم استخدام أي رمز إضافي لدمج PubMatic.
الخطوة 6: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات".
التحقّق من الإعلانات الاختبارية
للتحقّق من أنّك تتلقّى إعلانات اختبارية من حزمة تطوير البرامج (SDK) الخاصة بمنصة PubMatic OpenWrap، فعِّل اختبار مصدر إعلان فردي في "فاحص الإعلانات" باستخدام مصادر الإعلانات PubMatic(عروض الأسعار).
خطوات اختيارية
إعلانات مدمجة مع المحتوى
عرض الإعلانات
تعرض أداة PubMatic الإعلانات المدمجة مع المحتوى على شكل
كائنات NativeAd. يتم ملء
الحقول
التالية
لـ
NativeAd.
| الحقل | مواد العرض التي يضمّنها محوّل PubMatic دائمًا |
|---|---|
| العنوان | |
| صورة | |
| النص | |
| رمز | |
| الحث على اتخاذ إجراء | |
| التقييم بالنجوم | |
| المتجر | |
| السعر | |
| المعلِن |
رموز الخطأ
إذا لم يتمكّن المحوّل من تلقّي إعلان من PubMatic، يمكنك التحقّق من الخطأ الأساسي من ردّ الإعلان باستخدام
ResponseInfo.getAdapterResponses()
ضمن الفئات التالية:
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل PubMatic عندما يتعذّر تحميل إعلان:
| رمز الخطأ | النطاق | السبب |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | تفتقد إعدادات الخادم رقم تعريف الناشر المطلوب. |
| 102 | com.google.ads.mediation.pubmatic | إعدادات الإعلان غير صالحة لتحميل إعلان. |
| 103 | com.google.ads.mediation.pubmatic | تعذّر عرض إعلان لأنّه لم يكن جاهزًا. |
| 1001-5002 | مُرسَلة من حزمة PubMatic SDK | عرَضت حزمة تطوير البرامج (SDK) من PubMatic خطأً. يمكنك الاطّلاع على مستندات PubMatic لمزيد من التفاصيل. |
سجلّ تغييرات محوّل وسيط PubMatic لنظام التشغيل Android
الإصدار 4.9.1.0
- تم التأكّد من التوافق مع الإصدار 4.9.1 من حزمة تطوير البرامج (SDK) من Pubmatic.
تم إنشاؤه واختباره باستخدام:
- الإصدار 24.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 4.9.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Pubmatic
الإصدار 4.8.0.1
- تضيف هذه السمة إمكانية عرض الإعلانات البينية بدون انقطاع.
- تضيف هذه السمة إمكانية عرض الإعلانات بمكافأة بدون انقطاع.
- تضيف هذه السمة إمكانية عرض إعلانات البانر بدون انقطاع.
- تضيف هذه السمة إمكانية عرض "الإعلانات المدمجة مع المحتوى" بدون انقطاع.
- تم التأكّد من التوافق مع الإصدار 4.8.0 من حزمة تطوير البرامج (SDK) من Pubmatic.
تم إنشاؤه واختباره باستخدام:
- الإصدار 24.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 4.8.0 من حزمة تطوير البرامج (SDK) من Pubmatic
الإصدار 4.8.0.0
- تم التأكّد من التوافق مع الإصدار 4.8.0 من حزمة تطوير البرامج (SDK) من Pubmatic.
تم إنشاؤه واختباره باستخدام:
- الإصدار 24.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 4.8.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Pubmatic
الإصدار 4.7.1.1
- حجم ثابت لرمز AdChoices
تم إنشاؤه واختباره باستخدام:
- الإصدار 24.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 4.7.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Pubmatic
الإصدار 4.7.1.0
- تم التحقّق من التوافق مع الإصدار 4.7.1 من حزمة تطوير البرامج (SDK) من Pubmatic.
تم إنشاؤه واختباره باستخدام:
- الإصدار 24.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 4.7.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Pubmatic
الإصدار 4.7.0.1
- تم إصلاح التبعيات الداخلية.
تم إنشاؤه واختباره باستخدام:
- الإصدار 24.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- إصدار 4.7.0 من حزمة تطوير البرامج (SDK) من Pubmatic
الإصدار 4.7.0.0
- الإصدار الأوّلي.
- تمّت إضافة إمكانية عروض الأسعار لأشكال الإعلانات التالية: إعلانات البانر والإعلانات البينية والإعلانات مقابل مكافأة والإعلانات المدمجة مع المحتوى.
- تم التأكّد من التوافق مع الإصدار 4.7.0 من حزمة تطوير البرامج (SDK) من Pubmatic.
تم إنشاؤه واختباره باستخدام:
- الإصدار 24.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- إصدار 4.7.0 من حزمة تطوير البرامج (SDK) من Pubmatic