دمج i-mobile مع التوسّط

يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads SDK لتحميل الإعلانات وعرضها من i-mobile باستخدام توسّط AdMob، مع تغطية عمليات دمج العرض الإعلاني بدون انقطاع. توضّح هذه الصفحة كيفية إضافة 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 (معرّف الموضع). ستحتاج إلى هذه المَعلمات لاحقًا عند ضبط i-mobile للتوسّط في واجهة مستخدم AdMob.

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

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

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

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

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

عليك إضافة i-mobile إلى إعدادات التوسّط لوحدتك الإعلانية.

أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، وانتقِل إلى إضافة i-mobile كمصدر إعلان.

لإنشاء مجموعة توسّط جديدة، انقر على إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصة، ثم انقر على متابعة.

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

اربط مجموعة التوسط هذه بوحدة إعلانية واحدة أو أكثر من وحداتك الإعلانية الحالية في AdMob. بعد ذلك، انقر على تم.

من المفترض أن تظهر الآن بطاقة الوحدات الإعلانية معبأة بالوحدات الإعلانية التي اخترتها:

إضافة i-mobile كمصدر إعلان


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

اختَر i-mobile وفعِّل مفتاح التبديل تحسين. أدخِل اسم تسجيل الدخول وكلمة مرور واجهة برمجة التطبيقات التي حصلت عليها في القسم السابق لإعداد ميزة "تحسين مصدر الإعلان" لشبكة i-mobile. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور لـ i-mobile وانقر على متابعة.




إذا كان لديك تعيين في i-mobile، يمكنك اختياره. بخلاف ذلك، انقر على إضافة عملية ربط.



بعد ذلك، أدخِل الرقم التعريفي للناشر ومعرّف الوسائط ومعرّف الموضع التي حصلت عليها في القسم السابق. بعد ذلك، انقر على تم.

الخطوة 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: اختبار عملية الإعداد

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

تأكَّد من تسجيل جهازك الاختباري في AdMob. توفّر 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 التي تم ضبطها في واجهة مستخدم AdMob غير متوفّرة أو غير صالحة.
102 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع i-mobile.
103 تعذّر على i-mobile عرض إعلان.
104 عرضت i-mobile مصفوفة إعلانات مدمجة مع المحتوى فارغة.
105 تعذّر على i-mobile تنزيل مواد عرض الإعلانات المدمجة مع المحتوى.
106 لا تتيح i-mobile طلب إعلانات بينية متعددة باستخدام رقم تعريف الموضع نفسه.
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

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

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

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

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

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

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

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