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

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

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

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

يتميّز محوّل Ad Manager التوسّط من Google لبرنامج InMobi بالإمكانيات التالية:

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

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

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

المتطلّبات

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

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

الخطوة الأولى: ضبط الإعدادات في واجهة مستخدم 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.0.0")
    implementation("com.google.ads.mediation:inmobi:10.6.7.0")
}

الدمج اليدوي

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

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

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

بموجب سياسة موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها 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: اختبار عملية التنفيذ

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

احرص على تسجيل جهاز الاختبار من أجل 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, extras)
        .build()

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

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

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

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

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

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

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

رموز الخطأ

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

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

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل InMobi عند تعذُّر تحميل الإعلان:

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