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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (الإصدار القديم)

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

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

يتضمّن محوّل وسيطة "مدير إعلانات Google" لـ ironSource Ads الإمكانات التالية:

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

1 لا يتوفّر هذا التنسيق إلا في عملية الدمج بدون انقطاع.

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

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

  • أحدث إصدار من Google Mobile Ads Unity Plugin
  • الإصدار 4 أو إصدار أحدث من Unity Editor
  • [لعرض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم مكوّنًا إضافيًا للوساطة في "إعلانات Google للأجهزة الجوّالة" لخدمة "إعلانات ironSource" بالإصدار 3.5.1 أو إصدار أحدث (يُنصح باستخدام أحدث إصدار).
  • للنشر على Android
    • المستوى 24 من واجهة برمجة التطبيقات Android أو الإصدارات الأحدث
  • للنشر على أجهزة iOS
    • الإصدار 13.0 من نظام التشغيل iOS أو إصدار أحدث
  • يجب أن يكون لديك مشروع Unity صالح تم إعداده باستخدام Google Mobile Ads Unity Plugin. لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Unity Plugin.
  • إعداد التوسّط

    • الخطوة 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 في "إدارة إعلانات Google".

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

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

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

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

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

    Android

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

    iOS

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

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

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

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

    OpenUPM-CLI

    إذا كان لديك OpenUPM-CLI مثبّتًا، يمكنك تثبيت المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" و"إعلانات ironSource" في Unity لمشروعك عن طريق تشغيل الأمر التالي من الدليل الجذري لمشروعك:

    openupm add com.google.ads.mobile.mediation.ironsource

    OpenUPM

    في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > أداة إدارة الحِزم لفتح إعدادات أداة إدارة حِزم Unity.

    ضمن علامة التبويب المستودعات المسجّلة ذات النطاق المحدود، أضِف OpenUPM كمستودع مسجّل ذي نطاق محدود مع التفاصيل التالية:

    • الاسم: OpenUPM
    • عنوان URL: https://package.openupm.com
    • النطاقات: com.google

    تفاصيل‫ OpenUPM

    بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager (إدارة حِزم Unity)، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.

    Unityمستودعات ‫

    اختَر حزمة توسّط IronSource في "إعلانات Google على الأجهزة الجوّالة" وانقر على تثبيت.

    التثبيت من‫ OpenUPM

    حزمة Unity

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

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

    الاستيراد من‫ Unity

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

    فرض الحلّ

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

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

    يتيح الإصدار 2.6.0 والإصدارات الأحدث من محوّل Unity في ironSource Ads تمرير إشارات الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) من حزمة تطوير البرامج لمنصّة UMP ومنصّات إدارة الموافقة التي تتكامل مع مواصفات الموافقة الإضافية من Google

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

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

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

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

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

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

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

    Android

    قواعد Proguard

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

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

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

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

    iOS

    تكامل SKAdNetwork

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

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

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

    تأكيد الإعلانات الاختبارية

    للتأكّد من أنّك تتلقّى إعلانات اختبارية من 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 التي تم ضبطها في واجهة مستخدم "إدارة إعلانات Google" غير متوفّرة أو غير صالحة.
    102 تتطلّب ironSource Ads سياق نشاط لإعداد حزمة تطوير البرامج (SDK).
    103 يمكن لـ ironSource Ads تحميل إعلان واحد فقط لكل معرّف مثيل في ironSource.
    105 لا تتيح منصة ironSource Ads حجم إعلان البانر المطلوب.
    106 لم يتم إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات من ironSource.
    107 تم إرسال طلب عرض إعلان قبل تحميل الإعلان بنجاح.
    501-1056 أخطاء حزمة تطوير البرامج (SDK) في ironSource Ads يمكنك الاطّلاع على المستندات لمزيد من التفاصيل.

    iOS

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

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

    الإصدار 4.8.0 (قيد التطوير)

    الإصدار 4.7.0

    الإصدار 4.6.0

    الإصدار 4.5.3

    الإصدار 4.5.2

    الإصدار 4.5.1

    الإصدار 4.5.0

    الإصدار 4.4.1

    الإصدار 4.4.0

    الإصدار 4.3.0

    الإصدار 4.2.0

    الإصدار 4.1.0

    الإصدار 4.0.0

    الإصدار 3.11.1

    الإصدار 3.11.0

    الإصدار 3.10.0

    الإصدار 3.9.1

    الإصدار 3.9.0

    الإصدار 3.8.1

    الإصدار 3.8.0

    الإصدار 3.7.0

    الإصدار 3.6.1

    الإصدار 3.6.0

    الإصدار 3.5.2

    الإصدار 3.5.1

    الإصدار 3.5.0

    الإصدار 3.4.0

    الإصدار 3.3.1

    الإصدار 3.3.0

    الإصدار 3.2.1

    الإصدار 3.2.0

    الإصدار 3.1.1

    الإصدار 3.1.0

    الإصدار 3.0.1

    الإصدار 3.0.0

    الإصدار 2.6.1

    الإصدار 2.6.0

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

    • تم تعديل المكوّن الإضافي ليتوافق مع واجهة برمجة التطبيقات الجديدة للإصدار التجريبي المفتوح من "الإعلانات مقابل مكافآت".
    • يتوافق مع الإصدار 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.