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

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

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

يتضمّن برنامج التكيّف الخاص بالتوسّط في AdMob لخدمة ironSource Ads الميزات التالية:

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

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

المتطلبات

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

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

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

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

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

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

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

Android

iOS

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

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

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

عروض الأسعار

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

Android

iOS

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

Android

iOS

شلال

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

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

تحديد موقع مفتاح Reporting API

عروض الأسعار

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

شلال

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

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

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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت Google Mobile Ads ironSource Ads Mediation Plugin for Unity في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

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

OpenUPM

في أداة تعديل مشروع Unity، اختَر تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحِزم (Package Manager) لفتح إعدادات "إدارة حِزم Unity" (Unity Package Manager Settings).

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

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

تفاصيل OpenUPM

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

Unity Registries

اختَر حزمة Google Mobile Ads IronSource Mediation وانقر على تثبيت.

التثبيت من OpenUPM

حزمة Unity

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

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

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

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

فرض الحل

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

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

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

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

IronSource.SetConsent(true);

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

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

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

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

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 Ads للحصول على مزيد من المعلومات حول قواعد ProGuard المطلوبة لمشروعك، وأضِف هذه القواعد إلى ملف proguard-user.txt.

iOS

دمج SKAdNetwork

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

الخطوة 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 Ads عند تعذّر تحميل إعلان:

Android

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

iOS

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

سجلّ التغييرات في IronSource Unity Mediation Plugin

الإصدار 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 الوسيط.