دمج ironSource Ads مع "توسّط AdMob"

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

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

يوفّر محوّل التوسّط في AdMob لخدمة "إعلانات ironSource" الإمكانات التالية:

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

‫1 لا يتوفّر هذا الشكل إلا في دمج العرض الإعلاني بدون انقطاع.

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

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

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

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

اشترِك وسجِّل الدخول إلى حسابك على ironSource Ads.

إضافة تطبيق جديد

لإضافة تطبيق جديد، انتقِل إلى الإعلانات > التطبيقات وانقر على إضافة تطبيق.

املأ النموذج وانقر على إضافة تطبيق.

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

Android

iOS

إنشاء نسخة افتراضية

بعد ذلك، اضبط مثيلاً للتطبيق الذي أضفته.

انتقِل إلى الإعلانات > الإعداد > المثيلات. اختَر التطبيق وانقر على إنشاء مثيل.

عروض الأسعار

املأ النموذج واختَر عروض الأسعار في حقل التسعير. انقر على حفظ وإغلاق.

Android

iOS

دوِّن رقم تعريف المثيل.

Android

iOS

شلال

املأ النموذج وانقر على حفظ وإغلاق.

دوِّن رقم تعريف المثيل.

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

عروض الأسعار

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

شلال

انقر على علامة التبويب واجهة برمجة التطبيقات في صفحة "حسابي" ودوِّن المفتاح السري والرمز المميز لإعادة التحميل.

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

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

لتنفيذ app-ads.txt لـ ironSource، يُرجى الاطّلاع على المورّدون المعتمَدون لـ ironSource.

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

اتّبِع التعليمات الواردة في دليل اختبار الدمج في ironSource Ads حول كيفية تفعيل الإعلانات الاختبارية في ironSource Ads.

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

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

    npm

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

    خيط غزل

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

  3. إذا كنت تنشئ تطبيقًا لنظام التشغيل Android، أضِف المستودع التالي إلى ملف build.gradle في دليل android الخاص بمشروعك:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://android-sdk.is.com/")
    }
}

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

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

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

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

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

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

import { IronSourceMediation } from '@google/gma-mediation-ironsource';
// ...
IronSourceMediation.setDoNotSell(true);

يُرجى الاطّلاع على مستندات ironSource Ads حول الإعدادات المتقدّمة للّوائح التنظيمية لكلّ من Android وiOS لمزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

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

Android

قواعد Proguard

إذا كنت تُقلّص تطبيقك وتُخفيه وتُحسّنه، تتطلّب منصة ironSource Ads قواعد ProGuard إضافية لمشروعك.

يُرجى الرجوع إلى دليل دمج حزمة تطوير البرامج (SDK) لنظام التشغيل Android من ironSource Ads للحصول على مزيد من المعلومات حول قواعد ProGuard المطلوبة لمشروعك، وإضافة هذه القواعد إلى ملف proguard-user.txt.

iOS

تكامل SKAdNetwork

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

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

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

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

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

رموز الخطأ

إذا تعذّر على المحوِّل تلقّي إعلان من ironSource Ads، يمكن للناشرين الاطّلاع على الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo ضمن الفئات التالية:

Android

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

رمز الخطأ السبب
101 مَعلمات خادم ironSource Ads التي تم ضبطها في واجهة مستخدم AdMob غير متوفّرة أو غير صالحة.
102 تتطلّب منصة ironSource Ads سياق نشاط لإعداد حزمة تطوير البرامج (SDK).
103 يمكن لخدمة ironSource Ads تحميل إعلان واحد فقط لكل معرّف مثيل في ironSource.
105 لا تتيح ironSource Ads حجم إعلان البانر المطلوب.
106 لم يتم إعداد حزمة SDK لعرض الإعلانات من ironSource.
107 تم تقديم طلب عرض إعلان قبل تحميل الإعلان بنجاح.
108 أرجعت حزمة تطوير البرامج (SDK) لخدمة ironSource Ads إشارات عروض أسعار فارغة أو فارغة.
501-1056 أخطاء حزمة تطوير البرامج (SDK) في ironSource Ads يمكنك الاطّلاع على المستندات لمزيد من التفاصيل.

iOS

رمز الخطأ السبب
101 مَعلمات خادم ironSource Ads التي تم ضبطها في واجهة مستخدم AdMob غير متوفّرة أو غير صالحة.
102 لا يتيح محوّل ironSource Ads استخدام شكل الإعلان المطلوب.
103 تم تحميل إعلان من ironSource لإعدادات الشبكة هذه.
104 لا تتيح ironSource Ads حجم إعلان البانر المطلوب.
105 تعذّر على ironSource Ads عرض الإعلان.
508-1037 أخطاء حزمة تطوير البرامج (SDK) في ironSource Ads يمكنك الاطّلاع على المستندات لمزيد من التفاصيل.

الإصدار 0.1.0

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