يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads Unity Plugin من أجل تحميل الإعلانات وعرضها من i-mobile باستخدام التوسّط، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة i-mobile إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل i-mobile في تطبيق Unity.
تستخدم واجهة لوحة البيانات في i-mobile نصًا يابانيًا للتصنيفات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة في هذا الدليل. في المقابل، يتم في أوصاف هذا الدليل وتعليماته الإشارة إلى التصنيفات والأزرار باستخدام ما يعادلها باللغة الإنجليزية بين قوسين.
عمليات الدمج وأشكال الإعلانات المتوافقة
يتضمّن محوّل التوسّط في "مدير إعلانات Google" لمنصّة i-mobile الإمكانات التالية:
| التكامل | |
|---|---|
| عروض الأسعار | |
| عرض إعلاني بدون انقطاع | |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| تمت المكافأة | |
المتطلبات
- أحدث محتوى من قناة Google Mobile Ads Unity Plugin
- Unity 5.6 أو إصدار أحدث
- للنشر على Android
- مستوى واجهة برمجة التطبيقات Android 23 أو مستوى أعلى
- للنشر على أجهزة iOS، اتّبِع الخطوات التالية:
- الإصدار المستهدف من نظام التشغيل iOS هو 13.0 أو إصدار أحدث
- يجب أن يكون لديك مشروع Unity يعمل وتم إعداده باستخدام Google Mobile Ads Unity Plugin. راجِع مقالة إعداد Google Mobile Ads Unity Plugin لمعرفة التفاصيل.
- إعداد التوسّط
الخطوة 1: إعداد الإعدادات في واجهة مستخدم i-mobile
اشترِك أو سجِّل الدخول إلى حسابك على i-mobile.
أضِف تطبيقك إلى لوحة بيانات i-mobile من خلال النقر على علامة التبويب サイト／アプリ管理 (إدارة المواقع الإلكترونية/التطبيقات) والزر الخاص بمنصة تطبيقك.
Android
iOS
املأ النموذج وانقر على الزر 新規登録 (اشتراك).
Android
iOS
لإنشاء موضع إعلاني جديد، اختَر تطبيقك ضمن علامة التبويب サイト／アプリ管理 (إدارة المواقع الإلكترونية/التطبيقات).
Android
iOS
انتقِل إلى علامة التبويب 広告スポット管理 (إدارة مواضع الإعلانات) وانقر على الزر 新規広告スポット (موضع إعلان جديد).
بعد ذلك، املأ النموذج من خلال تقديم 広告スポット名 (اسم موضع الإعلان) و広告スポットサイズ (حجم موضع الإعلان) وتفاصيل أخرى، ثم انقر على الزر 新規登録 (اشتراك).
مساحة الإعلان الجديدة جاهزة. لعرض تفاصيل الدمج، انقر على الزر アプリ設定取得 (الحصول على إعدادات التطبيق).
دوِّن パブリッシャーID (Publisher ID) وメディアID (Media ID) وスポットID (Spot ID)، لأنّك ستحتاج إلى هذه المَعلمات لاحقًا عند إعداد i-mobile للتوسّط في واجهة مستخدم "مدير إعلانات Google".
Android
iOS
تعديل ملف app-ads.txt
مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع مساحات إعلانية متاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. ولمنع حدوث خسارة كبيرة في إيرادات الإعلانات، عليك تنفيذ ملف app-ads.txt.
إذا لم يسبق لك إجراء ذلك،
أنشئ ملف app-ads.txt في "إدارة الإعلانات".
لتنفيذ app-ads.txt في i-mobile، يُرجى الاطّلاع على الأسئلة الشائعة.
الخطوة 2: إعداد طلب i-mobile في واجهة مستخدم "إدارة الإعلانات"
ضبط إعدادات التوسّط للوحدة الإعلانية
Android
للحصول على التعليمات، راجِع الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوّل i-mobile
OpenUPM-CLI
إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت Google Mobile Ads i-mobile Mediation Plugin for Unity في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:
openupm add com.google.ads.mobile.mediation.imobileOpenUPM
في محرِّر مشروع Unity، انقر على تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحِزم (Package Manager) لفتح إعدادات إدارة حِزم Unity (Unity Package Manager Settings).
ضمن علامة التبويب المستودعات المسجّلة ذات النطاق المحدود، أضِف OpenUPM كمستودع مسجّل ذي نطاق محدود مع التفاصيل التالية:
- الاسم:
OpenUPM - عنوان URL:
https://package.openupm.com - النطاقات:
com.google
بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager (إدارة حِزم Unity)، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.
اختَر حزمة Google Mobile Ads IMobile Mediation وانقر على تثبيت.
Unity Package
نزِّل أحدث إصدار من المكوّن الإضافي للتوسّط في "إعلانات Google على الأجهزة الجوّالة" لمنصة i-mobile من رابط التنزيل في سجلّ التغيير، واستخرِج GoogleMobileAdsIMobileMediation.unitypackage من ملف ZIP.
في أداة تعديل مشروع Unity، انقر على Assets > Import Package > Custom Package وابحث عن ملف GoogleMobileAdsIMobileMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.
بعد ذلك، اختَر مواد العرض (Assets) > أداة إدارة التبعيات الخارجية (External Dependency Manager) > أداة حلّ المشاكل في Android (Android Resolver) > فرض الحلّ (Force Resolve). ستنفّذ مكتبة "أداة إدارة التبعيات الخارجية" عملية حلّ التبعيات من البداية وستنسخ التبعيات المحدّدة إلى الدليل Assets/Plugins/Android في تطبيق Unity.
الخطوة 4: يلزم توفّر رمز إضافي
Android
لا يلزم توفير أي رمز إضافي لدمج i-mobile.
iOS
تكامل SKAdNetwork
اتّبِع مستندات i-mobile
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 5: اختبار عملية الإعداد
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات". توفّر i-mobile معرّف المكان ومعرّف الوسائط والرقم التعريفي للناشر للاختبار، ويمكنك العثور عليها هنا.
تأكيد الإعلانات الاختبارية
للتأكّد من تلقّي إعلانات اختبارية من i-mobile، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات i-mobile (نظام العرض بدون انقطاع).
رموز الخطأ
إذا لم يتمكّن المحوّل من تلقّي إعلان من i-mobile، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo
ضمن الفئات التالية:
Android
| التنسيق | اسم الصف |
|---|---|
| بانر | com.google.ads.mediation.imobile.IMobileAdapter |
| إعلان بيني | com.google.ads.mediation.imobile.IMobileAdapter |
| مدمج مع المحتوى | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
| التنسيق | اسم الصف |
|---|---|
| بانر | IMobileAdapter |
| إعلان بيني | IMobileAdapter |
| مدمج مع المحتوى | GADMediationAdapterIMobile |
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل i-mobile عندما يتعذّر تحميل إعلان:
Android
| رمز الخطأ | السبب |
|---|---|
| 0-99 | عرضت حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile خطأً. يمكنك الاطّلاع على الرمز لمزيد من التفاصيل. |
| 101 | يتطلّب i-mobile توفّر Activity سياق لتحميل الإعلانات. |
| 102 | مَعلمات خادم i-mobile التي تم ضبطها في واجهة مستخدم "مدير إعلانات Google" غير متوفّرة أو غير صالحة. |
| 103 | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع i-mobile. |
| 104 | أرجعت دالة الاستدعاء المتعلّقة بنجاح تحميل الإعلانات المدمجة في i-mobile قائمة فارغة بالإعلانات المدمجة. |
iOS
| رمز الخطأ | السبب |
|---|---|
| 0-10 | عرضت حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile خطأً. اطّلِع على الرمز لمزيد من التفاصيل. |
| 101 | مَعلمات خادم i-mobile التي تم ضبطها في واجهة مستخدم "مدير إعلانات Google" غير متوفّرة أو غير صالحة. |
| 102 | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع i-mobile. |
| 103 | تعذّر على i-mobile عرض إعلان. |
| 104 | عرضت i-mobile مصفوفة فارغة من الإعلانات المدمجة مع المحتوى. |
| 105 | تعذّر على i-mobile تنزيل مواد عرض الإعلانات المدمجة مع المحتوى. |
| 106 | لا يتيح i-mobile طلب إعلانات بينية متعدّدة باستخدام Spot ID نفسه. |
سجلّ التغييرات في مكوّن i-mobile Unity Mediation الإضافي
الإصدار 1.3.12 (قيد التطوير)
الإصدار 1.3.11
- يتوافق مع الإصدار 2.3.2.3 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.4.6 من محوّل i-mobile iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 11.0.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.3.10
- يتوافق مع الإصدار 2.3.2.2 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.4.5 من محوّل i-mobile iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 11.0.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.3.9
- يتوافق مع الإصدار 2.3.2.1 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.4.5 من محوّل i-mobile iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 11.0.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.3.8
- يتوافق مع الإصدار 2.3.2.1 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.4.3 من محوّل i-mobile iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.6.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.3.7
- يتوافق مع الإصدار 2.3.2.1 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.4.2 من محوّل i-mobile iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.0.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.
الإصدار 1.3.6
- يتوافق مع الإصدار 2.3.2.0 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.4.1 من محوّل i-mobile iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.3.0 من إضافة Google Mobile Ads Unity.
الإصدار 1.3.5
- يتوافق مع الإصدار 2.3.2.0 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.4.0 من محوّل i-mobile iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.3.4
- يتوافق مع الإصدار 2.3.1.2 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.4.0 من محوّل i-mobile iOS.
- تم إنشاء هذا الإصدار واختباره باستخدام الإصدار 9.0.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.3.3
- يتوافق مع الإصدار 2.3.1.1 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.3.0 من محوّل i-mobile iOS.
- تم إنشاء هذا الإصدار واختباره باستخدام الإصدار 9.0.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.3.2
- تم نقل محتوى المحوّل إلى
GoogleMobileAds/Mediation/IMobile/. - يتوافق مع الإصدار 2.3.1.1 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.2.0 من محوّل i-mobile iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 8.1.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.
الإصدار 1.3.1
- يتوافق مع الإصدار 2.3.0.0 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.0.1 من محوّل i-mobile iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.4.1 من إضافة Google Mobile Ads Unity.
الإصدار 1.3.0
- يتوافق مع الإصدار 2.3.0.0 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.3.0.0 من محوّل i-mobile iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.3.1 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.2.2
- يتوافق مع الإصدار 2.0.23.1 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.2.0.1 من محوّل i-mobile iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.0.2 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.2.1
- يتوافق مع الإصدار 2.0.23.0 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.2.0.1 من محوّل i-mobile iOS.
- تم إنشاء هذا الإصدار واختباره باستخدام الإصدار 7.0.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.
الإصدار 1.2.0
- يتوافق مع الإصدار 2.0.23.0 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.2.0.0 من محوّل i-mobile iOS.
الإصدار 1.1.0
- يتوافق مع الإصدار 2.0.22.2 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.1.0.1 من محوّل i-mobile iOS.
الإصدار 1.0.2
- يتوافق مع الإصدار 2.0.22.0 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.0.32.0 من محوّل i-mobile iOS.
الإصدار 1.0.1
- يتوافق مع الإصدار 2.0.21.0 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.0.31.0 من محوّل i-mobile iOS.
الإصدار 1.0.0
- الإصدار الأول!
- يتوافق مع الإصدار 2.0.20.1 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.0.29.0 من محوّل i-mobile iOS.