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

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

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

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

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

المتطلّبات

  • Unity 4 أو أعلى
  • أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
  • للنشر على Android:
    • المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android
  • للنشر على iOS:
    • هدف نشر iOS هو 10.0 أو أحدث
  • مشروع Unity عملي تم إعداده باستخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على مزيد من التفاصيل.
  • إكمال عملية التوسّط دليل البدء

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

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

عروض الأسعار

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

شلال

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

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

إضافة تطبيق

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

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

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

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

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

Android

للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

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

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

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

نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في InMobi من رابط التنزيل في سجلّ التغييرات واستخرج GoogleMobileAdsInMobiMediation.unitypackage من ملف zip.

في محرر مشروع Unity، حدد Assets >Import Package > Custom Package وحدد الملف GoogleMobileAdsInMobiMediation.unitypackage الذي قمت بتنزيله. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android > فرض الحل. ستنفِّذ مكتبة أداة حلّ المشاكل في Unity Play Services حل التبعية من البداية، وتنسخ التبعيات المُعلَن عنها إلى دليل Assets/Plugins/Android في تطبيق Unity.

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

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

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

using GoogleMobileAds.Api.Mediation.InMobi;
using System.Collections.Generic;
// ...

Dictionary<string, string> consentObject = new Dictionary<string, string>();
consentObject.Add("gdpr_consent_available", "true");
consentObject.Add("gdpr", "1");

InMobi.UpdateGDPRConsent(consentObject);

يمكنك الاطّلاع على تفاصيل تنفيذ اللائحة العامة لحماية البيانات في InMobi للحصول على مزيد من المعلومات عن المفاتيح والقيم المحتملة التي تقبلها InMobi في عنصر الموافقة هذا.

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

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

اطّلِع على مستندات CCPA الخاصة بـ InMobi للحصول على إرشادات حول كيفية تفعيل إعدادات CCPA لبرنامج InMobi.

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

Android

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

iOS

دمج SKAdNetwork

اتّبِع مستندات InMobi لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

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

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

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

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

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

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

Android

الأذونات

للحصول على الأداء الأمثل، تنصح 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" />

يمكنك إضافة هذه الأذونات إلى ملف Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml بشكل اختياري.

iOS

ليس هناك خطوات إضافية مطلوبة لدمج نظام التشغيل iOS.

رموز الخطأ

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

Android

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

iOS

GADMAdapterInMobi
GADMediationAdapterInMobi

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

Android

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

iOS

رمز الخطأ السبب
101 مَعلمات خادم InMobi التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة أو غير صالحة.
102 لا يدعم محوّل InMobi شكل الإعلان المطلوب.
103 سبق أن تم تحميل إعلان InMobi لإعداد الشبكة هذه.
غير ذلك عرضت حزمة تطوير البرامج (SDK) InMobi خطأً. لمزيد من التفاصيل، يمكنك الاطّلاع على IMRequestStatus.h.

سجلّ تغييرات المكوّن الإضافي لتوسّط Unity من InMobi

الإصدار 4.4.1

الإصدار 4.4.0

الإصدار 4.3.3

الإصدار 4.3.0

الإصدار 4.2.2

الإصدار 4.2.1

الإصدار 4.2.0

الإصدار 4.1.0

الإصدار 4.0.4

الإصدار 4.0.3

الإصدار 4.0.2

الإصدار 4.0.1

الإصدار 4.0.0

الإصدار 3.2.0

الإصدار 3.1.2

الإصدار 3.1.1

الإصدار 3.1.0

الإصدار 3.0.3

الإصدار 3.0.2

الإصدار 3.0.1

الإصدار 3.0.0

الإصدار 2.4.0

الإصدار 2.3.0

  • يتوافق الجهاز مع الإصدار 7.2.9.0 من محوّل Android
  • يتوافق مع الإصدار 7.3.2.0 من محوّل نظام التشغيل iOS.

الإصدار 2.2.2

  • تم تحديث المكوّن الإضافي للتوافق مع واجهة برمجة التطبيقات الجديدة التي تضم مكافآت.
  • يتوافق الجهاز مع الإصدار 7.2.7.0 من محوّل Android
  • يتوافق مع الإصدار 7.2.7.0 من محوّل نظام التشغيل iOS.

الإصدار 2.2.1

  • يتوافق الجهاز مع الإصدار 7.2.2.0 من محوّل Android
  • يتوافق مع الإصدار 7.2.4.0 من محوّل نظام التشغيل iOS.

الإصدار 2.2.0

  • يتوافق الجهاز مع الإصدار 7.2.1.0 من محوّل Android
  • يتوافق مع الإصدار 7.2.0.0 من محوّل نظام التشغيل iOS.

الإصدار 2.1.2

  • يتوافق الجهاز مع الإصدار 7.1.1.1 من محوّل Android.
  • يتوافق مع الإصدار 7.1.2.0 من محوّل نظام التشغيل iOS.

الإصدار 2.1.1

  • يتوافق الجهاز مع الإصدار 7.1.1.1 من محوّل Android.
  • يتوافق مع الإصدار 7.1.1.2 من محوّل نظام التشغيل iOS.

الإصدار 2.1.0

  • يتوافق الجهاز مع الإصدار 7.1.0.0 من محوّل Android
  • يتوافق مع الإصدار 7.1.1.1 من محوّل نظام التشغيل iOS.
  • تمت إضافة طريقة InMobi.UpdateGDPRConsent().

الإصدار 2.0.0

  • يتوافق الجهاز مع الإصدار 7.0.4.0 من محوّل Android
  • يتوافق مع الإصدار 7.1.1.0 من محوّل نظام التشغيل iOS.

الإصدار 1.0.0

  • الإصدار الأول
  • يتوافق الجهاز مع الإصدار 6.2.4.0 من محوّل Android.
  • يتوافق مع الإصدار 6.2.1.0 من محوّل نظام التشغيل iOS.