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

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

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

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

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

المتطلبات

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

الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم 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، اختَر مواد العرض >. استيراد الحزمة > مُخَصَّصْ الحزمة واختَر الملف GoogleMobileAdsInMobiMediation.unitypackage الذي تريد تم تنزيله. تأكَّد من اختيار كل الملفات وانقر على استيراد.

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

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

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

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

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

Android

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

iOS

دمج SKAdNetwork

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

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

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

  • يتوافق مع الإصدار 7.2.9.0 من محوّل Android.
  • يتوافق مع الإصدار 7.3.2.0 من محوّل iOS.

الإصدار 2.2.2

  • تم تحديث المكوّن الإضافي لإتاحة Bonus API الجديدة.
  • يتوافق مع الإصدار 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.

الإصدار

  • يتوافق مع الإصدار 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.