دمج Unity Ads مع التوسّط

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

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

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

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

1 إنّ عملية دمج عروض الأسعار قيد الاختبار المغلق، ويمكنك التواصل مع مدير حسابك لطلب الوصول إلى هذه الميزة.

المتطلبات

  • المستوى 21 أو إصدار أحدث من واجهة برمجة التطبيقات لنظام التشغيل Android

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

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

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

اشترِك أو سجِّل الدخول إلى Unity Ads.

إنشاء مشروع

في لوحة بيانات Unity Ads، انتقِل إلى المشاريع وانقر على إنشاء مشروع.

املأ النموذج وانقر على إنشاء مشروع لإضافة مشروعك.

انتقِل إلى تحقيق الربح > البدء، ثمّ انقر على البدء.

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

اختَر إعدادات إعلاناتك، ثم انقر على التالي.

املأ النموذج، ثم انقر على إضافة مشروع.

سجِّل معرّف اللعبة.

إنشاء وحدة إعلانية

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

أدخِل اسم الوحدة الإعلانية، ثم اختَر النظام الأساسي وشكل الإعلان.

أخيرًا، انقر على إنشاء لحفظ وحدتك الإعلانية.

إضافة موضع إعلان

عروض الأسعار

تواصَل مع مدير حسابك في Google لإنشاء مواضع إعلانات عروض الأسعار.

شلال

بعد إنشاء المشروع، انتقِل إلى تحقيق الربح > مواضع الإعلانات. ل إنشاء موضع إعلان جديد، انقر على إضافة موضع إعلان لوحدتك الإعلانية.

املأ التفاصيل اللازمة وانقر على إضافة موضع إعلان.

دوِّن معرّف موضع الإعلان.

تحديد موضع مفتاح Unity Ads Reporting API

عروض الأسعار

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

شلال

بالإضافة إلى رقم تعريف اللعبة ورقم تعريف موضع الإعلان، ستحتاج أيضًا إلى مفتاح واجهة برمجة التطبيقات ورقم التعريف الأساسي للمؤسسة في Unity Ads لإعداد رقم تعريف الوحدة الإعلانية في AdMob.

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

بعد ذلك، انتقِل إلى تحقيق الربح > إعدادات المؤسسة ودوِّن رقم تعريف المؤسسة الأساسي.

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

يمكن تفعيل وضع "الاختبار" من لوحة بيانات Unity Ads. ضمن إعدادات مشروعك، انقر على علامة التبويب الاختبار.

يمكنك فرض وضع الاختبار لتطبيقك من خلال النقر على زر التعديل بجانب متجر Google Play ، ثم تحديد إلغاء وضع اختبار العميل واختيار فرض تفعيل وضع الاختبار (أي استخدام الإعلانات الاختبارية) على جميع الأجهزة.

بدلاً من ذلك، يمكنك تفعيل وضع الاختبار لأجهزة معيّنة من خلال النقر على الزر إضافة جهاز اختباري.

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

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

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

عليك إضافة Unity Ads إلى إعداد التوسّط لوحدتك الإعلانية.

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

لإنشاء مجموعة توسّط جديدة، اختَر إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصّة، ثمّ انقر على متابعة.

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

اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية AdMob الحالية. بعد ذلك، انقر على تمّ.

من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية التي تمت تعبئتها بالوحدات الإعلانية التي حدّدتها:

إضافة Unity Ads كمصدر إعلان

عروض الأسعار

ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، اختَر إضافة مصدر الإعلان: بعد ذلك، اختَر Unity Ads.

انقر على كيفية توقيع اتّفاقية شراكة وإعداد عروض أسعار. بالشراكة مع Unity Ads

انقر على إقرار و "أوافق"، ثم انقر على متابعة.

إذا كان لديك تعيين من قبل لـ Unity Ads، فيمكنك تحديدها. بخلاف ذلك، انقر على إضافة عملية ربط.

بعد ذلك، أدخِل Game ID and Placement ID التي حصلت عليها في القسم السابق. بعد ذلك، انقر على تمّ.

شلال

ضمن بطاقة منهجية الشلال في قسم مصادر الإعلانات، اختَر إضافة مصدر الإعلان. بعد ذلك، اختَر Unity Ads.

اختَر Unity Ads وفعِّل مفتاح تبديل تحسين. أدخِل API Key and Organization core ID الذي تم الحصول عليه في القسم السابق من أجل إعداد تحسين مصدر الإعلان للحملة Unity Ads. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور للسمةUnity Ads وانقر على متابعة.

إذا كان لديك تعيين بالفعل لـ Unity Ads، يمكنك تحديده. بخلاف ذلك، انقر على إضافة تعيين.

بعد ذلك، أدخِل Game ID and Placement ID التي تم الحصول عليها في القسم السابق. بعد ذلك، انقر على تمّ.

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.unity3d.ads:unity-ads:4.12.4")
    implementation("com.google.ads.mediation:unity:4.12.4.0")
}

الدمج اليدوي

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

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

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

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

في الإصدار 2.0.0 من حزمة تطوير البرامج (SDK)، أضافت Unity Ads واجهة برمجة تطبيقات لتتوافق مع إعدادات الخصوصية. يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة هذه إلى حزمة تطوير البرامج (SDK) الخاصة بـ Unity Ads. إذا اخترت تمرير معلومات الموافقة إلى حزمة تطوير البرامج (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()

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

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

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

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

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

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

إثبات صحة الإعلانات الاختبارية

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

رموز الخطأ

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

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

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

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

سجلّ التغييرات في أداة التوسّط لنظام التشغيل Android في Unity Ads

الإصدار 4.12.4.0

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

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

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

الإصدار 4.12.3.0

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

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

  • الإصدار 23.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 4.12.3 من حزمة تطوير البرامج (SDK) لإعلانات 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

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

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

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

الإصدار 4.11.2.0

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

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

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

الإصدار 4.10.0.0

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

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

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

الإصدار 4.9.3.0

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

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

  • الإصدار 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.
  • تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) لـ Unity Ads 4.9.1.

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

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

الإصدار 4.8.0.0

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

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

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

الإصدار 4.7.1.0

  • تم التحقّق من التوافق مع حزمة Unity Ads SDK 4.7.1.

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

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

الإصدار 4.7.0.0

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

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

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

  • تم التحقّق من التوافق مع حزمة Unity Ads SDK 4.6.1.

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

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

الإصدار 4.6.0.0

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

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

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

الإصدار 4.5.0.0

  • تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) 4.5.0 لإعلانات 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

  • تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) 4.4.0 من Unity Ads.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "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

  • تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) 4.0.0 من Unity Ads.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "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

  • تم التحقّق من التوافق مع حزمة Unity Ads SDK 3.7.4.

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

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

الإصدار 3.7.2.0

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

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

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

الإصدار 3.7.1.0

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

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

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

الإصدار 3.6.2.0

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

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

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

الإصدار 3.6.0.0

  • تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) 3.6.0 من Unity Ads.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "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

  • تم التحقّق من التوافق مع الإصدار 3.5.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
  • تمت إضافة ميزة إعلانات البانر التكيُّفية.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "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" عند التوسّط على Unity لتجنّب مشاكل الاعتماد المتضارب.
    • ويمكن للناشرين اختيار استخدام هذه الميزة من خلال تضمين اعتماد 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 Ads.
  • يعيد المُحوِّل الآن توجيه طلب إعادة الاتصال 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

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

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

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

الإصدار 3.4.0.0

  • تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) 3.4.0 لـ Unity Ads.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "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 Ads.
  • تم ترحيل المحوّل إلى AndroidX.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.1.1.

الإصدار 3.1.0.0

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

الإصدار 3.0.1.0

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

الإصدار 3.0.0.2

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

الإصدار 3.0.0.1

  • تمت إضافة إمكانية استخدام بانر Unity Ads.

الإصدار 3.0.0.0

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

الإصدار 2.3.0.0

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

الإصدار 2.2.1.1

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

الإصدار 2.2.1.0

  • تم التحقّق من التوافق مع حزمة Unity Ads SDK 2.2.1.

الإصدار 2.2.0.0

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

الإصدار 2.1.2.0

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

الإصدار 2.1.1.0

  • تم التحقّق من التوافق مع حزمة Unity Ads SDK 2.1.1.

الإصدار 2.1.0.0

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

الإصدار 2.0.8.0

  • تم التحقّق من التوافق مع حزمة Unity Ads SDK 2.0.8.

الإصدار 2.0.7.0

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

الإصدار 2.0.6.0

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

الإصدار 2.0.5.0

  • يمكن الآن إضافة المحوِّلات كعنصر ربط للترجمة من خلال إضافة ما يلي إلى علامة dependencies في ملف 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][adapter code version].
  • تم تعديل الحد الأدنى المطلوب من حزمة تطوير البرامج (SDK) لـ Unity Ads إلى الإصدار 2.0.2.
  • تم تعديل الحدّ الأدنى المطلوب من الإصدار 9.0.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.
  • لم تعُد التطبيقات بحاجة إلى استدعاء UnityAds.changeActivity(this).

الإصدار 1.0.0

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