دمج إعلانات Unity مع ميزة "التوسّط"

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

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

يتضمّن محوِّل التوسّط في Unity Ads الإمكانات التالية:

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

المتطلبات

  • المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

  • إكمال عملية التوسّط دليل البدء

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

الخطوة 2: إعداد طلب Unity Ads في Ad Manager واجهة المستخدم

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

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

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

في ملف build.gradle.kts على مستوى التطبيق، أضِف عملية التنفيذ التالية والتبعيات والتكوينات. استخدام أحدث إصدارات حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية والمحوّل:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.unity3d.ads:unity-ads:4.12.1")
    implementation("com.google.ads.mediation:unity:4.12.2.0")
}

الدمج اليدوي

  1. يمكنك تنزيل أحدث حزمة تطوير برامج (SDK) لإعلانات Unity (unity-ads.aar) من مستودع GitHub وإضافته إلى مشروعك.

  2. الانتقال إلى عناصر محوّل Unity Ads على مستودع Maven الخاص بـ Google. اختَر أحدث إصدار ونزِّل Unity ملف .aar لمحوّل الإعلانات، وإضافته إلى مشروعك.

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

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

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

Java

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();

Kotlin

import com.unity3d.ads.metadata.MetaData
// ...

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()

الاطّلاع على Unity Ads واجهات برمجة التطبيقات للموافقة على الخصوصية وواجهات برمجة التطبيقات للبيانات أو الالتزام باللائحة العامة لحماية البيانات لمزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة.

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

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

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

Java

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

Kotlin

import com.unity3d.ads.metadata.MetaData
// ...

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()

الاطّلاع على Unity Ads واجهات برمجة التطبيقات للموافقة على الخصوصية وواجهات برمجة التطبيقات للبيانات أو الالتزام بقانون خصوصية المستهلك في كاليفورنيا (CCPA) لمزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة.

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

وليس عليك استخدام رمز إضافي لعمليات دمج Unity Ads.

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

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

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

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

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

رموز الخطأ

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

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل UnityAds عند فشل تحميل إعلان:

رمز الخطأ السبب
0-10 حدث خطأ في حزمة UnityAds SDK. الاطّلاع على الرمز لمزيد من التفاصيل.
101 مَعلمات خادم UnityAds التي تم ضبطها في واجهة المستخدم Ad Manager غير متوفّرة أو غير صالحة.
102 عرضت UnityAds موضع إعلان بحالة NO_FILL.
103 عرضت UnityAds موضع إعلان بالحالة "غير مفعّل".
104 حاولت UnityAds عرض إعلان بدون سياق.
105 إنّ السياق المستخدَم لإعداد الإعلانات من Unity Ads و/أو تحميلها و/أو عرضها ليس مثيلًا لنشاط.
106 حاولت UnityAds عرض إعلان غير جاهز للعرض.
107 لا تتوفّر UnityAds على الجهاز.
108 يمكن لبرنامج UnityAds تحميل إعلان واحد فقط لكل موضع إعلان في الوقت نفسه.
109 انتهت UnityAds في حالة خطأ.
200-204 خطأ متعلق ببانر UnityAds. الاطّلاع على الرمز لمزيد من التفاصيل.

سجلّ تغييرات محوّل توسّط Android لإعلانات Unity

الإصدار 4.12.2.0

  • تم التحقّق من التوافق مع الإصدار 4.12.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 23.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.12.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.12.1.0

  • تم التحقّق من التوافق مع الإصدار 4.12.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 23.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.12.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 4.12.0.0

  • تم التحقّق من التوافق مع الإصدار 4.12.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 23.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.12.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.11.3.0

  • تمّت إضافة ميزة تقديم عروض الأسعار لأشكال الإعلانات التالية: إعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة.
  • تم التحقّق من التوافق مع الإصدار 4.11.3 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 23.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.11.3 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 4.11.2.0

  • تم التحقّق من التوافق مع الإصدار 4.11.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 23.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.11.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 4.10.0.0

  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 23.0.0.
  • تم التحقّق من التوافق مع الإصدار 4.10.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 23.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.10.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 4.9.3.0

  • تم التحقّق من التوافق مع الإصدار 4.9.3 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 22.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.9.3 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.9.2.0

  • تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) لـ Unity Ads 4.9.2.

تم التصميم والاختبار باستخدام:

  • الإصدار 22.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.9.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.9.1.0

  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.3.0.
  • تم التحقّق من التوافق مع الإصدار 4.9.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 22.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.9.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 4.8.0.0

  • تسجيل مرة ظهور الإعلان عندما تستدعي حزمة Unity Ads SDK الإصدار الجديد onBannerShown() .
  • تم التحقّق من التوافق مع الإصدار 4.8.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 22.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.8.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.7.1.0

  • تم التحقّق من التوافق مع الإصدار 4.7.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 22.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.7.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.7.0.0

  • تم التحقّق من التوافق مع الإصدار 4.7.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 22.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.7.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.6.1.1

  • تم تعديل المحوّل لاستخدام فئة VersionInfo جديدة.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.0.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 22.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.6.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 4.6.1.0

  • تم التحقّق من التوافق مع الإصدار 4.6.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 21.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 4.6.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 4.6.0.0

  • تمت إضافة إمكانية إعادة توجيه معلومات قانون حماية خصوصية الأطفال على الإنترنت (COPPA) إلى حزمة تطوير البرامج (SDK) لإعلانات Unity Ads.
  • تم التحقّق من التوافق مع الإصدار 4.6.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.5.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 21.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 4.6.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.5.0.0

  • تم التحقّق من التوافق مع الإصدار 4.5.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.4.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 21.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 4.5.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.4.1.0

  • تم التحقّق من التوافق مع الإصدار 4.4.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 21.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 4.4.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 4.4.0.0

  • تم التحقّق من التوافق مع الإصدار 4.4.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.2.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 21.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 4.4.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.3.0.0

  • تم التحقّق من التوافق مع الإصدار 4.3.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تتم الآن إعادة توجيه طلب معاودة الاتصال "onAdOpened()" عند بدء تشغيل الإعلانات البينية والإعلانات التي تضم مكافأة.

تم التصميم والاختبار باستخدام:

  • الإصدار 21.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 4.3.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.2.1.1

  • تم تعديل compileSdkVersion وtargetSdkVersion إلى واجهة برمجة التطبيقات 31.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.0.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 21.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.2.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.2.1.0

  • تم التحقّق من التوافق مع الإصدار 4.2.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 20.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.2.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 4.1.0.0

  • تم التحقّق من التوافق مع الإصدار 4.1.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 20.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.1.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 4.0.1.0

  • تم التحقّق من التوافق مع الإصدار 4.0.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.6.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 20.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.0.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 4.0.0.0

  • تم التحقّق من التوافق مع الإصدار 4.0.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.5.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 20.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 4.0.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.7.5.0

  • تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) 3.7.5 من Unity Ads.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 20.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.7.5 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.7.4.0

  • تم التحقّق من التوافق مع الإصدار 3.7.4 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

تم التصميم والاختبار باستخدام:

  • الإصدار 20.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.7.4 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.7.2.0

  • تم التحقّق من التوافق مع الإصدار 3.7.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.2.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 20.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.7.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.7.1.0

  • تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) لـ Unity Ads 3.7.1.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.1.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 20.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.7.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.6.2.0

  • تم التحقّق من التوافق مع الإصدار 3.6.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تم إصلاح مشكلة كانت تتمثل في عدم إعادة توجيه استدعاءات النقر على الإعلانات التي تضم مكافأة.
  • تمت إزالة حزمة SDK لـ UnityAds من إصدار المحوِّل المجمّع. على الناشرين الآن تضمين حزمة تطوير البرامج (SDK) لـ UnityAds يدويًا كاعتمادية إضافية.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.8.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 19.8.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.6.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.6.0.0

  • تم التحقّق من التوافق مع الإصدار 3.6.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.6.0.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 19.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.6.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.5.1.1

  • تم إصلاح مشكلة كانت تحدث عند محاولة طلب عدة إعلانات بينية وإعلانات تضم مكافأة.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 19.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 3.5.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 3.5.1.0

  • تم التحقّق من التوافق مع الإصدار 3.5.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تم إصلاح مشكلة تسببت في إخفاق طلبات إعلانات البانر الذكية.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 19.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 3.5.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية

الإصدار 3.5.0.0

  • تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) لـ Unity Ads 3.5.0.
  • تمت إضافة دعم إعلانات البانر التكيُّفية.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.5.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 19.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.5.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.4.8.0

  • تم إصلاح خطأ NullPointerException الذي يحدث عند تلف إعلان البانر.
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.3.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 19.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.4.8 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.4.6.1

  • تم إنشاء إصدار محوّل لا يتضمّن حزمة تطوير البرامج (SDK) لإعلانات Unity. يمنح ذلك الناشرين خيارًا لاستخدام "خدمات Unity Ads" عند التوسط الانسجام لتجنب مشكلات التبعية المتعارضة.
    • ويجوز للناشرين اختيار استخدام هذه الميزة عن طريق تضمين تعتمد com.google.ads.mediation:unity-adapter-only:x.y.z.p على ملف build.gradle على مستوى التطبيق.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.4.6 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.4.6.0

  • تم التحقّق من التوافق مع الإصدار 3.4.6 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • يعيد المحوِّل الآن توجيه معاودة الاتصال onAdOpened() عند النقر على إعلان بانر.

تم التصميم والاختبار باستخدام:

  • الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.4.6 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.4.2.3

  • تمت إضافة رموز خطأ وصفية وأسباب تعذُّر تحميل/عرض المحوّل.
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.1.0.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.4.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.4.2.2

  • تم إصلاح مشكلة تعطُّل ConcurrentModificationException التي حدثت عندما تعرِض Unity Ads خطأً.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 19.0.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.4.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.4.2.1

  • تحسين إعادة توجيه أخطاء Unity للتعرّف على حالات تعذّر الإعداد وتحميل الإعلانات في وقت مبكر وتقليل حالات انتهاء المهلة
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.0.1.

تم التصميم والاختبار باستخدام:

  • الإصدار 19.0.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.4.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.4.2.0

  • تم التحقّق من التوافق مع الإصدار 3.4.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.3.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.4.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.4.0.0

  • تم التحقّق من التوافق مع الإصدار 3.4.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.3.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 3.4.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.3.0.0

  • تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) 3.3.0 من Unity Ads.

تم التصميم والاختبار باستخدام:

  • الإصدار 18.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 3.3.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity

الإصدار 3.2.0.1

  • تم إصلاح عطل استثناء المؤشر الفارغ الذي حدث عند استدعاء loadAd() قبل الاتصال بـ UnityAds.initialize().
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.2.0.

الإصدار 3.2.0.0

  • تم إصلاح مشكلة تسببت في إخفاق طلبات إعلانات البانر.
  • تم التحقّق من التوافق مع الإصدار 3.2.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • نقل المحوِّل إلى AndroidX
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.1.1.

الإصدار 3.1.0.0

  • دعم إضافي لأحجام إعلانات البانر المرنة.
  • يتعذّر على المحوّل تنفيذ طلب الإعلان في حال عدم توافق الحجم المطلوب. باستخدام أي أحجام لإعلانات Unity الإعلانية
  • تم التحقّق من التوافق مع الإصدار 3.1.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

الإصدار 3.0.1.0

  • تم التحقّق من التوافق مع الإصدار 3.0.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • إصلاح الخطأ الذي تسبَّب في عدم ظهور "NPE" مع عرض إعلان بيني

الإصدار 3.0.0.2

  • تم تعديل المحوِّل لتتوافق مع واجهة برمجة التطبيقات الجديدة والتجريبية المفتوحَين لعرض الإعلانات التي تضم مكافآت.
  • تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 17.2.0.

الإصدار 3.0.0.1

  • تمت إضافة دعم لبانر Unity Ads.

الإصدار 3.0.0.0

  • تم التحقّق من التوافق مع الإصدار 3.0.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

الإصدار 2.3.0.0

  • تم التحقّق من التوافق مع الإصدار 2.3.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

الإصدار 2.2.1.1

  • تم تعديل المحوِّل لاستدعاء حدث الإعلان "onRewardedVideoComplete()".

الإصدار 2.2.1.0

  • تم التحقّق من التوافق مع الإصدار 2.2.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

الإصدار 2.2.0.0

  • تم التحقّق من التوافق مع الإصدار 2.2.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

الإصدار

  • تم التحقّق من التوافق مع الإصدار 2.1.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

الإصدار 2.1.1.0

  • تم التحقّق من التوافق مع الإصدار 2.1.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

الإصدار 2.1.0.0

  • تم تعديل المحوّل ليصبح متوافقًا مع الإصدار 2.1.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

الإصدار 2.0.8.0

  • تم التحقّق من التوافق مع الإصدار 2.0.8 من حزمة تطوير البرامج (SDK) لإعلانات Unity.

الإصدار 2.0.7.0

  • استخدام تقارير النقرات في Unity Ads (ستتطابق إحصاءات النقرات في AdMob وUnity Ads).
  • تمت إضافة دعم معاودة الاتصال onAdLeftApplication.

الإصدار 2.0.6.0

  • تم التحقّق من التوافق مع الإصدار 2.0.6 من حزمة تطوير البرامج (SDK) لـ Unity Ads.

الإصدار 2.0.5.0

  • يمكن الآن إضافة المحوّلات كتبعية تجميع عن طريق إضافة ما يلي: إلى علامة التبعيات لملف Build.gradle: compile 'com.google.ads.mediation:unity:2.0.5.0'
  • تم النقل إلى توزيع المحوّل بتنسيق aar بدلاً من ملف jar. (انظر README للحصول على إرشادات إضافية).

الإصدار 2.0.4.0

  • تم إصلاح خطأ تسبّب في تعذُّر تحميل إعلانات الفيديو التي تضم مكافأة عند تم تحميل الإعلان البيني أولاً.

الإصدار 2.0.2.0

  • تم تغيير نظام تسمية الإصدار إلى [إصدار حزمة تطوير البرامج (SDK) لإعلانات Unity][إصدار رمز تصحيح مُعدَّل].
  • تم تحديث الحد الأدنى المطلوب لحزمة تطوير البرامج (SDK) لإعلانات Unity إلى الإصدار 2.0.2.
  • تم تحديث الحد الأدنى المطلوب لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة إلى الإصدار 9.0.0.
  • لم تعُد التطبيقات بحاجة إلى استدعاء UnityAds.changeActivity(this).

الإصدار 1.0.0

  • الإصدار الأولي. يدعم إعلانات الفيديو القائمة على المكافآت والإعلانات البينية.