دمج ironSource مع التوسّط

يوضِّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل تحميل إعلانات من ironSource وعرضها باستخدام التوسّط، وتغطي عمليات دمج العرض الإعلاني بدون انقطاع. وتتناول المقالة كيفية إضافة ironSource إلى إعدادات التوسّط لإحدى الوحدات الإعلانية، وكيفية دمج محوّل وحزمة ironSource في أحد تطبيقات Unity.

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

يوفّر AdMob محوِّل التوسط لـ ironSource الإمكانات التالية:

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

المتطلّبات

  • Unity 4 أو أعلى
  • أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
  • للنشر على Android:
    • المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android
  • للنشر على iOS:
    • هدف نشر iOS هو 12.0 أو إصدار أحدث
  • مشروع Unity عملي تم إعداده باستخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على مزيد من التفاصيل.
  • إكمال عملية التوسّط دليل البدء

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

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

لإضافة تطبيقك إلى لوحة بيانات ironSource، انقر على الزر New App (تطبيق جديد).

إدخال تفاصيل التطبيق

اختَر تطبيق مباشر، وأدخِل عنوان URL لتطبيقك، ثم انقر على استيراد معلومات التطبيق.

إذا لم يكن تطبيقك متاحًا، اختَر التطبيق غير متاح في متجر التطبيقات وأدخِل اسمًا مؤقتًا لتطبيقك، ثم اختَر نظامك الأساسي.

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

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

Android

iOS

إنشاء مثيل

بعد ذلك، اضبط مثيل شبكة للتطبيق الذي أضفته، حيث يتوافق ironSource مع العديد من مثيلات الشبكة للإعلانات التي تضم مكافأة والإعلانات البينية.

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

أدخِل التفاصيل اللازمة، ثم انقر على حفظ وإغلاق.

بعد إنشاء المثيل، يتم إدراج رقم تعريف المثيل في حقل رقم تعريف المثيل.

بالإضافة إلى APP KEY ورقم تعريف المثيل، ستحتاج أيضًا إلى المفتاح السري لـ ironSource والرمز المميّز لإعادة التحميل لإعداد AdMob معرّف الوحدة الإعلانية.

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

تفعيل وضع الاختبار

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

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

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

Android

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

iOS

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

إضافة ironSource Mobile إلى قائمة شركاء الإعلانات الذين يخضعون للّائحة العامة لحماية البيانات (GDPR) ولوائح الولايات الأمريكية

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

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

نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في ironSource من رابط التنزيل في سجلّ التغييرات واستخرج GoogleMobileAdsIronSourceMediation.unitypackage من ملف zip.

في محرر مشروع Unity، حدد مواد العرض > استيراد حزمة > حزمة مخصصة وابحث عن الملف GoogleMobileAdsIronSourceMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android > فرض الحل. ستنفِّذ مكتبة أداة حلّ المشاكل في Unity Play Services حل التبعية من البداية، وتنسخ التبعيات المُعلَن عنها إلى دليل Assets/Plugins/Android في تطبيق Unity.

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

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

يتضمّن المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" للإصدار 1.0.0 من ironSource طريقة IronSource.SetConsent(). يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة إلى حزمة ironSource SDK. إذا اخترت استدعاء هذه الطريقة، ننصحك بإجراء ذلك قبل طلب الإعلانات من خلال "SDK لإعلانات Google على الأجهزة الجوّالة".

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetConsent(true);

يمكنك الاطّلاع على وثائق ironSource في صفحة الإعدادات المتقدّمة للتنظيم للحصول على مزيد من التفاصيل.

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

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

يتضمّن المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" للإصدار 2.2.4 من ironSource طريقة IronSource.SetMetaData(). يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة إلى حزمة ironSource SDK. يجب ضبط هذه الخيارات قبل إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة لضمان إعادة توجيهها بشكل صحيح إلى حزمة ironSource SDK.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

يمكنك الاطّلاع على مستندات ironSource بشأن الإعدادات المتقدّمة للتنظيم لكل من Android وiOS لمعرفة المزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

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

Android

قواعد Proguard

في حال تقليص حجم تطبيقك وتشويشه وتحسينه، تتطلّب IronSource قواعد ProGuard إضافية لمشروعك.

عند إنشاء مشروعك، اختَر Android باعتباره النظام الأساسي. بعد ذلك، افتح إعدادات المشغّل واختر ملف Proguard للمستخدم ضمن علامة التبويب إعدادات النشر. يجب أن تُظهر Unity مكان إنشاء ملف proguard-user.txt مخصّص لك لتعديله.

ملف Proguard لمستخدم Unity

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

iOS

دمج SKAdNetwork

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

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

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

احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم ironSource .

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

للتأكّد من أنّك تتلقّى إعلانات اختبارية من ironSource، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام ironSource (Waterfall) مصادر الإعلانات.

رموز الخطأ

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

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

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

iOS

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

سجلّ تغيير المكوّن الإضافي لـ IronSource Unity Mediation

الإصدار 2.5.0

الإصدار 2.4.0

الإصدار 2.3.1

الإصدار 2.3.0

الإصدار 2.2.7

الإصدار 2.2.6

الإصدار 2.2.5

الإصدار 2.2.4

الإصدار 2.2.3

الإصدار 2.2.2

الإصدار 2.2.1

الإصدار 2.2.0

الإصدار 2.1.5

الإصدار 2.1.4

الإصدار 2.1.3

الإصدار 2.1.2

الإصدار 2.1.1

الإصدار 2.1.0

الإصدار 2.0.3

الإصدار 2.0.2

الإصدار 2.0.1

الإصدار 2.0.0

الإصدار 1.10.0

الإصدار 1.9.1

الإصدار 1.9.0

الإصدار 1.8.2

الإصدار 1.8.1

الإصدار 1.8.0

الإصدار 1.7.0

الإصدار 1.6.0

الإصدار 1.5.0

الإصدار 1.4.0

الإصدار 1.3.2

الإصدار 1.3.1

  • يتوافق مع الإصدار 6.10.0.0 من محوّل IronSource المتوافق مع Android
  • يتوافق مع الإصدار 6.8.6.0 من محوّل IronSource لنظام التشغيل iOS.

الإصدار 1.3.0

  • يتوافق مع الإصدار 6.10.0.0 من محوّل IronSource المتوافق مع Android
  • يتوافق مع الإصدار 6.8.4.1.0 من محوّل IronSource لنظام التشغيل iOS.

الإصدار 1.2.0

  • يتوافق مع الإصدار 6.9.0.1 من محوّل IronSource المتوافق مع Android
  • يتوافق مع الإصدار 6.8.4.1.0 من محوّل IronSource لنظام التشغيل iOS.

الإصدار 1.1.2

  • يتوافق مع الإصدار 6.8.4.1 من محوّل IronSource المتوافق مع Android
  • يتوافق مع الإصدار 6.8.4.1 من محوّل IronSource لنظام التشغيل iOS.

الإصدار 1.1.1

  • يتوافق مع الإصدار 6.8.4.1 من محوّل IronSource المتوافق مع Android
  • يتوافق مع الإصدار 6.8.3.0 من محوّل IronSource لنظام التشغيل iOS.

الإصدار 1.1.0

  • تم تحديث المكوّن الإضافي للتوافق مع واجهة برمجة التطبيقات Rewarded API الجديدة والمفتوحة.
  • يتوافق مع الإصدار 6.8.1.2 من محوّل IronSource المتوافق مع Android
  • يتوافق مع الإصدار 6.8.0.1 من محوّل IronSource لنظام التشغيل iOS.

الإصدار 1.0.4

  • يتوافق مع الإصدار 6.7.11.0 من محوّل IronSource المتوافق مع Android
  • يتوافق مع الإصدار 6.7.11.0 من محوّل IronSource لنظام التشغيل iOS.

الإصدار 1.0.3

  • يتوافق مع الإصدار 6.7.10.0 من محوّل IronSource المتوافق مع Android
  • يتوافق مع الإصدار 6.7.10.0 من محوّل IronSource لنظام التشغيل iOS.

الإصدار 1.0.2

  • يتوافق مع الإصدار 6.7.9.1.1 من محوّل IronSource المتوافق مع Android
  • يتوافق مع الإصدار 6.7.10.0 من محوّل IronSource لنظام التشغيل iOS.
  • تم إصلاح تعارض مع المكوِّن الإضافي لتوسّط Chartboost Unity.

الإصدار 1.0.1

  • يتوافق الجهاز مع الإصدار 6.7.9.0 من محوّل IronSource المتوافق مع Android.
  • يتوافق مع الإصدار 6.7.9.2.0 من محوّل IronSource لنظام التشغيل iOS.

الإصدار 1.0.0

  • الإصدار الأول
  • يتوافق الجهاز مع الإصدار 6.7.9.0 من محوّل IronSource المتوافق مع Android.
  • يتوافق مع الإصدار 6.7.9.1.0 من محوّل IronSource لنظام التشغيل iOS.