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

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

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

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

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

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

¹ تم إغلاق عملية دمج عروض الأسعار تجريبي.

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

المتطلبات

المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى

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

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

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

تحديد موقع مفتاح التطبيق

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

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

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

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

دوِّن APP ID لتطبيقك.

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

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

أدخِل اسم موضع الإعلان وشكل الإعلان.

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

عروض الأسعار

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

شلال

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

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

عروض الأسعار

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

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

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

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

انقر على تم.

شلال

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

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

عروض الأسعار

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

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

اختَر وحدة إعلانية معيَّنة. اختر وحدة إعلانية شكلاً، وتطبيق للأجهزة الجوّالة كنوع المستودع، ثم تطبيق الأجهزة الجوّالة. بعد ذلك، أدخِل App Key, App ID, Placement ID, and Ad Unit ID الذي تم الحصول عليه في القسم السابق. وأخيرًا، انقر على حفظ.

شلال

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

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

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

أدخِل القيمة App Key, App ID, Placement ID, and Ad Unit ID التي تم الحصول عليها في القسم السابق، وقيمة التكلفة التلقائية لكل ألف ظهور. انقر على حفظ.

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

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

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

الدمج اليدوي

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

الخطوة 4: تنفيذ إعدادات الخصوصية على Mintegral SDK

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

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

تتضمّن حزمة تطوير البرامج من Mintegral طريقة "setConsentStatus" لتمرير الموافقة. بشكل أفضل إلى Mintegral SDK.

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

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 تطبيق هذا الإعداد على كل إعلان الشبكة في سلسلة التوسط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسط التي قد تشارك في بيع البضائع المعلومات واتباع الإرشادات من كل شبكة من تلك الشبكات للتأكد الامتثال.

تتضمّن حزمة تطوير البرامج من Mintegral طريقة واحدة (setDoNotTrackStatus) لتمرير الموافقة. بشكل أفضل إلى Mintegral SDK.

يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة إلى Mintegral. SDK. إذا أردت استدعاء هذه الطريقة، عليك تسميتها بعد إعداد حزمة "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: اختبار عملية التنفيذ

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

احرص على تسجيل جهاز الاختبار من أجل Ad Manager.

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

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

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

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

إضافة 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	عرَ�� Mintegral SDK خطأ "��لا تعبئة".
101	com.google.mediation.mintegral	مَعلمات الخادم غير صالحة (على سبيل المثال، رقم تعريف التطبيق أو رقم تعريف موضع الإعلان غير متوفّر)
102	com.google.mediation.mintegral	عرَضَ Mintegral SDK خطأ "بلا تعبئة".
103	com.google.mediation.mintegral	تعذّر على Mintegral SDK عرض إعلان.
104	com.google.mediation.mintegral	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق من Mintegral.