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

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

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

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

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

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

المتطلبات

  • الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث

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

  • إكمال دليل البدء الخاص بالتوسّط

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

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

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

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

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

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

create_ad_spot

بعد ذلك، املأ النموذج من خلال تقديم اسم موضع الإعلان (Ad Spot name) وحجم موضع الإعلان (Ad Spot size) وغير ذلك من التفاصيل. بعد ذلك، انقر على الزر 新規登録 (اشتراك).

new_ad_spot_form

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

ad_spot_list

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

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

مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف 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

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

pod 'GoogleMobileAdsMediationIMobile'

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

pod install --repo-update

الدمج اليدوي

  • نزِّل أحدث إصدار من i-mobile SDK واربط ImobileSdkAds.framework في مشروعك.
  • نزِّل أحدث إصدار من محوّل i-mobile من رابط التنزيل في سجلّ التغيير واربطه IMobileAdapter.framework في مشروعك.

الخطوة 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 طلب إعلانات بينية متعددة باستخدام Spot ID نفسه.

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

النسخة التالية

  • فعِّل الخيارَين -fobjc-arc و-fstack-protector-all.

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

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

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

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

الإصدار 2.3.3.0

  • تم التأكّد من التوافق مع حزمة تطوير البرامج (SDK) الإصدار 2.3.3 من 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

  • تم التأكّد من التوافق مع حزمة تطوير البرامج (SDK) الإصدار 2.3.2 من 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

  • تم التأكّد من التوافق مع حزمة تطوير البرامج (SDK) الإصدار 2.3.1 من 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 على الأجهزة الجوّالة"
  • الإصدار 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 على الأجهزة الجوّالة".
  • تمّت إضافة إمكانية تغيير حجم الإعلانات 320x50 و320x100 لتتلاءم بشكل أفضل مع أحجام طلبات إعلانات البانر التكيّفية.
  • تمت إزالة إمكانية استخدام بنية 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 على الأجهزة الجوّالة"
  • ‫i-mobile SDK الإصدار 2.0.29