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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

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

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

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

  • أحدث إصدار من Google Mobile Ads Unity Plugin
  • الإصدار 4 أو إصدار أحدث من Unity Editor
  • [لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" للإصدار 4.5.0 من InMobi أو إصدار أحدث (يُنصح باستخدام أحدث إصدار).
  • للنشر على أجهزة Android
    • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
  • للنشر على أجهزة iOS
    • هدف نشر iOS‏ 10.0 أو إصدار أحدث
  • مشروع Unity قيد العمل تم إعداده باستخدام Google Mobile Ads Unity Plugin لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Unity Plugin.
  • إعداد التوسّط

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

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

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

    إضافة تطبيق

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

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

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

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

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

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

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

    عروض الأسعار

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

    شلال

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

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

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

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

    العثور على مفتاح Reporting API في InMobi

    عروض الأسعار

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

    شلال

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

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

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

    تعديل ملف app-ads.txt

    مبادرة "البائعون المعتمَدون للتطبيقات" (app-ads.txt) هي مبادرة من "المختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقاتك إلا من خلال القنوات التي حدّدتها على أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم تكن قد فعلت ذلك، أنشئ ملف app-ads.txt في "إدارة إعلانات Google".

    لتنفيذ app-ads.txt لشبكة InMobi، أضِف مقتطف الرمز المخصّص.

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

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

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

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

    Android

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

    iOS

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

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

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

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

    OpenUPM-CLI

    إذا كان لديك OpenUPM-CLI مثبّتًا، يمكنك تثبيت المكوّن الإضافي لتوسّط InMobi في "إعلانات Google على الأجهزة الجوّالة" لـ Unity في مشروعك من خلال تشغيل الأمر التالي من الدليل الجذري لمشروعك:

    openupm add com.google.ads.mobile.mediation.inmobi

    OpenUPM

    في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > أداة إدارة الحِزم لفتح إعدادات أداة إدارة حِزم Unity.

    ضمن علامة التبويب Scoped Registries، أضِف OpenUPM كسجلّ نطاق باستخدام التفاصيل التالية:

    • الاسم: OpenUPM
    • عنوان URL: https://package.openupm.com
    • النطاقات: com.google

    تفاصيل‫ OpenUPM

    بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager (إدارة حِزم Unity)، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.

    Unityمستودعات ‫

    اختَر حزمة Google Mobile Ads InMobi Mediation وانقر على تثبيت.

    التثبيت من‫ OpenUPM

    حزمة Unity

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

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

    الاستيراد من‫ Unity

    بعد ذلك، اختَر الأصول (Assets) > أداة إدارة التبعيات الخارجية (External Dependency Manager) > Android Resolver > فرض الحل (Force Resolve). ستعمل مكتبة External Dependency Manager على حلّ التبعيات من البداية ونسخ التبعيات المُعلَن عنها إلى دليل Assets/Plugins/Android في تطبيق Unity.

    فرض الحلّ

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

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

    بدءًا من الإصدار 4.6.4 من المكوّن الإضافي للتوسّط في InMobi Unity، تقرأ InMobi تلقائيًا موافقة بموجب اللائحة العامة لحماية البيانات (GDPR) التي تم ضبطها من خلال منصات إدارة الموافقة المتوافقة مع مواصفات "الموافقة الإضافية" من Google، بما في ذلك حزمة تطوير البرامج لمنصة UMP. لمزيد من المعلومات، راجِع مستندات InMobi حول إعداد حزمة تطوير البرامج (SDK) لنظامَي التشغيل Android وiOS.

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

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

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

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

    Android

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

    iOS

    دمج SKAdNetwork

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

    الخطوة 6: اختبار عملية الإعداد

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

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

    تأكيد الإعلانات الاختبارية

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

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

    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 أخطاء حزمة تطوير البرامج (SDK) في InMobi يمكنك الاطّلاع على الرمز لمزيد من التفاصيل.
    100 مَعلمات خادم InMobi التي تم ضبطها في واجهة مستخدم "مدير إعلانات Google" غير متوفّرة أو غير صالحة.
    101 تعذّر إعداد حزمة تطوير البرامج (SDK) لمنصة InMobi.
    102 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع InMobi.
    103 طلب عرض الإعلان ليس طلبًا موحّدًا لعرض "إعلان مدمج مع المحتوى".
    104 تمت محاولة طلب إعلان من InMobi بدون إعداد حزمة تطوير البرامج (SDK) الخاصة بـ InMobi. من المفترض ألا يحدث ذلك من الناحية النظرية لأنّ المحوّل يبدأ حزمة تطوير البرامج (SDK) لـ InMobi قبل طلب إعلانات InMobi.
    105 إعلان InMobi ليس جاهزًا للعرض بعد.
    106 تعذّر على InMobi عرض إعلان.
    107 عرضت InMobi إعلانًا مدمجًا مع المحتوى لا يتضمّن مادة عرض مطلوبة.
    108 تحتوي مواد عرض الصور للإعلانات المدمجة مع المحتوى من InMobi على عنوان URL غير صالح.
    109 تعذّر على أداة الربط تنزيل مواد عرض الصور للإعلانات المدمجة مع المحتوى من InMobi.

    iOS

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

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

    الإصدار 5.4.0 (قيد التطوير)

    الإصدار 5.3.3

    الإصدار 5.3.2

    الإصدار 5.3.1

    الإصدار 5.3.0

    الإصدار 5.2.0

    الإصدار 5.1.0

    الإصدار 5.0.2

    الإصدار 5.0.1

    الإصدار 5.0.0

    الإصدار 4.7.7

    الإصدار 4.7.6

    الإصدار 4.7.5

    الإصدار 4.7.4

    الإصدار 4.7.3

    الإصدار 4.7.2

    الإصدار 4.7.1

    الإصدار 4.7.0

    الإصدار 4.6.7

    الإصدار 4.6.6

    الإصدار 4.6.5

    الإصدار 4.6.4

    الإصدار 4.6.3

    الإصدار 4.6.2

    الإصدار 4.6.1

    الإصدار 4.6.0

    الإصدار 4.5.1

    الإصدار 4.5.0

    الإصدار 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.