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

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

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

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

المتطلبات

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

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

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

بعد تأكيد حسابك، سجِّل الدخول.

إضافة تطبيق

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

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت InMobi Mediation Plugin for Google Mobile Ads في مشروعك على Unity من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

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

OpenUPM

في أداة تعديل مشروع Unity، اختَر تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحِزم (Package Manager) لفتح إعدادات إدارة حِزم Unity (Unity Package Manager Settings).

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

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

تفاصيل OpenUPM

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

Unity Registries

اختَر حزمة 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 (Android Resolver) > فرض الحلّ (Force Resolve). ستنفّذ مكتبة External Dependency Manager عملية تحديد العناصر التابعة من البداية، وستنسخ العناصر التابعة المحدّدة إلى الدليل Assets/Plugins/Android في تطبيق Unity.

فرض الحل

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

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

أضاف المكوّن الإضافي للتوسّط في "إعلانات Google على الأجهزة الجوّالة" لـ InMobi الإصدار 2.1.0 الطريقة 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: اختبار عملية التنفيذ

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

تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات" وتفعيل وضع الاختبار في واجهة مستخدم 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 Adapter مع شكل الإعلان المطلوب.
103 تم تحميل إعلان InMobi مسبقًا لإعدادات الشبكة هذه.
غير ذلك عرَض حزمة تطوير البرامج (SDK) من InMobi خطأً. يمكنك الاطّلاع على IMRequestStatus.h لمزيد من التفاصيل.

سجلّ تغييرات إضافة InMobi Unity Mediation

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