يوضّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" لتحميل adverts وعرضها من Liftoff Monetize باستخدام توسّط AdMob، ويشمل ذلك دمج كلّ من عروض الأسعار والعرض الإعلاني بدون انقطاع. ويتناول هذا الدليل كيفية إضافة ميزة Android تحقيق الربح من Liftoff إلى إعدادات التوسّط للوحدة الإعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوِّل Vungle في Android التطبيق.
عمليات الدمج وأشكال الإعلانات المتوافقة
يتضمّن محوِّل التوسّط في Liftoff Monetize الإمكانات التالية:
التكامل | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
إعلان على شاشة فتح التطبيق | 1، 2 |
بانر | 1 |
إعلان بيني | |
تم منح المكافأة | |
إعلان بيني يضم مكافأة | 1 |
مدمجة مع المحتوى | 1، 2 |
1 ميزة دمج عروض الأسعار لهذا التنسيق متوفّرة في إصدار تجريبي مفتوح.
2 لا يزال دمج منهجية الشلال لهذا الشكل في إصدار تجريبي مفتوح.
المتطلبات
المستوى 21 أو إصدار أحدث من واجهة برمجة التطبيقات لنظام التشغيل Android
[لعروض الأسعار]: محوِّل Liftoff Monetize 6.11.0.2 أو إصدار أحدث (ننصح باستخدام أحدث إصدار)
أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
إكمال التوسّط دليل البدء
الخطوة 1: إعداد الإعدادات في واجهة مستخدم Liftoff Monetize
اشترِك أو سجِّل الدخول إلى حسابك على Liftoff Monetize.
أضِف تطبيقك إلى لوحة بيانات تحقيق الربح من Liftoff من خلال النقر على الزر إضافة تطبيق.
املأ النموذج مع إدخال جميع التفاصيل المطلوبة.
بعد إنشاء التطبيق، اختَره من لوحة بيانات Liftoff MonetizeApplication
سجِّل رقم تعريف التطبيق.
إضافة مواضع إعلان جديدة
لإنشاء موضع إعلان جديد لاستخدامه مع توسّط AdMob، انتقِل إلى لوحة بيانات "مواضع الإعلانات لتحقيق الربح" في Liftoff، ثم انقر على الزر إضافة موضع إعلان واختَر تطبيقك من القائمة المنسدلة.
في ما يلي تفاصيل إضافة مواضع إعلانات جديدة:
إعلان على شاشة فتح التطبيق
اختر إعلان بيني وأدخِل اسم موضع الإعلان. بعد ذلك، اختَر نعم من أجل الإعلانات القابلة للتخطّي واملأ ما تبقّى من النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل مفتاح التبديل عروض الأسعار داخل التطبيق على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
بانر
اختَر إعلان بانر، وأدخِل اسم موضع الإعلان واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق بوضعه على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
بانر مقاس 300×250
اختَر MREC، وأدخِل اسم موضع الإعلان واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق بوضعه على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء الموضع.
إعلان بيني
اختَر إعلان بيني، وأدخِل اسم موضع الإعلان، ثم املأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح عروض الأسعار داخل التطبيق إلى مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
تم منح المكافأة
اختَر إعلان بمكافأة، وأدخِل اسم موضع الإعلان واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح عروض الأسعار داخل التطبيق إلى مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
إعلان بيني يضم مكافأة
اختَر إعلانات مقابل مكافأة. أدخِل اسم موضع الإعلان، وفعِّل الخيار قابل للتخطي واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح التبديل عروض الأسعار داخل التطبيق إلى مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
مدمجة مع المحتوى
اختَر إعلان مدمج مع المحتوى، وأدخِل اسم موضع الإعلان واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق بوضعه على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
سجِّل رقم تعريف المرجع وانقر على حسنًا.
فتح التطبيق
بانر
بانر مقاس 300×250
إعلان بيني
تم منح المكافأة
إعلان بيني يضمّ مكافأة
مدمجة مع المحتوى
تحديد مكان مفتاح Reporting API
عروض الأسعار
هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
بالإضافة إلى معرّف التطبيق ومعرّف المرجع، ستحتاج أيضًا إلى مفتاح Reporting API في Liftoff Monetize لإعداد رقم تعريف الوحدة الإعلانية في AdMob. انتقِل إلى لوحة بيانات تقارير Liftoff Monetize وانقر على الزر مفتاح Reporting API للاطّلاع على مفتاح Reporting API .
تفعيل وضع الاختبار
لتفعيل الإعلانات الاختبارية، انتقِل إلى لوحة بيانات Liftoff Monetize وانتقِل إلى التطبيقات.
اختَر التطبيق الذي تريد تفعيل الإعلانات الاختبارية له ضمن قسم رقم تعريف مرجع موضع الإعلان في تطبيقك. يمكن تفعيل الإعلانات الاختبارية عن طريق اختيار وضع الاختبار على عرض الإعلانات الاختبارية فقط ضمن قسم الحالة.
الخطوة 2: إعداد طلب تحقيق الربح من Liftoff في AdMob واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
عليك إضافة Liftoff Monetize إلى إعداد التوسّط لوحدتك الإعلانية.
أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط لتعديلها، ثم انتقِل مباشرةً إلى إضافة Liftoff Monetize كمصدر إعلان.
لإنشاء مجموعة توسّط جديدة، اختَر إنشاء مجموعة توسّط.
أدخِل شكل الإعلان والمنصّة، ثمّ انقر على متابعة.
أدخِل اسمًا لمجموعة التوسّط، واختَر مواقع جغرافية لاستهدافها. بعد ذلك، اضبط حالة مجموعة التوسّط على مفعَّلة، ثمّ انقر على إضافة وحدات إعلانية.
اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية AdMob الحالية. بعد ذلك، انقر على تمّ.
من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية التي تمت تعبئتها بالوحدات الإعلانية التي حدّدتها:
إضافة Liftoff Monetize كمصدر إعلان
عروض الأسعار
ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، اختَر إضافة مصدر الإعلان: بعد ذلك، اختَر Liftoff Monetize.
انقر على كيفية توقيع اتّفاقية شراكة وإعداد عروض أسعار. بالشراكة مع Liftoff Monetize
انقر على إقرار و "أوافق"، ثم انقر على متابعة.
إذا كان لديك تعيين من قبل لـ Liftoff Monetize، فيمكنك تحديدها. بخلاف ذلك، انقر على إضافة عملية ربط.
بعد ذلك، أدخِل Application ID and Placement Reference ID التي حصلت عليها في القسم السابق. بعد ذلك، انقر على تمّ.
شلال
ضمن بطاقة منهجية الشلال في قسم مصادر الإعلانات، اختَر إضافة مصدر الإعلان. بعد ذلك، اختَر Liftoff Monetize.
اختَر Liftoff Monetize وفعِّل مفتاح تبديل تحسين. أدخِل Reporting API Key الذي تم الحصول عليه في القسم السابق من أجل إعداد تحسين مصدر الإعلان للحملة Liftoff Monetize. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور للسمةLiftoff Monetize وانقر على متابعة.إذا كان لديك تعيين بالفعل لـ Liftoff Monetize، يمكنك تحديده. بخلاف ذلك، انقر على إضافة تعيين.
بعد ذلك، أدخِل Application ID and Placement Reference ID التي تم الحصول عليها في القسم السابق. بعد ذلك، انقر على تمّ.
إضافة Liftoff إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات "اللائحة العامّة لحماية البيانات" (GDPR) و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Liftoff إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية في واجهة مستخدِم AdMob.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوِّل Vungle
الدمج مع "استوديو Android" (يُنصح به)
في ملف build.gradle.kts
على مستوى التطبيق، أضِف الإعدادات التالية
للتبعيات والإعدادات. استخدِم أحدث إصدارات من حزمة تطوير البرامج (SDK)
ومحوِّل Vungle:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.google.ads.mediation:vungle:7.4.1.0")
}
الدمج اليدوي
نزِّل أحدث إصدار من حزمة تطوير برامج Vungle لنظام التشغيل Android واستخرِج ملفات
.jar
ضمن المجلدlibs
وأضِفها إلى مشروعك.انتقِل إلى عناصر محوِّل Liftoff Monetize في مستودع Maven التابع لشركة Google. اختَر أحدث إصدار، ونزِّل ملف
.aar
الخاص بمحوِّل Vungle ، وأضِفه إلى مشروعك.
الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة تطوير البرامج (SDK) من Liftoff Monetize
موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامّة لحماية البيانات"
بموجب سياسة موافقة المستخدِم في الاتّحاد الأوروبي المتّبَعة في Google، عليك التأكّد من تقديم بيانات الإفصاح المعيّنة إلى المستخدِمين في المنطقة الاقتصادية الأوروبية والحصول على موافقاتهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تراعي هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR). عند طلب الموافقة، عليك تحديد كل شبكة إعلانية في سلسلة التوسّط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، و تقديم معلومات عن استخدام كل شبكة. لا يمكن لشركة Google حاليًا تمرير اختيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
يتضمن Liftoff Monetize واجهة برمجة تطبيقات تتيح لك تمرير الموافقة إلى Vungle SDK. يوضّح الرمز البرمجي النموذجي التالي كيفية تمرير معلومات الموافقة هذه إلى حزمة SDK من Vungle. إذا اخترت استدعاء هذه الطريقة، ننصحك بإجراء ذلك قبل طلب الإعلانات من خلال حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
Java
import com.vungle.ads.VunglePrivacySettings;
// ...
VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");
Kotlin
import com.vungle.ads.VunglePrivacySettings
// ...
VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")
يمكنك الاطّلاع على تعليمات التنفيذ المقترَحة بموجب اللائحة العامة لحماية البيانات (GDPR) لمعرفة مزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.
قوانين الخصوصية في الولايات الأمريكية
قوانين الخصوصية في الولايات الأمريكية تتطلّب منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يوفّر دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية إمكانية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات على Google، ولكن يتعذّر على Google تطبيق هذا الإعداد على كل شبكة إعلانات في سلسلة التوسط. لذلك، عليك تحديد كل شبكة مواقع إعلانية في سلسلة التوسّط التي قد تشارك في بيع المَعلومات الشخصية واتباع الإرشادات الواردة من كلّ من هذه الشبكات لضمان الامتثال.
تتضمّن Liftoff Monetize واجهة برمجة تطبيقات تتيح لك تمرير الموافقة إلى حزمة تطوير البرامج (SDK) من Vungle. يوضّح الرمز البرمجي النموذجي التالي كيفية تمرير معلومات الموافقة هذه إلى حزمة SDK من Vungle. إذا اخترت استدعاء هذه الطريقة، ننصحك بإجراء ذلك قبل طلب الإعلانات من خلال حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
Java
import com.vungle.ads.VunglePrivacySettings;
// ...
VunglePrivacySettings.setCCPAStatus(true);
Kotlin
import com.vungle.ads.VunglePrivacySettings
// ...
VunglePrivacySettings.setCCPAStatus(true)
اطّلِع على تنفيذ قانون CCPA لمزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.
الخطوة 5: إضافة الرمز المطلوب
ما مِن رمز إضافي مطلوب لدمج Liftoff Monetize.
الخطوة 6: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم Liftoff Monetize.
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من Liftoff Monetize، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصدرَي الإعلانات Liftoff Monetize (عروض الأسعار) وLiftoff Monetize (العرض بدون انقطاع).
الخطوات الاختيارية
المَعلمات المتعلّقة بالشبكة
يتيح محوِّل Liftoff Monetize معلَمات الطلب الإضافية التالية التي يمكن تمريرها إلى المحوِّل:
userId
- سلسلة تمثّل رقم تعريف المستخدم المحفَّز الخاص بـ Liftoff Monetize
adOrientation
- عدد صحيح يحدّد اتجاه العرض للإعلانات التي تظهر بملء الشاشة.
في ما يلي مثال على رمز لكيفية إنشاء طلب إعلان يضبط هذه المَعلمات:
Java
Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
.build();
Kotlin
val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
val request = AdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
.build()
عرض الإعلانات المدمجة مع المحتوى
يعرض محوِّل Liftoff Monetize إعلاناته المدمجة مع المحتوى على هيئة عناصر
NativeAd
. وتعبِّئ هذه السمة
حقول أوصاف الإعلانات المدمجة مع المحتوى
لملف شخصي على
NativeAd
.
الحقل | مواد العرض التي يتم تضمينها دائمًا من خلال محوِّل Liftoff Monetize |
---|---|
العنوان | |
صورة | 1 |
عرض الوسائط | |
الجسم | |
رمز التطبيق | |
الحث على اتخاذ إجراء | |
التقييم النجمي | |
المتجر | |
السعر |
1 لا يقدّم محوِّل
Liftoff Monetize إمكانية الوصول مباشرةً إلى مادة عرض الصورة الرئيسية للإعلانات المدمجة
. بدلاً من ذلك، يملؤه المحوِّل بالرمز
MediaView
في حال عدم توفّر فيديو أو صورة.
رموز الخطأ
في حال تعذّر على المحوّل تلقّي إعلان من Liftoff Monetize، يمكن للناشرين
التحقّق من الخطأ الأساسي في استجابة الإعلان باستخدام
ResponseInfo.getAdapterResponses()
ضمن الفئات التالية:
التنسيق | اسم الصف |
---|---|
فتح التطبيق (عروض الأسعار) | com.google.ads.mediation.vungle.VungleMediationAdapter |
فتح التطبيق (شلال) | com.google.ads.mediation.vungle.VungleMediationAdapter |
بانر (عروض الأسعار) | com.google.ads.mediation.vungle.VungleMediationAdapter |
بانر (معروض بدون انقطاع) | com.vungle.mediation.VungleInterstitialAdapter |
الإعلانات البينية (عروض الأسعار) | com.google.ads.mediation.vungle.VungleMediationAdapter |
الإعلانات البينية (شلال) | com.vungle.mediation.VungleInterstitialAdapter |
إعلانات تضمّ مكافأة (عروض الأسعار) | com.google.ads.mediation.vungle.VungleMediationAdapter |
إعلانات تضمّ مكافأة (مُعدّة للعرض بدون انقطاع) | com.vungle.mediation.VungleAdapter |
إعلان بيني يضمّ مكافأة (عروض الأسعار) | com.google.ads.mediation.vungle.VungleMediationAdapter |
إعلان بيني يضمّ مكافأة (العرض بدون انقطاع) | com.google.ads.mediation.vungle.VungleMediationAdapter |
إعلانات مدمَجة مع المحتوى (عروض الأسعار) | com.google.ads.mediation.vungle.VungleMediationAdapter |
إعلانات مدمَجة مع المحتوى (العرض الإعلاني الانحداري) | com.google.ads.mediation.vungle.VungleMediationAdapter |
في ما يلي الرموز والرسائل المصاحبة التي تظهر في محوّل Liftoff Monetize عند تعذّر تحميل أحد الإعلانات:
رمز الخطأ | النطاق | السبب |
---|---|---|
101 | com.google.ads.mediation.vungle | مَعلمات الخادم غير صالحة (مثل رقم تعريف التطبيق أو رقم تعريف موضع الإعلان) |
102 | com.google.ads.mediation.vungle | لا يتطابق حجم البانر المطلوب مع حجم إعلان Liftoff Monetize صالح. |
103 | com.google.ads.mediation.vungle | تتطلّب ميزة Liftoff Monetize Activity سياقًا لطلب
إعلانات. |
104 | com.google.ads.mediation.vungle | لا يمكن لحزمة تطوير البرامج (SDK) من Vungle تحميل إعلانات متعدّدة لمعرّف موضع الإعلان نفسه. |
105 | com.google.ads.mediation.vungle | تعذّر إعداد حزمة تطوير البرامج (SDK) من Vungle. |
106 | com.google.ads.mediation.vungle | عرضت Vungle SDK استدعاء تحميل ناجحًا، ولكن Banners.getBanner() أو Vungle.getNativeAd() عرضا قيمة فارغة. |
107 | com.google.ads.mediation.vungle | حزمة تطوير البرامج (SDK) من Vungle غير جاهزة لتشغيل الإعلان. |
108 | com.google.ads.mediation.vungle | عرضت حزمة تطوير البرامج (SDK) من Vungle رمزًا مميزًا غير صالح لعروض الأسعار. |
بالنسبة إلى الأخطاء الواردة من Vungle SDK، يُرجى الرجوع إلى رموز الخطأ: Vungle SDK لنظامي التشغيل iOS وAndroid.
سجلّ التغييرات في أداة التوسّط لنظام التشغيل Android في Liftoff Monetize
الإصدار 7.4.1.0
- تم إثبات التوافق مع الإصدار 7.4.1 من حزمة تطوير البرامج (SDK) من Vungle.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 23.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 7.4.1 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 7.4.0.1
- تمت إضافة ميزة تتيح استخدام أحجام إعلانات مخصّصة لعروض الأسعار والإعلانات البانر للعرض الإعلاني بدون انقطاع.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 23.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 7.4.0 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 7.4.0.0
- تمّت توسيع فئة
VungleInterstitialAdapter
منVungleMediationAdapter
لإضافة ميزة العرض الإعلاني بدون انقطاع لتنسيق الإعلان المفتوح في التطبيق على "مدير إعلانات Google". - تم التحقّق من التوافق مع الإصدار 7.4.0 من حزمة تطوير البرامج (SDK) من Vungle.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 23.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 7.4.0 من Vungle SDK.
الإصدار 7.3.2.0
- تم إثبات التوافق مع الإصدار 7.3.2 من حزمة تطوير البرامج (SDK) من Vungle.
تم التصميم والاختبار باستخدام:
- الإصدار 23.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 7.3.2 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 7.3.1.0
- تم إثبات التوافق مع الإصدار 7.3.1 من حزمة تطوير البرامج (SDK) من Vungle.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 23.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 7.3.1 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 7.3.0.0
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 23.0.0.
- تم التحقّق من التوافق مع الإصدار 7.3.0 من حزمة تطوير البرامج (SDK) من Vungle.
- تمت إضافة ميزة العرض الإعلاني بدون انقطاع وعروض الأسعار لشكل الإعلان على شاشة فتح التطبيق.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 23.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 7.3.0 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 7.1.0.0
- تم التحقّق من التوافق مع الإصدار 7.1.0 من حزمة تطوير البرامج (SDK) من Vungle.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 22.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 7.1.0 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 7.0.0.1
- تم إصلاح مشكلة عدم تسجيل مرّات الظهور لعروض الأسعار للإعلانات المدمجة في التطبيق من خلال حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- تمّت إعادة المحوِّل للاعتماد على الإصدار 22.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
تمّ تصميمها واختبارها باستخدام:
- الإصدار 22.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 7.0.0 من Vungle SDK.
الإصدار 7.0.0.0
- تمت إضافة ميزة تحميل إعلانات متعددة باستخدام رقم تعريف موضع الإعلان نفسه لجميع أشكال الإعلانات للعرض بدون انقطاع.
- تم تغيير اسم المحوِّل من Vungle إلى Liftoff Monetize.
- تم التحقّق من التوافق مع الإصدار 7.0.0 من حزمة تطوير البرامج (SDK) من Vungle.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 22.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 7.0.0 من Vungle SDK.
الإصدار 6.12.1.1
- تم تعديل المحوِّل لاستخدام فئة
VersionInfo
الجديدة. - تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.0.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 22.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.12.1 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.12.1.0
- تم التحقق من التوافق مع Vungle SDK 6.12.1.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 21.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.12.1 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.12.0.1
- تمت إضافة ميزة تقديم عروض الأسعار لشكل الإعلانات البانر.
- تم التحقق من التوافق مع Vungle SDK 6.12.0.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.4.0.
تم التصميم والاختبار باستخدام:
- الإصدار 21.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.12.0 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.12.0.0
- تمت إضافة دعم عروض الأسعار والتوسّط في العرض الإعلاني بدون انقطاع لشكل الإعلان البيني الذي يضم مكافأة.
- تمت إضافة ميزة تقديم عروض الأسعار لشكل الإعلان المدمج مع المحتوى.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 21.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.12.0 من Vungle SDK.
الإصدار 6.11.0.3
- تمت إضافة ميزة التوسّط للعرض بدون انقطاع لشكل الإعلان المدمج مع المحتوى.
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.1.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 21.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.11.0 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.11.0.2
- تمت إضافة ميزة تحميل إعلانات متعددة لرقم تعريف موضع الإعلان نفسه في إعلانات عروض الأسعار التي تضم مكافآت.
تم التصميم والاختبار باستخدام:
- الإصدار 21.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.11.0 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.11.0.1
- تم تعديل
compileSdkVersion
وtargetSdkVersion
إلى واجهة برمجة التطبيقات 31. - تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.0.0.
- تم تعديل الحد الأدنى المطلوب لمستوى واجهة برمجة تطبيقات Android إلى 19.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 21.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.11.0 من Vungle SDK.
الإصدار 6.11.0.0
- تم إثبات التوافق مع الإصدار 6.11.0 من حزمة تطوير البرامج (SDK) من Vungle.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 20.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.11.0 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.10.5.0
- تم التحقّق من التوافق مع حزمة تطوير البرامج (SDK) من Vungle 6.10.5.
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.6.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 20.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.10.5 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.10.4.0
- تم التحقّق من التوافق مع Vungle SDK 6.10.4.
تم التصميم والاختبار باستخدام:
- الإصدار 20.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.10.4 من Vungle SDK
الإصدار 6.10.3.0
- تم إثبات التوافق مع الإصدار 6.10.3 من حزمة تطوير البرامج (SDK) من Vungle.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 20.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.10.3 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.10.2.1
- تم إثبات التوافق مع الإصدار 6.10.2 من حزمة تطوير البرامج (SDK) من Vungle.
- تمت إضافة ميزة تقديم عروض الأسعار لأشكال الإعلانات البينية والإعلانات التي تضمّ مكافأة.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.5.0.
تم التصميم والاختبار باستخدام:
- الإصدار 20.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.10.2 من Vungle SDK.
الإصدار 6.10.2.0
- تم إثبات التوافق مع الإصدار 6.10.2 من حزمة تطوير البرامج (SDK) من Vungle.
- تم إصلاح مشكلة المحول عن طريق استبدال المعلمة
serverParameters
، بـmediationExtras
للحصول على معلمات خاصة بشبكة Vungle، عند طلب إعلانات البانر والإعلانات البينية.
تم التصميم والاختبار باستخدام:
- الإصدار 20.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.10.2 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.10.1.0
- تم التحقّق من التوافق مع حزمة Vungle SDK 6.10.1.
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.3.0.
- أصبحت إعلانات MREC متاحة الآن باستخدام واجهة برمجة تطبيقات إعلانات البانر من Vungle.
- رموز خطأ ورسائل موحّدة تم تعديلها
تم التصميم والاختبار باستخدام:
- الإصدار 20.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.10.1 من Vungle SDK.
الإصدار 6.9.1.1
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.0.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 20.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.9.1 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.9.1.0
- تم التحقّق من التوافق مع الإصدار 6.9.1 من حزمة تطوير البرامج (SDK) من Vungle.
- تمت إضافة إمكانية استخدام OMSDK.
- إصلاحات أخطاء متنوّعة.
- إتاحة الإعلانات التي تضم مكافأة لطلب معاودة الاتصال onAdViewed في Vungle
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.7.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 19.7.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.9.1 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.8.1.1
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.6.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 19.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.8.1 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.8.1.0
- تم التحقّق من التوافق مع الإصدار 6.8.1 من حزمة تطوير البرامج (SDK) من Vungle.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.5.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 19.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.8.1 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.8.0.0
- تم التحقّق من التوافق مع الإصدار 6.8.0 من حزمة تطوير البرامج (SDK) من Vungle.
- تم تعديل المحوِّل لمنع إعادة توجيه
onAdClosed()
عند إعادة تحميل إعلانات البانر أو إزالتها. - أزِل
FlexFeed
وFlexView
(تم إيقافهما نهائيًا في الإصدار 6.8.0 من Vungle). - تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.4.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 19.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.8.0 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.7.1.0
- تم التحقق من التوافق مع Vungle SDK 6.7.1.
- تم إصلاح خلل كان يؤدي إلى عدم تحميل الإعلانات إذا تم تحميل إعلان باستخدام سياق تطبيق.
- تم تعديل
targetSdkVersion
إلى واجهة برمجة التطبيقات 29. - تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.3.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 19.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.7.1 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.7.0.0
- تم التحقّق من التوافق مع الإصدار 6.7.0 من حزمة تطوير البرامج (SDK) من Vungle.
- تم تعديل المحوّل لإتاحة طلبات إعلانات البانر التكيُّفية المضمّنة.
- تم الآن إلغاء كتم صوت الإعلانات البينية والإعلانات التي تضمّ مكافآت تلقائيًا.
- تعمل الإعلانات البينية الآن على إعادة توجيه معاودة الاتصال
onAdLeftApplication()
عند النقر عليها. - تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.2.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 19.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.7.0 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.5.3.0
- تم إثبات التوافق مع الإصدار 6.5.3 من حزمة تطوير البرامج (SDK) من Vungle.
- إضافة تنسيق إعلان البانر الذي طرحته Vungle مؤخرًا
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.0.1.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 19.0.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.5.3 من حزمة تطوير البرامج (SDK) من Vungle
الإصدار 6.4.11.1
- تم حلّ مشكلة تعذُّر تحديث الإعلانات البانر.
الإصدار 6.4.11.0
- تم التحقق من التوافق مع Vungle SDK 6.4.11.
- تمت إضافة إمكانية عرض إعلانات البانر.
- نقل المحوِّل إلى AndroidX
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.2.0.
الإصدار 6.3.24.1
- تم تعديل المحوِّل لتتوافق مع واجهة برمجة التطبيقات الجديدة والتجريبية المفتوحَين لعرض الإعلانات التي تضم مكافآت.
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 17.2.0.
الإصدار 6.3.24.0
- تم التحقق من التوافق مع Vungle SDK 6.3.24.
الإصدار 6.3.17.0
- تم التحقق من التوافق مع Vungle SDK 6.3.17.
الإصدار 6.3.12.0
- تم التحقّق من التوافق مع الإصدار 6.3.12 من حزمة تطوير البرامج (SDK) من Vungle.
الإصدار 6.2.5.1
- تم تعديل المحوِّل لتشغيل حدث الإعلان
onRewardedVideoComplete()
.
الإصدار 6.2.5.0
- تم التحقق من التوافق مع Vungle SDK 6.2.5.
الإصدار 5.3.2.1
- تم تعديل المحوِّل لإعداد تقارير صحيحة عن النقرات إلى حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
الإصدار 5.3.2.0
- تم التحقّق من التوافق مع الإصدار 5.3.2 من حزمة تطوير البرامج (SDK) من Vungle.
- تم تحديث مشروع Adpater لـ Android Studio 3.0.
- تمت إضافة الطرق التالية إلى فئة "أداة إنشاء الحِزم".
setOrdinalViewCount
: يُستخدَم هذا الحقل لتمرير الترتيب الفاصل للتوسّط، عندما يتلقّى الناشر تقارير البيانات الترتيبية من Vungle.setFlexViewCloseTimeInSec
: يُستخدَم هذا الخيار لجعل إعلانات "طريقة العرض المرنة" تتم إزالتها تلقائيًا بعد العدد المحدّد من الثواني.
الإصدار 5.3.0.0
- تم التحقّق من التوافق مع الإصدار 5.3.0 من حزمة تطوير البرامج (SDK) من Vungle.
الإصدار 5.1.0.0
- تم تعديل المحوِّل ليصبح متوافقًا مع الإصدار 5.1.0 من حزمة تطوير البرامج (SDK) من Vungle.
- تم تغيير نظام تسمية الإصدارات إلى [Vungle SDK version].[adapter patch version].
الإصدارات الأقدم
- تمت إضافة إمكانية استخدام أشكال الإعلانات البينية وإعلانات الفيديو التي تضم مكافأة.