يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض إعلانات من Unity Ads باستخدام التوسّط، التي تغطي عمليات دمج الشلال. يتناول كيفية إضافة إعلانات Unity إلى إعلان إعدادات التوسّط وكيفية دمج المحوّل وحزمة تطوير البرامج (SDK) لمنصة Unity Ads في تطبيق Android
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمّن محوِّل التوسّط في Unity Ads الإمكانات التالية:
الدمج | ||
---|---|---|
عروض الأسعار | 1 | |
شلال | ||
التنسيقات | ||
بانر | ||
إعلان بيني | ||
تم منح المكافأة | ||
مدمجة مع المحتوى |
المتطلبات
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
إكمال عملية التوسّط دليل البدء
الخطوة 1: إعداد الإعدادات في واجهة مستخدم Unity Ads
اشترِك أو سجِّل الدخول إلى Unity Ads.
إنشاء مشروع
في لوحة بيانات Unity Ads، انتقِل إلى المشاريع وانقر على إنشاء مشروع.
املأ النموذج وانقر على إنشاء مشروع لإضافة مشروعك.
انتقِل إلى تحقيق الربح > البدء، ثمّ انقر على البدء.
في نموذج إعداد المشروع، اختَر أخطّط لاستخدام التوسّط وGoogle Admob بالنسبة إلى شريك التوسّط، ثمّ انقر على التالي.
اختَر إعدادات الإعلانات، ثم انقر على التالي.
املأ النموذج ثم انقر على إضافة مشروع.
دوِّن رقم تعريف اللعبة.
إنشاء وحدة إعلانية
انتقِل إلى تحقيق الربح > الوحدات الإعلانية، ثم انقر على إضافة وحدة إعلانية.
أدخِل اسم الوحدة الإعلانية، ثم اختَر النظام الأساسي وشكل الإعلان.
أخيرًا، انقر على إنشاء لحفظ وحدتك الإعلانية.
إضافة موضع إعلان
بعد إنشاء المشروع، انتقِل إلى تحقيق الربح > مواضع الإعلانات. لإنشاء موضع إعلان جديد، انقر على إضافة موضع لوحدتك الإعلانية.
املأ التفاصيل اللازمة وانقر على إضافة موضع إعلان.
دوِّن رقم تعريف موضع الإعلان.
العثور على مفتاح واجهة برمجة التطبيقات لإعداد التقارير في Unity Ads
عروض الأسعار
وهذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
بالإضافة إلى رقم تعريف اللعبة ورقم تعريف موضع الإعلان، ستحتاج أيضًا إلى مفتاح واجهة برمجة التطبيقات والمعرّف الأساسي للمؤسسة لإعداد Ad Manager رقم تعريف الوحدة الإعلانية.
انتقِل إلى تحقيق الربح > الإعداد > إدارة واجهة برمجة التطبيقات ودوّن مفتاح الوصول إلى واجهة برمجة التطبيقات لإحصاءات تحقيق الربح.
بعد ذلك، انتقِل إلى تحقيق الربح > إعدادات المؤسسة ودوِّن رقم التعريف الأساسي للمؤسسة.
تفعيل وضع الاختبار
يمكن تفعيل وضع الاختبار من لوحة بيانات Unity Ads. ضمن إعدادات مشروعك، اختَر علامة التبويب اختبار.
يمكنك فرض وضع الاختبار على تطبيقك من خلال النقر على زر التعديل بجانب متجر Google Play ثم وضع علامة في المربّع إلغاء وضع اختبار العميل واختيار فرض وضع الاختبار مفعَّل (أي استخدام الإعلانات الاختبارية) على جميع الأجهزة.
بدلاً من ذلك، يمكنك تفعيل وضع الاختبار لأجهزة محدّدة من خلال النقر على الزر إضافة جهاز اختباري.
املأ النموذج وانقر على حفظ.
الخطوة 2: إعداد طلب Unity Ads في Ad Manager واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
سجِّل الدخول إلى حسابك على "مدير الإعلانات".
انتقِل إلى عرض الإعلانات > مجموعات الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة الشبكات الإعلانية المدِرّة للأرباح جديدة.
أدخِل اسمًا فريدًا لمجموعة الشبكات الإعلانية المدِرّة للأرباح، واضبط الحالة على نشط، واختَر شكل الإعلان، واضبط نوع المستودع على تطبيق متوافق مع الأجهزة الجوّالة. ضمن قسم الاستهداف > المستودع، اختَر الوحدة الإعلانية ضمن المستودع وتطبيق الأجهزة الجوّالة التي تريد إضافة توسّط إليها.
بعد ذلك، انقر على الزر إضافة شريك أرباح.
إذا كان لديك شريك أرباح في Unity Ads، يمكنك اختياره. إذا لم يكن لديك حساب، اختَر إنشاء شريك جديد لتحقيق الأرباح.
اختَر Unity Ads باعتبارها شبكة الإعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط.
فعِّل الجمع التلقائي للبيانات، وأدخِل API Key and Organization core ID الذي تم الحصول عليه في القسم السابق.
بعد اختيار الشريك المحقِّق للأرباح، اختر توسّط حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وAndroid باعتبارها النظام الأساسي، ونشط كالحالة. أدخِل Game ID and Placement ID الذي تم الحصول عليه في القسم السابق. ثم أدخِل قيمة التكلفة التلقائية لكل ألف ظهور.
انقر على حفظ في أسفل الصفحة عند الانتهاء.
إضافة Unity Ads إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة Unity Ads إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في Ad Manager واجهة المستخدم.
الخطوة 3: استيراد المحوّل وحزمة تطوير البرامج (SDK) من Unity Ads
الدمج مع "استوديو Android" (يُنصح به)
في ملف 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")
}
الدمج اليدوي
يمكنك تنزيل أحدث حزمة تطوير برامج (SDK) لإعلانات Unity (
unity-ads.aar
) من مستودع GitHub وإضافته إلى مشروعك.الانتقال إلى عناصر محوّل Unity Ads على مستودع Maven من Google. اختَر أحدث إصدار ونزِّل Unity ملف
.aar
لمحوّل الإعلانات، وإضافته إلى مشروعك.
الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية
موافقة المستخدمين في الاتحاد الأوروبي واللائحة العامة لحماية البيانات
بموجب موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google السياسة، يجب التأكّد من الإفصاح عن معلومات معيّنة الموافقات التي تم الحصول عليها من المستخدمين في المنطقة الاقتصادية الأوروبية في ما يتعلق استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية و"حماية البيانات العامة" اللائحة (اللائحة العامة لحماية البيانات). عند طلب الحصول على موافقة، عليك تحديد كل شبكة إعلانات. في سلسلة التوسط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها تقدم معلومات حول استخدام كل شبكة. يتعذّر على Google حاليًا إجراء ما يلي: تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
في الإصدار 2.0.0 من حزمة تطوير البرامج (SDK)، أضافت Unity Ads واجهة برمجة تطبيقات لإتاحة إعدادات الخصوصية. تشير رسالة الأشكال البيانية يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة هذه إلى Unity حزمة تطوير البرامج (SDK) لعرض الإعلانات في حال اختيار إرسال معلومات الموافقة إلى حزمة تطوير البرامج (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 واجهة برمجة تطبيقات لإتاحة إعدادات الخصوصية. تشير رسالة الأشكال البيانية يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة هذه إلى Unity حزمة تطوير البرامج (SDK) لعرض الإعلانات في حال اختيار إرسال معلومات الموافقة إلى حزمة تطوير البرامج (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 بالحالة ERROR. |
200-204 | حدث خطأ متعلق ببانر UnityAds. الاطّلاع على الرمز لمزيد من التفاصيل. |
0-9 | حدث خطأ في حزمة UnityAds SDK. اطّلِع على مستندات Unity. لمزيد من التفاصيل. |
101 | مَعلمات خادم UnityAds التي تم ضبطها في واجهة المستخدم Ad Manager غير متوفّرة أو غير صالحة. |
102 | الجهاز غير متوافق مع UnityAds. |
103 | انتهت UnityAds من مشاركة العرض مع ظهور حالة الخطأ kUnityAdsFinishStateError. |
104 | يكون عنصر إعلان Unity فارغًا بعد طلب أداة الإعداد. |
105 | تعذّر عرض إعلانات Unity لأنّ الإعلان غير جاهز. |
106 | غيَّرت UnityAds استدعاء موضع الإعلان باستخدام حالة الموضع kUnityAdsPositionStateNoFill. |
107 | غيَّرت شركة UnityAds استدعاء موضع الإعلان إلى استدعاء حالة الموضع kUnityAdsPositionStateDisabled. |
108 | سبق أن تم تحميل إعلان لهذا الموضع. لا تتيح حزمة UnityAds SDK تحميل إعلانات متعدّدة لموضع الإعلان نفسه. |
سجلّ تغييرات محوّل توسّط 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
- تم التحقّق من التوافق مع الإصدار 4.9.2 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
تم التصميم والاختبار باستخدام:
- الإصدار 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
- تم التحقّق من التوافق مع الإصدار 3.7.5 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
تم التصميم والاختبار باستخدام:
- الإصدار 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
- تم التحقّق من التوافق مع الإصدار 3.7.1 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "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
- تم التحقّق من التوافق مع الإصدار 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 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
- تم التحقّق من التوافق مع الإصدار 3.3.0 من حزمة تطوير البرامج (SDK) لإعلانات Unity.
تم التصميم والاختبار باستخدام:
- الإصدار 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 من حزمة تطوير البرامج (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.
الإصدار 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
- الإصدار الأولي. يدعم إعلانات الفيديو القائمة على المكافآت والإعلانات البينية.