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

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

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

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

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

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

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

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

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

• إعداد التوسّط

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

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

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

سجِّل الدخول إلى حسابك على "مدير إعلانات Google".

تفعيل ميزة "مشاركة الإشارات الآمنة"

انتقِل إلى المشرف > الإعدادات العامة. انتقِل إلى علامة التبويب إعدادات حساب Ad Exchange وراجِع خيار مشاركة الإشارات الآمنة وفعِّله. انقر على حفظ.

مشاركة الإشارات الآمنة في طلبات عروض الأسعار

انتقِل إلى المساحات الإعلانية المتاحة > الإشارات الآمنة. ضمن الإشارات الآمنة، ابحث عن Verve HyBid SDK وفعِّل تفعيل الدمج على التطبيق.

انقر على حفظ.

السماح بمشاركة الإشارات الآمنة في ميزة "عروض الأسعار باستخدام حِزم تطوير البرامج (SDK)"

انتقِل إلى عرض الإعلانات > إعدادات قنوات طلبات الإعلانات. في علامة التبويب الإعدادات التلقائية، فعِّل الخيار السماح بمشاركة الإشارات الآمنة من أجل عروض أسعار حزمة تطوير البرامج (SDK).

انقر على حفظ.

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

انتقِل إلى عرض الإعلانات > مقدّمو عروض الأسعار، وانقر على الانتقال إلى عروض أسعار باستخدام حِزم تطوير البرامج (SDK).

انقر على مقدِّم عرض سعر جديد.

اختَر Verve Group كمقدّم عرض السعر.

انقر على متابعة لتفعيل ميزة "عروض أسعار باستخدام حِزم تطوير البرامج (SDK)" لمقدّم عروض الأسعار هذا.

انقر على تم.

ضبط عملية ربط الوحدات الإعلانية

انتقِل إلى عرض الإعلانات > مقدّمو عروض الأسعار، وانقر على الانتقال إلى عروض أسعار باستخدام حِزم تطوير البرامج (SDK).

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

انتقِل إلى علامة التبويب تعيين الوحدات الإعلانية وانقر على تعيين وحدة إعلانية جديدة.

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

إذا كنت بصدد ضبط تعيين الوحدة الإعلانية لإعلان بيني مقابل مكافأة ضمن واجهة مستخدم "إدارة إعلانات Google"، اختَر شكل الإعلان مقابل مكافأة واستخدِم رقم تعريف موضع الإعلان البيني مقابل مكافأة.

أخيرًا، انقر على حفظ.

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

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

الخطوة 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 على مستوى التطبيق، أضِف التبعيات والإعدادات التالية للتنفيذ. استخدِم أحدث إصدارات من حزمة Verve HyBid SDK والمحوّل:

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

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

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

تقرأ حزمة Verve HyBid SDK تلقائيًا الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) التي تحدّدها منصّات إدارة الموافقة، بما في ذلك حزمة تطوير البرامج لمنصّة UMP. لمزيد من المعلومات، اطّلِع على مقالة الامتثال لإطار الشفافية والموافقة بموجب "اللائحة العامة لحماية البيانات".

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

تتطلّب قوانين الخصوصية في الولايات الأمريكية منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح لك دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات من 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: اختبار عملية التنفيذ

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

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

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

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

اتّبِع مستندات Verve HyBid SDK لإجراء إعدادات إضافية.

رموز الخطأ

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

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

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

سجلّ تغييرات محوّل وسيط Verve Android

الإصدار 3.9.3.0 (قيد التطوير)

الإصدار 3.9.2.0

• ثبِّت إصدار 1.9.0 من تبعية Kotlin الخاصة بالمحوّل (وهو الحد الأدنى من إصدار 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 على الأجهزة الجوّالة"
• ‫Verve HyBid SDK الإصدار 3.9.1

الإصدار 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 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Verve HyBid

الإصدار 3.8.1.0

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

تم التصميم والاختبار باستخدام:

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

الإصدار 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 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Verve HyBid