تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

دمج Mintegral مع عروض الأسعار (إصدار تجريبي)

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

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

تتوفر لبرنامج التوسّط في Mintegral الإمكانات التالية:

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

¹ يتوفّر دمج عروض الأسعار في مرحلة الإصدار العلني التجريبي.

المتطلبات

المستوى 23 من واجهة برمجة التطبيقات لنظام التشغيل Android أو مستوى أعلى

[لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم محوِّل Mintegral‏ 16.5.91.1 أو إصدار أحدث (ننصح باستخدام أحدث إصدار).

أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
إكمال التوسّط دليل البدء

الخطوة 1: إعداد الإعدادات في واجهة مستخدم Mintegral

اشترِك أو سجِّل الدخول إلى حسابك على Mintegral.

تحديد مكان مفتاح التطبيق

انتقِل إلى علامة التبويب إعدادات التطبيق ودوِّن مفتاح التطبيق.

إضافة تطبيق جديد

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

اختَر النظام الأساسي واملأ بقية النموذج. بعد ذلك، انقر على حفظ.

دوِّن رقم تعريف التطبيق.

إنشاء موضع إعلان

بعد إنشاء طلبك، انتقِل إلى علامة التبويب المواضع والوحدات وانقر على الزر إضافة موضع إعلان كما هو موضّح أدناه لإنشاء موضع إعلانك.

أدخِل اسم موضع الإعلان وتنسيق الإعلان.

اختَر عروض أسعار الرؤوس كـ نوع عروض الأسعار. املأ بقية النموذج وانقر على حفظ.

بعد إنشاء موضع إعلانك، دوِّن معرّف موضع الإعلان.

انقر على القائمة المنسدلة وحدة إعلانية واحدة ودوِّن رقم تعريف الوحدة الإعلانية.

تحديد موضع مفتاح واجهة برمجة التطبيقات Reporting API في Mintegral

عروض الأسعارشلال

هذه الخطوة غير مطلوبة لدمج عروض الأسعار.

ستحتاج إلى مفتاح Mintegral Reporting API لإعداد رقم تعريف الوحدة الإعلانية في "مدير إعلانات Google". انتقِل إلى الحساب > أدوات واجهة برمجة التطبيقات. دوِّن Skey وSecret.

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

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

إضافة Mintegral في الشركات

عروض الأسعارشلال

هذه الخطوة غير مطلوبة لدمج عروض الأسعار.

انتقِل إلى المشرف > الشركات، ثم انقر على الزر شركة جديدة في علامة التبويب جميع الشركات. اختَر شبكة الإعلانات.

اختَر Mintegral كشبكة المواقع الإعلانية، وأدخِل اسمًا فريدًا وفعِّل التوسّط.

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

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

عروض الأسعارشلال

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

هذه الخطوة غير مطلوبة لعمليات دمج العرض الإعلاني بدون انقطاع.

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

عروض الأسعارشلال

انتقِل إلى المستودع الإعلاني > الإشارات الآمنة. ضمن الإشارات الآمنة، ابحث عن Mobvista/Mintegral وفعِّل تفعيل تكامل التطبيقات.

انقر على حفظ.

هذه الخطوة غير مطلوبة لعمليات دمج العرض الإعلاني بدون انقطاع.

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

عروض الأسعارشلال

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

انقر على حفظ.

هذه الخطوة غير مطلوبة لعمليات دمج العرض الإعلاني بدون انقطاع.

ضبط عروض أسعار Mintegral

عروض الأسعارشلال

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

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

اختَر Mintegral كمقدّم عروض الأسعار.

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

انقر على تم.

هذه الخطوة غير مطلوبة لعمليات دمج العرض الإعلاني بدون انقطاع.

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

عروض الأسعارشلال

اختَر الشركة التي تتعامل معها في Mintegral.

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

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

انتقِل إلى العرض > مجموعات الأرباح وانقر على الزر مجموعة أرباح جديدة. اختَر تطبيقك المتوافق مع الأجهزة الجوّالة.

انتقِل للأسفل وانقر على إضافة شريك عائد.

اختَر الشركة التي أنشأتها لأجل Mintegral في القسم السابق. اختَر توسّط حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، Android كـ النظام الأساسي، ونشط كـ الحالة.

أدخِل مفتاح التطبيق ورقم تعريف التطبيق ورقم تعريف موضع الإعلان ورقم تعريف الوحدة الإعلانية التي حصلت عليها في القسم السابق، وقيمة التكلفة لكل ألف ظهور التلقائية. انقر على حفظ.

إضافة Mobvista/Mintegral إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" (GDPR) واللوائح التنظيمية في الولايات الأمريكية

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

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

دمج "استوديو Android" (إجراء يُنصح به)

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
  }
}

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.0.0")
    implementation("com.google.ads.mediation:mintegral:16.9.41.1")
}

الدمج اليدوي

لتضمين حزمة تطوير البرامج (SDK) من Mintegral، انتقِل إلى حزمة تطوير البرامج (SDK) من Mintegral لنظام التشغيل Android.
انتقِل إلى عناصر محوِّل Mintegral في مستودع Maven من Google. اختَر أحدث إصدار، ونزِّل ملف .aar الخاص بمحوِّل Mintegral ، وأضِفه إلى مشروعك.

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

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

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

تتضمّن حزمة SDK من Mintegral طريقة setConsentStatus لنقل معلومات الموافقة إلى حزمة SDK من Mintegral.

يوضّح الرمز البرمجي النموذجي التالي كيفية تمرير معلومات الموافقة إلى ملف SDK الخاص بمنصّة Mintegral. يجب ضبط هذه الخيارات قبل إعداد حزمة SDK لإعلانات Google على الأجهزة الجوّالة لضمان إعادة توجيهها بشكل صحيح إلى حزمة SDK من Mintegral.

Java Kotlin

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)

اطّلِع على مستندات خصوصية Mintegral لمزيد من المعلومات.

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

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

تتضمّن حزمة SDK من Mintegral طريقة setDoNotTrackStatus لنقل معلومات الموافقة إلى حزمة SDK من Mintegral.

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

Java Kotlin

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)

اطّلِع على مستندات خصوصية Mintegral لمزيد من المعلومات.

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

لا يلزم استخدام رمز إضافي لدمج Mintegral.

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

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

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

للحصول على إعلانات تجريبية من Mintegral لأشكال إعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافآت والإعلانات المدمجة مع المحتوى، تنصح Mintegral باستخدام مفاتيح التطبيقات وأرقام تعريف التطبيقات وأرقام تعريف مواضع الإعلانات وأرقام تعريف الوحدات الإعلانية المتوفّرة في صفحة رقم التعريف التجريبي في Mintegral.

إثبات صحة الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من Mintegral، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصدرَي الإعلانات Mintegral (عروض الأسعار) وMintegral (العرض بدون انقطاع).

الخطوات الاختيارية

إضافة Mintegral إلى قائمة شركاء الإعلانات بموجب قانون خصوصية المستهلك في كاليفورنيا (CCPA)

اتّبِع الخطوات الواردة في إعدادات قانون خصوصية المستهلك في كاليفورنيا (CCPA) لإضافة Mintegral إلى قائمة الشركاء الإعلانيين بموجب قانون خصوصية المستهلك في كاليفورنيا (CCPA) في واجهة مستخدم "مدير إعلانات Google".

إعلانات مدمجة مع المحتوى

عرض الإعلانات

يعرض محوِّل Mintegral إعلاناته المدمجة مع المحتوى على هيئة عناصر NativeAd. وتعبئ هذه العملية الحقول التالية لجدول NativeAd.

الحقل	مواد العرض التي يتم تضمينها دائمًا من خلال محوِّل Mintegral
العنوان
صورة	1
النص
الرمز
الحث على اتخاذ إجراء
التقييم بالنجوم
المتجر
السعر
المعلِن

¹ لا يقدّم محوِّل Mintegral إمكانية الوصول المباشر إلى مادة عرض الصورة الرئيسية لإعلاناته المدمجة مع المحتوى. بدلاً من ذلك، يملؤه المحوِّل MediaView بفيديو أو صورة.

رموز الخطأ

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

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل Mintegral عند تعذُّر تحميل إعلان:

رمز الخطأ	النطاق	السبب
101	com.google.ads.mediation.mintegral	مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف التطبيق أو رقم تعريف موضع الإعلان)
102	com.google.ads.mediation.mintegral	لا يتطابق حجم الإعلان المطلوب مع حجم البانر المتوافق مع Mintegral.
103	com.google.ads.mediation.mintegral	استجابة عرض السعر غير متوفّرة أو غير صالحة.
104	com.google.ads.mediation.mintegral	عرَضت حزمة SDK من Mintegral خطأً ناتجًا عن عدم ملء المساحة.