دمج InMobi مع "توسّط AdMob"

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

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

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

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

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

  • أحدث إصدار من Google Mobile Ads SDK for React Native
  • الإصدار 0.85.0 أو إصدار أحدث من إطار عمل React Native
  • للنشر على أجهزة Android
    • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
  • للنشر على أجهزة iOS
    • هدف نشر iOS‏ 10.0 أو إصدار أحدث
  • مشروع React Native يعمل بشكل صحيح وتم ضبطه باستخدام Google Mobile Ads SDK for React Native يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads SDK for React Native لمزيد من التفاصيل.
  • إعداد ميزة "توسّط AdMob"

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

اشترِك لإنشاء حساب على InMobi.

بعد إثبات ملكية حسابك، يمكنك تسجيل الدخول.

إضافة تطبيق

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

انقر على إضافة مساحة إعلانية واختَر قناة تطبيق متوافق مع الأجهزة الجوّالة من القائمة المنسدلة.

ابدأ في كتابة عنوان URL الخاص بتطبيقك المنشور في متجر التطبيقات في شريط البحث واختَر التطبيق من النتائج التي تتم تعبئتها تلقائيًا. انقر على Continue (متابعة).

إذا لم يتم نشر تطبيقك، انقر على الربط يدويًا وأدخِل التفاصيل المطلوبة. انقر على Continue (متابعة).

راجِع إعدادات الامتثال للتطبيقات والمواقع الإلكترونية، ثم انقر على حفظ وإنشاء مواضع الإعلان.

مواضع الإعلانات

بعد إعداد مستودعك الإعلاني، يعيد النظام توجيهك إلى سير عمل إنشاء موضع الإعلان.

عروض الأسعار

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

شلال

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

بعد إنشاء موضع الإعلان، تظهر تفاصيله. سجِّل رقم تعريف موضع الإعلان، والذي سيتم استخدامه لإعداد وحدتك الإعلانية في AdMob.

رقم تعريف الحساب

يتوفّر رقم تعريف حسابك على InMobi ضمن Finance (المالية) > Payment Settings (إعدادات الدفع) > Payment Information (معلومات الدفع).

العثور على مفتاح Reporting API في InMobi

عروض الأسعار

هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.

شلال

انتقِل إلى حسابي > إعدادات الحساب. انتقِل إلى علامة التبويب مفتاح واجهة برمجة التطبيقات وانقر على إنشاء مفتاح واجهة برمجة التطبيقات.

اختَر عنوان البريد الإلكتروني للمستخدم الذي تريد إنشاء المفتاح له، ثم انقر على إنشاء مفتاح واجهة برمجة التطبيقات. سيتم إنشاء ملف يحتوي على مفتاح واجهة برمجة التطبيقات واسم المستخدم/اسم تسجيل الدخول.

يمكن فقط لمشرف الناشر في الحساب إنشاء مفتاح واجهة برمجة التطبيقات لجميع المستخدمين. إذا نسيت مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه سابقًا، يمكنك إعادة ضبطه من خلال تمرير مؤشر الماوس فوق بريدك الإلكتروني في علامة التبويب مفتاح واجهة برمجة التطبيقات.

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

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

لتنفيذ ميزة "app-ads.txt" في InMobi، أضِف مقتطف الرمز المخصّص.

تفعيل "الوضع التجريبي"

فعِّل وضع الاختبار لموضع إعلانك على جميع مرات الظهور المباشرة أو على أجهزة اختبار معيّنة فقط.

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

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

Android

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

إضافة InMobi إلى قائمة الشركاء الإعلانيين في "اللائحة العامة لحماية البيانات" (GDPR) واللوائح التنظيمية في الولايات الأمريكية

اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة InMobi إلى قائمة الشركاء الإعلانيين في اللوائح التنظيمية الأوروبية واللوائح التنظيمية في الولايات الأمريكية ضمن واجهة مستخدم AdMob.

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

في الدليل الجذري لمشروعك، ثبِّت محوِّل التوسّط Google Mobile Ads SDK for React Native لشبكة InMobi. يُرجى إكمال الخطوات التالية:

  1. انسخ ملف tar الخاص بمحوّل Google Mobile Ads SDK for React Native من دليل gma-sdk-react-native/adapters/inmobi/ إلى دليل local_packages/ في مشروعك. إذا لم يكن لديك المجلد adapters، يُرجى الاطّلاع على المتطلبات الأساسية.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/inmobi/gma-mediation-inmobi-0.1.0.tgz local_packages/

    استبدِل EXTRACT_DIR بالمسار إلى الدليل الذي استخرجت الأرشيف فيه.

  2. ثبِّت حزمة المحوّل باستخدام أداة إدارة الحِزم المفضّلة لديك:

    npm

    npm install ./local_packages/gma-mediation-inmobi-0.1.0.tgz

    خيط غزل

    yarn add ./local_packages/gma-mediation-inmobi-0.1.0.tgz

الخطوة 4: تطبيق إعدادات الخصوصية في حزمة تطوير البرامج (SDK) لمنصة InMobi

للالتزام بسياسة موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google، عليك الإفصاح عن معلومات محدّدة للمستخدمين في المنطقة الاقتصادية الأوروبية والمملكة المتحدة وسويسرا، والحصول على موافقتهم على استخدام ملفات تعريف الارتباط أو غير ذلك من البيانات المحفوظة على أجهزتهم المحلية وفقًا للمتطلبات القانونية، وكذلك موافقتهم على جمع البيانات الشخصية ومشاركتها واستخدامها في تخصيص الإعلانات. تعكس هذه السياسة شروط "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR). أنت مسؤول عن التحقّق من نشر الموافقة على كل مصدر إعلان في سلسلة التوسّط.

يتيح الإصدار 0.1.0 من محوّل InMobi React Native والإصدارات الأحدث تمرير إشارات الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) من منصّات إدارة الموافقة التي تتكامل مع "إطار الشفافية والموافقة" (TCF) الصادر عن مكتب IAB إلى حزمة تطوير البرامج (SDK) من InMobi. لمزيد من المعلومات، يُرجى الاطّلاع على اللائحة العامة لحماية البيانات.

قوانين الخصوصية في الولايات الأمريكية

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

لا يتيح المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" في InMobi تمرير معلومات الموافقة إلى حزمة تطوير البرامج (SDK) في InMobi.

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

Android

لا يلزم استخدام رمز إضافي لدمج InMobi.

iOS

تكامل SKAdNetwork

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

الخطوة 6: اختبار عملية الإعداد

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

تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم InMobi.

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

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

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

المَعلمات الخاصة بالشبكة

يتيح محوّل InMobi تمرير عنصر InMobiMediationExtras إلى طلب عرض الإعلان لضبط المَعلمات الخاصة بالشبكة. لمزيد من المعلومات حول المَعلمات المتاحة، يُرجى الاطّلاع على المستندات المرجعية الخاصة بـ InMobi.

يوضّح الرمز النموذجي التالي كيفية ضبط مَعلمات الاستهداف والتسجيل لشبكة InMobi:

import {
  InMobiMediationExtras,
  InMobiAgeGroup,
  InMobiEducation,
  InMobiLogLevel,
} from '@google/gma-mediation-inmobi';

const request = {
  // ...
  mediationExtras: [
    new InMobiMediationExtras({
      ageGroup: InMobiAgeGroup.BETWEEN_25_AND_29,
      education: InMobiEducation.COLLEGE_OR_GRADUATE,
      logLevel: InMobiLogLevel.DEBUG,
      age: 25,
      postalCode: '12345',
      areaCode: '678',
      language: 'en',
      city: 'NY',
      state: 'NY',
      country: 'US',
      interests: 'sports',
    }),
  ],
};

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" />

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 مسبقًا لإعدادات هذه الشبكة.
104 تم عرض إعلان مدمج مع المحتوى من InMobi بدون مواد عرض مدمجة مع المحتوى، أو تعذّر تنزيل مواد عرض الصور المطلوبة.
105 لا يتوفّر إعلان من InMobi جاهز للعرض.
106 عرضت InMobi رمزًا مميزًا فارغًا أو غير صالح لعرض السعر.
غير ذلك عرضت حزمة تطوير البرامج (SDK) لـ InMobi خطأً. اطّلِع على IMRequestStatus.h لمزيد من التفاصيل.

الإصدار 0.1.0

  • الإصدار الأوّلي