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

اختيار النظام الأساسي: Android iOS Android (الإصدار القديم)

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

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

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

التكامل
عروض الأسعار	^1
شلال
التنسيقات
بانر
إعلان بيني
إعلان بيني مقابل مكافأة
تمت المكافأة
مدمج مع المحتوى

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

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

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

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

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

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

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

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

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

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

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

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

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

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

انقر على حفظ.

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

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

انقر على حفظ.

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

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

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

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

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

انقر على تم.

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

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

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

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

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

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

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

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

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

ملاحظة مهمة: تأكَّد من أنّ لديك إذن إدارة الحساب لإكمال عملية الإعداد الخاصة بميزة "موافقة المستخدم في الاتحاد الأوروبي" واللائحة العامة لحماية البيانات ولوائح الولايات الأمريكية ومنصّة رسائل المستخدمين. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إدارة مستويات وصول المستخدمين إلى حسابك.

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

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

ملاحظة: قد يؤدي عدم دمج الإصدارات المتوافقة من حزمة تطوير البرامج (SDK) الخاصة بـ Verve HyBid والإصدارات Google Mobile Ads SDK (Legacy) إلى حدوث مشاكل في الإنشاء.

دمج "استوديو 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.4.0")
    implementation("com.google.ads.mediation:verve:3.9.1.0")
}

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

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

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

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

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

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

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

جافا

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

Kotlin

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

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

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

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

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

الخطوة 6: اختبار عملية الإعداد

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

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

ملاحظة مهمة: عليك إيقاف وضع الاختبار في "إدارة الإعلانات" وVerve HyBid SDK قبل إصدار تطبيقك.

تأكيد الإعلانات الاختبارية

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

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

رموز الخطأ

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

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

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

رمز الخطأ	السبب
من 100 إلى 103	عرضت حزمة تطوير البرامج (SDK) الخاصة بمنصة Verve HyBid خطأً.
101	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع حزمة تطوير البرامج (SDK) الخاصة بمنصة Verve HyBid.
102	رمز التطبيق غير متوفّر أو فارغ.
103	السياق فارغ.

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

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

الإصدار 3.8.2.0

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

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

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

الإصدار 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 Adapter لحلّ مشاكل تعذُّر جمع الإشارات.

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

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

الإصدار 3.7.1.0

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

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

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