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

دمج Mintegral مع التوسّط

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

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

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

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

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

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

المتطلبات

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

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

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

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

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

عليك إضافة Mintegral إلى إعدادات التوسّط لوحدتك الإعلانية.

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

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

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

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

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

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

إضافة Mintegral كمصدر إعلان

عروض الأسعار

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

انقر على الإقرار والموافقة، ثم انقر على متابعة.

إذا كان لديك تعيين حالي لخدمة Mintegral، يمكنك اختياره. بخلاف ذلك، انقر على إضافة تعيين.

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

شلال

ضمن بطاقة العرض بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، اختَر Mintegral.

اختَر Mintegral. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور للخدمة Mintegral وانقر على متابعة.

إذا كان لديك تعيين للخدمة Mintegral، يمكنك اختياره. بخلاف ذلك، انقر على إضافة تعيين.

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

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

الخطوة 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:23.6.0")
    implementation("com.google.ads.mediation:mintegral:16.8.61.0")
}

الدمج اليدوي

لتضمين حزمة تطوير البرامج (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

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

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

Kotlin

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

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

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

Kotlin

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يعرض محوِّل 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 خطأً يفيد بأنّه لم تتم التعبئة.

سجلّ التغييرات في أداة Mintegral Android Mediation Adapter