دمج حزمة تطوير البرامج (SDK) من Verve HyBid مع التوسّط

يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads SDK (Legacy) لتحميل الإعلانات وعرضها من Verve HyBid SDK باستخدام توسّط AdMob، ويغطي عمليات دمج عروض الأسعار. توضّح هذه الصفحة كيفية إضافة حزمة تطوير البرامج (SDK) لخدمة Verve HyBid إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) والمحوّل لخدمة Verve HyBid في تطبيق Android.

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

يوفّر محوّل التوسّط لحزمة Verve HyBid SDK الإمكانات التالية:

¹ يتوفّر دمج عروض الأسعار في إصدار أولي. يُرجى التواصل مع مدير حسابك لطلب الوصول.

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

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

• مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث

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

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

الخطوة 1: ضبط الإعدادات في واجهة مستخدم حزمة تطوير البرامج (SDK) لـ Verve HyBid

لضبط الإعدادات، يُرجى التواصل مع Verve.

الخطوة 2: إعداد طلب Verve HyBid SDK في واجهة مستخدم AdMob

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

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

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

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

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

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

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

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

إضافة Verve HyBid SDK كمصدر إعلان

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

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

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوِّل Verve HyBid

الدمج مع "استوديو Android" (يُنصح به)

في ملف settings.gradle.kts على مستوى المشروع، أضِف المستودعات التالية:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://verve.jfrog.io/artifactory/verve-gradle-release")
    }
  }
}

بعد ذلك، في ملف build.gradle.kts على مستوى التطبيق، أضِف الإعدادات والتبعيات التالية للتنفيذ. استخدِم أحدث إصدارات حزمة تطوير البرامج (SDK) والمحوّل من Verve HyBid:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:verve:3.9.3.0")
}

الخطوة 4: تطبيق إعدادات الخصوصية على حزمة تطوير البرامج (SDK) من Verve

سياسة موافقة المستخدم في الاتحاد الأوروبي واللائحة العامة لحماية البيانات (GDPR)

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

يتيح الإصدار 3.7.1.0 والإصدارات الأحدث من محوّل Android لحزمة تطوير البرامج (SDK) من Verve HyBid تمرير إشارات الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) من منصّات إدارة الموافقة التي تتكامل مع "إطار الشفافية والموافقة" (TCF) الصادر عن مكتب IAB إلى حزمة تطوير البرامج (SDK) من Verve HyBid. لمزيد من المعلومات، يُرجى الاطّلاع على الامتثال لإطار الشفافية والموافقة بموجب اللائحة العامة لحماية البيانات.

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

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

تتيح حزمة تطوير البرامج (SDK) لـ Verve HyBid إعدادات الخصوصية من خلال طريقة معيّنة. ينقل الرمز النموذجي التالي معلومات الموافقة هذه إلى حزمة Verve HyBid SDK. إذا كنت تمرّر معلومات الموافقة إلى حزمة تطوير البرامج (SDK) لـ Verve HyBid يدويًا، ننصحك باستدعاء المثال قبل طلب الإعلانات من خلال Google Mobile Ads SDK (Legacy).

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);
VerveMediationSnippets.java

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)
VerveMediationSnippets.kt

استبدِل US_PRIVACY_STRING بسلسلة الخصوصية في الولايات المتحدة.

لمعرفة التفاصيل، يُرجى الاطّلاع على مستندات الخصوصية الخاصة بحزمة تطوير البرامج (SDK) لـ Verve HyBid بشأن الامتثال لقانون خصوصية المستهلك في كاليفورنيا (CCPA).

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

لا يلزم استخدام رمز إضافي لدمج حزمة تطوير البرامج (SDK) لمنصة Verve HyBid.

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

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

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

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

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

اتّبِع مستندات حزمة تطوير البرامج (SDK) لـ Verve HyBid لإجراء إعدادات إضافية.

رموز الخطأ

إذا تعذّر على المحوّل تلقّي إعلان من حزمة تطوير البرامج (SDK) لـ Verve HyBid، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo.getAdapterResponses() ضمن الفئات التالية:

net.pubnative.lite.sdk
com.google.ads.mediation.verve

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل حزمة تطوير البرامج (SDK) لـ Verve HyBid عندما يتعذّر تحميل إعلان:

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

الإصدار التالي

• تم تعديل المحوّل لاستخدام واجهة برمجة التطبيقات InitializationCompleteCallback.onInitializationFailed(AdError).

الإصدار 3.9.3.0

• تم التحقّق من التوافق مع الإصدار 3.9.3 من حزمة تطوير البرامج (SDK) لـ Verve HyBid.

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

• الإصدار 25.5.0 من SDK لإعلانات Google على الأجهزة الجوّالة
• الإصدار 1.5.0 من حزمة "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 3.9.3 من حزمة Verve HyBid SDK

الإصدار 3.9.2.0

• ثبِّت تبعية Kotlin للمحوِّل على الإصدار 1.9.0 (الحد الأدنى لإصدار Kotlin المتوافق مع الجيل التالي من حزمة SDK لإعلانات Google على الأجهزة الجوّالة).
• تم التحقّق من التوافق مع الإصدار 3.9.2 من حزمة SDK لـ Verve HyBid.

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

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.4.0 من "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 3.9.2 من حزمة Verve HyBid SDK

الإصدار 3.9.1.0

• تم التحقّق من التوافق مع الإصدار 3.9.1 من حزمة SDK‏ "Verve HyBid".

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

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.3.1 من الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة
• الإصدار 3.9.1 من حزمة Verve HyBid SDK

الإصدار 3.9.0.0

• فلترة الطلبات المحظورة على فئات عمرية معيّنة في حزمة تطوير البرامج (SDK) من Verve عند ضبط مَعلمة AgeRestrictedTreatment الجديدة على CHILD
• تم التحقّق من التوافق مع الإصدار 3.9.0 من حزمة SDK لـ Verve HyBid.

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

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.2.1 من الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة
• الإصدار 3.9.0 من حزمة Verve HyBid SDK

الإصدار 3.8.2.0

• تم التحقّق من التوافق مع الإصدار 3.8.2 من حزمة Verve HyBid SDK.

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

• الإصدار 25.3.0 من SDK لإعلانات Google على الأجهزة الجوّالة
• الإصدار 1.2.1 من الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة
• الإصدار 3.8.2 من حزمة Verve HyBid SDK

الإصدار 3.8.1.1

• تمت فلترة طرق العرض القابلة للنقر للتمييز بين النقرة على معلومات المحتوى والنقرة العادية على الإعلان في VerveNativeAd.

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

• الإصدار 25.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.0.1 من الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة
• الإصدار 3.8.1 من حزمة Verve HyBid SDK

الإصدار 3.8.1.0

• تمت إضافة السمة لإنشاء المحوّل باستخدام تبعية "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة".
• تم التحقّق من التوافق مع الإصدار 3.8.1 من حزمة تطوير البرامج (SDK) لـ Verve HyBid.

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

• الإصدار 25.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 3.8.1 من حزمة Verve HyBid SDK

الإصدار 3.7.1.1

• تمت إزالة عملية التحقّق من حجم البانر من محوّل Verve لحلّ حالات تعذُّر جمع الإشارات.

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

• الإصدار 25.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 3.7.1 من حزمة Verve HyBid SDK

الإصدار 3.7.1.0

• الإصدار الأوّلي
• تم التحقّق من التوافق مع الإصدار 3.7.1 من حزمة SDK‏ "Verve HyBid".

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

• الإصدار 24.8.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 3.7.1 من حزمة Verve HyBid SDK