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

دمج InMobi مع التوسط

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

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

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

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

¹ تم إغلاق عملية دمج عروض الأسعار. تجريبيًا، يُرجى التواصل مع مدير حسابك لطلب الإذن بالوصول.

² متاحة فقط مع توسّط العرض الإعلاني بدون انقطاع

المتطلبات

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

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

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

اشترِك للحصول على حساب InMobi.

عروض الأسعار

اختر استخدام InMobi SSP مع عرض الأسعار المفتوح من Google وأدخِل الرقم التعريفي للناشر في Google.

شلال

ليس عليك اتّخاذ أي خطوة إضافية لعمليات دمج العرض الإعلاني بدون انقطاع.

سجِّل الدخول إلى حسابك على InMobi بعد إثبات ملكيته.

إضافة تطبيق

لإضافة تطبيقك إلى لوحة بيانات InMobi، انقر على المستودع > إعدادات المستودع.

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

ابدأ بكتابة عنوان URL لمتجر التطبيقات المنشور في شريط البحث واختَر التطبيق من النتائج التي تتم تعبئتها تلقائيًا. انقر على متابعة

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

راجع إعدادات الامتثال للتطبيقات والمواقع الإلكترونية، ثم انقر على حفظ وإنشاء مواضع إعلان.

مواضع الإعلانات

بعد إعداد المستودع، يُعيد النظام توجيهك إلى سير عمل إنشاء موضع الإعلان.

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

وبعد إنشاء موضع الإعلان، تظهر تفاصيله. دوِّن رقم تعريف موضع الإعلان الذي سيُستخدَم لإعداد Ad Manager وحدتك الإعلانية.

رقم تعريف الحساب

ويتوفر رقم تعريف حسابك على InMobi ضمن الشؤون المالية > إعدادات الدفع > معلومات الدفع.

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

انتقل إلى حسابي > إعدادات الحساب. انتقِل إلى علامة التبويب مفتاح واجهة برمجة التطبيقات وانقر على إنشاء مفتاح واجهة برمجة التطبيقات.

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

لن يتمكن أحد سوى مشرف الحساب من إنشاء مفتاح واجهة برمجة التطبيقات لجميع المستخدمين. إذا نسيت مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه سابقًا، يمكنك إعادة ضبط مفتاح واجهة برمجة التطبيقات من خلال التمرير فوق بريدك في علامة التبويب مفتاح واجهة برمجة التطبيقات.

تفعيل وضع الاختبار

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

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

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

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

عروض الأسعار

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

شلال

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

اختَر InMobi باعتبارها شبكة الإعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط. فعِّل خيار الجمع التلقائي للبيانات، وأدخِل Username and API Key الذي تم الحصول عليه في القسم السابق.

بعد ذلك، أدخِل اسم المستخدم وانقر على حفظ عند الانتهاء.

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

عروض الأسعار

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

شلال

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

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

عروض الأسعار

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

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

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

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

انقر على تم.

شلال

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

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

عروض الأسعار

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

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

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

شلال

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

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

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

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

ملاحظة: يستغرق جمع البيانات تلقائيًا بضعة أيام قبل أن يتمكّن من حساب قيمة التكلفة لكل ألف ظهور الديناميكية لشبكة التوسط بدقة. بعد احتساب التكلفة الفعلية لكل ألف ظهور، يتم تعديلها تلقائيًا نيابةً عنك.

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

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

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

الدمج مع "استوديو Android" (يُنصح به)

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:inmobi:10.7.5.0")
}

الدمج اليدوي

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

الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة InMobi SDK

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

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

في الإصدار 7.1.0.0، أضاف محوّل InMobi InMobiConsentclass that lets you pass consent information to InMobi. The following sample code callsupdateGDPRConsent() ` إلى فئة InMobiConsent. إذا اخترت الاتصال بهذا الاسم ننصحك بإجراء ذلك قبل طلب الإعلانات من خلال SDK لإعلانات Google على الأجهزة الجوّالة.

Java

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  exception.printStackTrace();
}

InMobiConsent.updateGDPRConsent(consentObject);

Kotlin

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  exception.printStackTrace()
}

InMobiConsent.updateGDPRConsent(consentObject)

عرض تفاصيل تنفيذ اللائحة العامة لحماية البيانات في InMobi لمزيد من المعلومات عن المفاتيح والقيم المحتملة التي تقبلها InMobi عنصر الموافقة هذا

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

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

في الإصدار 10.5.7.1, أضاف محوّل InMobi دعمًا لقراءة سلسلة الخصوصية في الولايات المتحدة الصادرة عن مكتب الإعلانات التفاعلية (IAB) من التفضيلات المشتركة. اتّبِع التعليمات الواردة في الولايات المتحدة التي تنصّ على مستندات قوانين الخصوصية لضبط سلسلة إشارات الخصوصية في الولايات المتحدة الأمريكية التفضيلات المشتركة.

بالإضافة إلى ذلك، راجع InMobi مستندات قانون خصوصية المستهلك في كاليفورنيا (CCPA) للحصول على إرشادات حول كيفية تفعيل إعدادات قانون خصوصية المستهلك في كاليفورنيا (CCPA) في لوحة بيانات InMobi.

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

وليس عليك استخدام رمز إضافي لدمج InMobi.

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

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

احرص على تسجيل جهاز الاختبار من أجل Ad Manager وتفعيل وضع الاختبار في واجهة المستخدم InMobi .

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

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

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

الأذونات

للحصول على الأداء الأمثل، تقترح InMobi إضافة العنصر الاختياري التالي الأذونات لملف AndroidManifest.xml في تطبيقك.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

المَعلمات الخاصة بالشبكة

يتوافق محوّل InMobi مع معلَمات طلب إضافية يمكن تمريرها إلى المحوِّل كحزمة Android. يبحث المحوّل عن المفاتيح التالية في الحزمة:

طلب المعلَمات والقيم
`InMobiNetworkKeys.AGE_GROUP` الفئة العمرية للمستخدم	`InMobiNetworkValues.BELOW_18` `InMobiNetworkValues.BETWEEN_18_AND_24` `InMobiNetworkValues.BETWEEN_25_AND_29` `InMobiNetworkValues.BETWEEN_30_AND_34` `InMobiNetworkValues.BETWEEN_35_AND_44` `InMobiNetworkValues.BETWEEN_45_AND_54` `InMobiNetworkValues.BETWEEN_55_AND_65` `InMobiNetworkValues.ABOVE_65`
`InMobiNetworkKeys.EDUCATION` المستوى التعليمي للمستخدم:	`InMobiNetworkValues.EDUCATION_HIGHSCHOOLORLESS` `InMobiNetworkValues.EDUCATION_COLLEGEORGRADUATE` `InMobiNetworkValues.EDUCATION_POSTGRADUATEORABOVE`
`InMobiNetworkKeys.AGE`	سلسلة: عمر المستخدم
`InMobiNetworkKeys.POSTAL_CODE`	سلسلة: الرمز البريدي للمستخدِم (يتكوّن عادةً من خمسة أرقام)
`InMobiNetworkKeys.AREA_CODE`	سلسلة: رمز منطقة المستخدم (الجزء من رقم الهاتف)
`InMobiNetworkKeys.LANGUAGE`	سلسلة: مسئولية المستخدم اللغة الأم (إذا كانت معروفة).
`InMobiNetworkKeys.CITY`	سلسلة: مدينة المستخدم
`InMobiNetworkKeys.STATE`	سلسلة: حالة المستخدم
`InMobiNetworkKeys.COUNTRY`	سلسلة: بلد المستخدم
`InMobiNetworkKeys.LOGLEVEL` تضبط مستوى السجلّ لحزمة InMobi SDK.	`InMobiNetworkValues.LOGLEVEL_NONE` `InMobiNetworkValues.LOGLEVEL_DEBUG` `InMobiNetworkValues.LOGLEVEL_ERROR`

في ما يلي مثال على رمز برمجي يوضّح كيفية ضبط مَعلمات طلب الإعلان:

Java

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_54);
extras.putString(InMobiNetworkKeys.AREA_CODE, "12345");

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(InMobiAdapter.class, extras)
   .build();

Kotlin

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_54)
extras.putString(InMobiNetworkKeys.AREA_CODE, "12345")

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

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

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

يعرض محوّل InMobi إعلاناته المدمجة مع المحتوى في شكل NativeAd الأخرى. يملأ ما يلي الحقول لمدة NativeAd

الحقل	يتم دائمًا تضمين مواد العرض في محوّل InMobi.
العنوان
صورة	1
عرض الوسائط
النص الأساسي
رمز التطبيق
الحث على اتخاذ إجراء
التقييم النجمي
المتجر
السعر

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

تتبُّع مرّات الظهور والنقرات

تستخدم حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" استدعاءات حزمة InMobi SDK لقياس مرات الظهور لتتبُّع النقرات، لذلك يجب أن تتطابق التقارير في كلتا لوحتَي البيانات مع عدد قليل أو لا والتباينات.

رموز الخطأ

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

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل InMobi عند فشل تحميل إعلان:

رمز الخطأ	السبب
0-99	أخطاء حزمة تطوير البرامج (SDK) في InMobi راجِع الرمز لمزيد من التفاصيل.
100	معلَمات خادم InMobi التي تم ضبطها في واجهة المستخدم Ad Manager غير متوفّرة أو غير صالحة.
101	تعذّر إعداد حزمة تطوير البرامج (SDK) لـ InMobi.
102	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع InMobi.
103	طلب الإعلان ليس طلب إعلان مدمج مع المحتوى موحد.
104	تمت محاولة طلب إعلان InMobi بدون إعداد حزمة تطوير البرامج (SDK) في InMobi. هذا النمط من الناحية النظرية، بما أنّ المحوّل يعمل على إعداد حزمة تطوير البرامج (SDK) لـ InMobi قبل طلب إعلانات InMobi.
105	إعلان InMobi ليس جاهزًا بعد للعرض.
106	تعذّر على InMobi عرض إعلان.
107	عرَضَ InMobi إعلانًا مدمجًا مع المحتوى لا يتضمّن مادة عرض مطلوبة.
108	تحتوي مواد عرض صور الإعلانات المدمجة مع المحتوى في InMobi على عنوان URL مكتوب بشكلٍ غير صحيح.
109	تعذّر على المحوّل تنزيل مواد عرض صور الإعلانات المدمجة مع المحتوى في InMobi.
101	معلَمات خادم InMobi التي تم ضبطها في واجهة المستخدم Ad Manager غير متوفّرة أو غير صالحة.
102	لا يتيح محوّل InMobi استخدام شكل الإعلان المطلوب.
103	سبق أن تم تحميل إعلان InMobi لإعداد الشبكة هذه.
غير ذلك	عرَضَ InMobi SDK خطأً. لمزيد من التفاصيل، يُرجى الانتقال إلى `IMRequestStatus.h`.