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

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

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

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

يوفّر محوّل توسط Google AdMob لتطبيق InMobi الإمكانيات التالية:

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

المتطلّبات

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

أحدث حزمة SDK لإعلانات Google على الجوال

الخطوة 1: إعداد InMobi

اشترك أو سجّل الدخول إلى حسابك في InMobi.

إضافة تطبيق

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

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

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

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

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

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

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

حدد بانر كنوع وانقر على إضافة موضع. ثم أدخل اسم الموضع. انقر على الزر إنشاء موضع عند الانتهاء.

إعلان بيني

حدد إعلان بيني كنوع وانقر على إضافة موضع. ثم أدخل اسم الموضع. انقر على الزر إنشاء موضع عند الانتهاء.

تم منح المكافأة

حدد مكافأة على أنها النوع وانقر على إضافة موضع. ثم أدخل اسم الموضع. انقر على الزر إنشاء موضع عند الانتهاء.

مدمجة مع المحتوى

حدد مدمج مع المحتوى على أنه النوع وانقر على إضافة موضع. ثم أدخل اسم الموضع. انقر على الزر إنشاء موضع عند الانتهاء.

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

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

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

مفتاح واجهة برمجة التطبيقات

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

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

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

الخطوة 2: ضبط إعدادات التوسّط AdMob لوحدتك الإعلانية

يلزمك إضافة InMobi إلى تهيئة التوسط لوحدتك الإعلانية. أولاً، سجّل الدخول إلى حسابك في AdMob.

انتقل إلى علامة التبويب "التوسط". إذا كانت لديك مجموعة توسط حالية ترغب في تعديلها، فانقر على اسم مجموعة التوسط هذه لتعديلها، وتخطى ذلك إلى إضافة inMobi كمصدر إعلاني.

لإنشاء مجموعة توسط جديدة، اختر إنشاء مجموعة توسط.

اختَر شكل الإعلان والنظام الأساسي، ثم انقر على متابعة.

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

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

من المفترض أن تشاهد الآن بطاقة الوحدات الإعلانية التي تمت تعبئتها بالوحدات الإعلانية التي حدّدتها، كما هو موضّح أدناه:

إضافة InMobi كمصدر إعلاني

في بطاقة مصادر الإعلانات، اختَر إضافة شبكة إعلانات.

اختَر InMobi وفعِّل مفتاح Optimize. أدخل اسم تسجيل الدخول ومفتاح واجهة برمجة التطبيقات مع حقول اسم المستخدم ومفتاح واجهة برمجة التطبيقات التي تم الحصول عليها في القسم السابق لإعداد تحسين مصدر الإعلان لـ InMobi. بعد ذلك، أدخل قيمة eCPM لـ inmobi وانقر على Continue (متابعة).

أدخل رقم تعريف الحساب ورقم تعريف الموضع اللذين تم الحصول عليهما في القسم السابق.

استخدام الإعلانات بمكافأة

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

إذا لم يتم تطبيق هذا الإعداد، فسيعيد محول InMobi المكافأة المحددة في لوحة تحكم InMobi عند إنشاء الموضع. لمزيد من المعلومات عن إعداد قيم المكافآت للوحدات الإعلانية في AdMob، يُرجى الاطّلاع على إنشاء وحدة إعلانية.

الخطوة 3: استيراد InInbi SDK ومهايئ

دمج "استوديو Android" (موصى به)

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

repositories {
    google()
    mavenCentral()
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:21.5.0'
    implementation 'com.google.ads.mediation:inmobi:10.1.2.1'
}
...

الدمج اليدوي

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

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

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

الخطوة 5: اختبار التنفيذ

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

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

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

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

في الإصدار 7.1.0.0، أضاف محول InMobi الفئة InMobiConsent التي تتيح لك تمرير معلومات الموافقة إلى InMobi. يطلب نموذج الرمز التالي updateGDPRConsent() في الصف 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 في كائن الموافقة هذا.

إضافة InMobi إلى قائمة شركاء الإعلانات باللائحة العامة لحماية البيانات

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

قانون خصوصية المستهلك في كاليفورنيا (CCPA)

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

راجع مستندات قانون خصوصية المستهلك في كاليفورنيا (CCPA) الخاصة بـ InMobi للحصول على إرشادات حول كيفية تفعيل إعدادات قانون خصوصية المستهلك في كاليفورنيا (CCPA) لـ 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` يضبط مستوى السجل لـ 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");
...
AdRequest request = new AdRequest.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 = AdRequest.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 التي تم ضبطها في AdMob واجهة المستخدم مفقودة/غير صالحة.
101	تعذّر إعداد حزمة InMobi SDK.
102	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع InMobi.
103	لا يُعد طلب الإعلان طلبًا موحدًا للإعلان المدمج مع المحتوى.
104	تمت محاولة طلب إعلان InMobi بدون إعداد حزمة InMobi SDK. من المفترض ألّا يحدث ذلك نظريًا لأنّ المحوّل قد أعدّ حزمة InMobi SDK قبل طلب إعلانات InMobi.
105	إعلان InMobi غير جاهز للعرض بعد.
106	فشل InMobi في عرض إعلان.
107	عرض InMobi إعلانًا مدمجًا مع المحتوى يفتقد إلى مادة عرض مطلوبة.
108	تحتوي مواد عرض صور الإعلانات المدمجة مع المحتوى في InMobi على عنوان URL غير صحيح.
109	أخفق المحول في تنزيل أصول صورة الإعلان المدمج مع InMobi.
101	معلمات خادم InMobi التي تم ضبطها في AdMob واجهة المستخدم مفقودة/غير صالحة.
102	مهايئ InMobi غير متوافق مع شكل الإعلان المطلوب.
103	تم بالفعل تحميل إعلان InMobi لتهيئة الشبكة هذه.
غير ذلك	عرض InMobi SDK خطأ. لمزيد من التفاصيل، يُرجى الاطّلاع على `IMRequestStatus.h`.