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

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

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

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

1 دمج عروض الأسعار متاح في الإصدار العلني التجريبي.

المتطلبات

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

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

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

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

إضافة تطبيق

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

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

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

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى النافذة > مدير الحِزم لفتح مدير حِزم Unity و اختَر السجلّات الخاصة بي من القائمة المنسدلة.

سجلات Unity

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

التثبيت من OpenUPM

حزمة Unity

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

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

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

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

حلّ المشاكل بالقوة

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

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

أضاف المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" لإصدار InMobi 2.1.0 طريقة InMobi.UpdateGDPRConsent() التي تتيح لك تمرير معلومات الموافقة إلى InMobi. يوضّح الرمز البرمجي النموذجي التالي كيفية تمرير معلومات الموافقة إلى IDE 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 لقانون الخدمات الرقمية في الأسواق (GDPR) لمزيد من المعلومات عن المفاتيح والقِيم المحتمَلة التي تقبلها InMobi في عنصر الموافقة هذا.

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

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

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

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

Android

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

iOS

دمج SKAdNetwork

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

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

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

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

سجلّ التغييرات في مكوّن InMobi Unity Mediation Plugin

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