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

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

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

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

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

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

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

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

المتطلبات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

عروض الأسعار

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

شلال

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

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

عروض الأسعار

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

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

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

انقر على متابعة.

انقر على تم.

شلال

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

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

عروض الأسعار

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

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

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

شلال

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

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

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

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

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

اتّبِع الخطوات الواردة في إعدادات "اللائحة العامّة لحماية البيانات" (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: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: اختبار عملية التنفيذ

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

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

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

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

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

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

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

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

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

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

يعرض محوِّل 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