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

دمج InMobi مع ميزة "التوسّط"

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

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

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

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

¹ دمج عروض الأسعار متاح في الإصدار العلني التجريبي.

² لا تتوفّر هذه الميزة إلا للخدمة توسّط العرض الإعلاني بدون انقطاع.

المتطلبات

المستوى 21 أو إصدار أحدث لواجهة برمجة التطبيقات Android

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

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

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

بعد إثبات ملكية حسابك، سجِّل الدخول.

إضافة تطبيق

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

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

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

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

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

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

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

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

بعد إنشاء موضع الإعلان، يتم عرض تفاصيله. سجِّل معرّف موضع الإعلان الذي سيتم استخدامه لإعداد وحدتك الإعلانية في "مدير إعلانات Google".

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

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

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

عروض الأسعار

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

شلال

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

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

عروض الأسعار

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

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

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

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

انقر على تم.

شلال

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

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

عروض الأسعار

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

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

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

شلال

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

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

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

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

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

إضافة InMobi إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية

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

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

دمج "استوديو Android" (إجراء يُنصح به)

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

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

الدمج اليدوي

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

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

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

بموجب سياسة موافقة المستخدِم في الاتّحاد الأوروبي المتّبَعة في Google، عليك التأكّد من تقديم بيانات الإفصاح المعيّنة إلى المستخدِمين في المنطقة الاقتصادية الأوروبية والحصول على موافقاتهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR) في الاتّحاد الأوروبي. عند طلب الموافقة، عليك تحديد كل شبكة إعلانية في سلسلة التوسّط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، و تقديم معلومات عن استخدام كل شبكة. لا يمكن لشركة 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 في الولايات المتحدة من الإعدادات المفضّلة المشتركة. اتّبِع التعليمات الواردة في مستندات قوانين الخصوصية في الولايات الأمريكية لضبط سلسلة الخصوصية في الولايات المتحدة في الإعدادات المفضّلة المشتركة.

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

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

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

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

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

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

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

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

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

الأذونات

للحصول على الأداء الأمثل، تنصح 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` لضبط مستوى التسجيل لحزمة تطوير البرامج (SDK) من InMobi.	`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 على الأجهزة الجوّالة" طلبات إعادة الاتصال لحزمة SDK من InMobi لتتبُّع مرّات الظهور والنقرات، لذا من المفترض أن تتطابق التقارير في لوحتَي البيانات مع اختلافات قليلة أو معدومة.

رموز الخطأ

إذا تعذّر على المُحوِّل تلقّي إعلان من 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.