دمج i-mobile مع ميزة "التوسّط"

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

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

تستخدم واجهة لوحة البيانات في i-mobile نصًا يابانيًا للتصنيفات والأزرار والأوصاف. لم تتم ترجمة لقطات الشاشة الواردة في هذا الدليل. في المقابل، يتم في أوصاف هذا الدليل وتعليماته ترجمة التصنيفات والأزرار مع ما يعادلها باللغة الإنجليزية بين قوسين.

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

يوفّر محوّل التوسّط في i-mobile الإمكانات التالية:

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

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

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

  • هدف نشر iOS‏ 13.0 أو إصدار أحدث

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

اشترِك أو سجِّل الدخول إلى حسابك على i-mobile.

أضِف تطبيقك إلى لوحة بيانات i-mobile من خلال النقر على علامة التبويب サイト／アプリ管理 (إدارة الموقع الإلكتروني/التطبيق) والزر الخاص بمنصة تطبيقك.

املأ النموذج وانقر على الزر 新規登録 (اشتراك).

لإنشاء موضع إعلاني جديد، اختَر تطبيقك ضمن علامة التبويب サイト／アプリ管理 (إدارة المواقع الإلكترونية/التطبيقات).

انتقِل إلى علامة التبويب 広告スポット管理 (إدارة مواضع الإعلانات) وانقر على الزر 新規広告スポット (موضع إعلان جديد).

create_ad_spot

بعد ذلك، املأ النموذج من خلال تقديم 広告スポット名 (اسم موضع الإعلان) و広告スポットサイズ (حجم موضع الإعلان) وغيرها من التفاصيل. بعد ذلك، انقر على الزر 新規登録 (اشتراك).

new_ad_spot_form

أصبح الموضع الإعلاني الجديد جاهزًا. لعرض تفاصيل الدمج، انقر على الزر アプリ設定取得 (الحصول على إعدادات التطبيق).

ad_spot_list

دوِّن パブリッシャーID (الرقم التعريفي للناشر) وメディアID (معرّف الوسائط) وスポットID (Spot ID). ستحتاج إلى هذه المَعلمات لاحقًا عند ضبط i-mobile للتوسّط في واجهة مستخدم "مدير إعلانات Google".

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

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

لتنفيذ app-ads.txt في i-mobile، يُرجى الاطّلاع على الأسئلة الشائعة.

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

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

سجِّل الدخول إلى حسابك على "مدير إعلانات Google".

انتقِل إلى التسليم > مجموعة الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة شبكات إعلانية مدِرّة للأرباح جديدة.

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

بعد ذلك، انقر على الزر إضافة شريك إعلاني مدِّر للأرباح.

إذا كان لديك شريك إعلاني مدِّر للأرباح في i-mobile، يمكنك اختياره. بخلاف ذلك، اختَر إنشاء شريك جديد إعلاني مدِّر للأرباح.

اختَر i-mobile كـ شبكة إعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط.

فعِّل جمع البيانات تلقائيًا، وأدخِل اسم تسجيل الدخول وكلمة مرور واجهة برمجة التطبيقات

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

انقر على حفظ في أسفل الصفحة عند الانتهاء.

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

استخدام Swift Package Manager

قبل المتابعة، يجب أن يكون لديك الحد الأدنى من إصدار المحوّل المتوافق 2.3.4.2.

لإضافة حزمة تابعة إلى مشروعك، اتّبِع الخطوات التالية:

  1. في Xcode، انتقِل إلى ملف (File) > إضافة موارد الاعتمادية للحزمة (Add Package Dependencies)....

  2. في الطلب الذي يظهر، ابحث عن عنوان URL للحزمة التالية:

    https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git

  3. في قاعدة التبعية، اختَر فرع.

  4. في حقل النص، أدخِل main.

استخدام CocoaPods

  • أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:

    pod 'GoogleMobileAdsMediationIMobile'

  • من سطر الأوامر، شغِّل:

    pod install --repo-update

الدمج اليدوي

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

تنفيذ SKAdNetwork

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

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

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

تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات". توفّر i-mobile معرّف المكان ومعرّف الوسائط ومعرّف الناشر للاختبار، ويمكنك العثور عليها هنا.

التحقّق من الإعلانات الاختبارية

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

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

استخدام الإعلانات المُدمَجة مع المحتوى

عرض الإعلانات

يملأ محوّل i-mobile الحقول التالية لـ GADNativeAd.

الحقل مواد العرض التي يتم تضمينها دائمًا من خلال محوّل i-mobile
العنوان
صورة
النص
رمز التطبيق 1
الحث على اتخاذ إجراء
التقييم بالنجوم
المتجر
السعر

‫1 بالنسبة إلى "الإعلانات المدمجة مع المحتوى"، لا توفّر حزمة SDK لـ i-mobile مادة عرض لرمز التطبيق. بدلاً من ذلك، يملأ محوّل i-mobile رمز التطبيق بصورة شفافة.

رموز الخطأ

إذا لم يتمكّن المحوّل البرمجي من تلقّي إعلان من i-mobile، يمكن للناشرين التحقّق من الخطأ الأساسي من ردّ الإعلان باستخدام GADResponseInfo.adNetworkInfoArray ضمن الفئات التالية:

التنسيق اسم الصف
بانر IMobileAdapter
إعلان بيني IMobileAdapter
مدمج مع المحتوى GADMediationAdapterIMobile

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل i-mobile عندما يتعذّر تحميل إعلان:

رمز الخطأ السبب
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 نفسه.
107 فلترة الطلبات المحظورة على فئات عمرية معيّنة لحزمة i-mobile SDK لأنّها لا يمكنها تلقّي إشارات محظورة على فئات عمرية معيّنة

سجلّ تغييرات محوّل التوسّط في i-mobile على iOS

الإصدار 2.3.4.8

  • تم تعديل الحدّ الأدنى لإصدار iOS من أجل تخفيف الاعتماد على حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" للسماح بأرقام الإصدارات الثانوية.

تم التصميم والاختبار باستخدام:

  • الإصدار 13.7.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.4 من حزمة SDK لـ i-mobile

الإصدار 2.3.4.7

  • فلترة الطلبات المحظورة على فئات عمرية معيّنة في حزمة تطوير البرامج (SDK) لـ i-mobile عندما يتم ضبط القيمة الجديدة لـ ageRestrictedTreatment على GADAgeRestrictedTreatmentChild

تم التصميم والاختبار باستخدام:

  • الإصدار 13.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.4 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile

الإصدار 2.3.4.6

  • فلترة الطلبات المحظورة على فئات عمرية معيّنة في حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile لأنّها لا يمكنها تلقّي الإشارات المحظورة على فئات عمرية معيّنة

تم إنشاؤه واختباره باستخدام:

  • الإصدار 13.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.4 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile

الإصدار 2.3.4.5

  • تم تعديل تبعية حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى الإصدار 13.0.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 13.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.4 من حزمة SDK لـ i-mobile

الإصدار 2.3.4.4

  • تم تعديل الحدّ الأدنى لإصدار iOS في CocoaPods إلى 13.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 13.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.4 من حزمة SDK لـ i-mobile

الإصدار 2.3.4.3

  • تم تصحيح أسماء الإطار والعنوان الشامل في خريطة وحدة IMobileAdapter.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 12.12.0 من SDK لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.3.4 من حزمة SDK لـ i-mobile

الإصدار 2.3.4.2

  • يتطلّب الآن الإصدار 12.0.0 أو إصدارًا أحدث من SDK لإعلانات Google على الأجهزة الجوّالة.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 12.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.4 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile

الإصدار 2.3.4.1

  • تم تعديل CFBundleShortVersionString ليحتوي على ثلاثة مكوّنات بدلاً من أربعة.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 11.10.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.4 من حزمة SDK لـ i-mobile

الإصدار 2.3.4.0

  • تم التحقّق من التوافق مع الإصدار 2.3.4 من حزمة تطوير البرامج (SDK) لمنصة i-mobile.
  • تمت إضافة إمكانية عرض إصدار حزمة i-mobile SDK في adSDKVersion.

تم التصميم والاختبار باستخدام:

  • الإصدار 11.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.4 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile

الإصدار 2.3.3.0

  • تم التحقّق من التوافق مع الإصدار 2.3.3 من حزمة تطوير البرامج (SDK) لـ i-mobile.

تم التصميم والاختبار باستخدام:

  • الإصدار 11.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.3 من حزمة تطوير البرامج (SDK) لـ i-mobile

الإصدار 2.3.2.1

  • تمت إزالة طريقة التفويض willBackgroundApplication المتوقّفة نهائيًا من عمليات تنفيذ "إعلانات البانر" و"الإعلانات البينية" و"الإعلانات المدمجة مع المحتوى".
  • يتطلّب الآن الإصدار 12.0 من نظام التشغيل iOS كحدّ أدنى.
  • يتطلّب الآن الإصدار 11.0 أو إصدارًا أحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.
  • تم تضمين Info.plist في أُطر العمل ضمن IMobileAdapter.xcframework.

تم التصميم والاختبار باستخدام:

  • الإصدار 11.0.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.2 من حزمة تطوير البرامج (SDK) لـ i-mobile

الإصدار 2.3.2.0

  • تم التحقّق من التوافق مع الإصدار 2.3.2 من حزمة تطوير البرامج (SDK) لـ i-mobile.
  • تمت إزالة دعم بنية armv7.
  • يتطلّب الآن الإصدار 11.0 من نظام التشغيل iOS كحدّ أدنى.
  • يتطلّب الآن الإصدار 10.4.0 أو إصدارًا أحدث من SDK لإعلانات Google على الأجهزة الجوّالة.

تم التصميم والاختبار باستخدام:

  • الإصدار 10.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.2 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile

الإصدار 2.3.1.0

  • تم التحقّق من التوافق مع الإصدار 2.3.1 من حزمة تطوير البرامج (SDK) لـ i-mobile.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 10.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile

الإصدار 2.3.0.1

  • يتطلّب الآن الإصدار 10.0.0 أو إصدارًا أحدث من SDK لإعلانات Google على الأجهزة الجوّالة.

تم التصميم والاختبار باستخدام:

  • الإصدار 10.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile

الإصدار 2.3.0.0

  • تم التحقّق من التوافق مع الإصدار 2.3.0 من حزمة تطوير البرامج (SDK) لـ i-mobile.
  • يتطلّب الآن الإصدار 9.8.0 أو إصدارًا أحدث من SDK لإعلانات Google على الأجهزة الجوّالة.

تم التصميم والاختبار باستخدام:

  • الإصدار 9.13.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.3.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile

الإصدار 2.2.0.1

  • يتطلّب الآن الإصدار 9.0.0 أو إصدارًا أحدث من SDK لإعلانات Google على الأجهزة الجوّالة.

تم التصميم والاختبار باستخدام:

  • الإصدار 9.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.2.0 من حزمة تطوير البرامج (SDK) لـ i-mobile

الإصدار 2.2.0.0

  • تم التأكّد من التوافق مع الإصدار 2.2.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile.

تم إنشاؤه واختباره باستخدام

  • الإصدار 8.13.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.2.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile

الإصدار 2.1.0.1

  • تم تخفيف الاعتماد على الإصدار 8.0.0 أو إصدار أحدث من "SDK لإعلانات Google على الأجهزة الجوّالة".

تم إنشاؤه واختباره باستخدام

  • الإصدار 8.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.1.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile

الإصدار 2.1.0.0

  • تم التأكّد من التوافق مع الإصدار 2.1.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile.
  • يتطلّب الآن الإصدار 8.1.0 أو إصدارًا أحدث من حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة".
  • تم تعديل المحوّل لاستخدام تنسيق .xcframework.

تم إنشاؤه واختباره باستخدام

  • الإصدار 8.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.1.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile

الإصدار 2.0.33.1

  • تمت إضافة رموز ورسائل خطأ موحّدة للمحوّلات.
  • يفرض المحوّل الآن حدًا على طلب عرض إعلانات بينية متعدّدة باستخدام معرّف Spot نفسه في i-mobile.
  • يعيد المحوّل الآن توجيه دالة ردّ الاتصال -nativeAdWillLeaveApplication: عند النقر على "الإعلانات المدمجة مع المحتوى".
  • يتطلّب الآن الإصدار 7.68.0 أو إصدارًا أحدث من حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة".

تم إنشاؤه واختباره باستخدام

  • الإصدار 7.68.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • i-mobile SDK version 2.0.33.

الإصدار 2.0.33.0

  • تم التحقّق من التوافق مع الإصدار 2.0.33 من حزمة تطوير البرامج (SDK) لـ i-mobile.
  • يتطلّب الآن الإصدار 7.65.0 أو إصدارًا أحدث من SDK لإعلانات Google على الأجهزة الجوّالة.
  • يتطلّب الآن الإصدار 9.0 من نظام التشغيل iOS كحدّ أدنى.

تم إنشاؤه واختباره باستخدام

  • الإصدار 7.65.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.33 من حزمة تطوير البرامج (SDK) لـ i-mobile

الإصدار 2.0.32.0

  • تم التحقّق من التوافق مع الإصدار 2.0.32 من حزمة تطوير البرامج (SDK) لـ i-mobile.
  • يتطلّب الآن الإصدار 7.60.0 أو إصدارًا أحدث من SDK لإعلانات Google على الأجهزة الجوّالة.
  • تمّت إضافة إمكانية تغيير حجم الإعلانات بمقاس 320×50 و320×100 لتناسب بشكل أفضل أحجام طلبات "إعلانات البانر التكيُّفية".
  • تمت إزالة التوافق مع بنية i386.

تم إنشاؤه واختباره باستخدام

  • الإصدار 7.60.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.32 من حزمة SDK لـ i-mobile

الإصدار 2.0.31.0

  • تم التحقّق من التوافق مع الإصدار 2.0.31 من حزمة تطوير البرامج (SDK) لخدمة i-mobile.

تم إنشاؤه واختباره باستخدام

  • الإصدار 7.53.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.31 من حزمة تطوير البرامج (SDK) لـ i-mobile

الإصدار 2.0.29.0

  • الإصدار الأولي.
  • تمت إضافة إمكانية عرض "إعلانات البانر" و"الإعلانات البينية" و"الإعلانات المدمجة مع المحتوى".

تم إنشاؤه واختباره باستخدام

  • الإصدار 7.52.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.29 من حزمة SDK لـ i-mobile