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

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

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

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

يوفّر Ad Manager محوّل التوسّط لـ 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 على مستوى التطبيق، أضِف تبعيات التنفيذ وإعداداته التالية. استخدم أحدث إصدارات من Mintegral SDK ومحوّل:

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

الدمج اليدوي

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

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

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

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

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

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

يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة إلى حزمة تطوير البرامج (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: اختبار عملية التنفيذ

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

احرص على تسجيل جهاز الاختبار من أجل 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.getAdapterResponse() ضمن الفئات التالية:

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.