دمج Liftoff Monetize مع التوسّط

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

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

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

1 دمج عروض الأسعار متاح في الإصدار التجريبي المفتوح.

2 يتوفّر الإصدار التجريبي المفتوح من ميزة دمج الإعلانات المعروضة بدون انقطاع لهذا التنسيق.

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫Unity 4 أو إصدار أحدث
  • (لعروض الأسعار): مكوّن إضافي للتوسّط في "إعلانات Google" للأجهزة الجوّالة لميزة Liftoff Monetize 3.8.2 أو إصدار أحدث (ننصح باستخدام أحدث إصدار)
  • للنشر على Android
    • المستوى 21 أو إصدار أحدث لواجهة برمجة التطبيقات Android
  • للنشر على أجهزة iOS
    • إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
  • Unity مشروع صالح تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" اطّلِع على البدء لمعرفة التفاصيل.
  • إكمال التوسّط دليل البدء

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

اشترِك أو سجِّل الدخول إلى حسابك على Liftoff Monetize.

أضِف تطبيقك إلى لوحة بيانات تحقيق الربح من Liftoff من خلال النقر على الزر إضافة تطبيق.

املأ النموذج وأدخِل جميع التفاصيل اللازمة.

Android

iOS

بعد إنشاء تطبيقك، اختَره من لوحة بيانات تطبيقات Liftoff Monetize.

Android

iOS

سجِّل رقم تعريف التطبيق.

Android

iOS

إضافة مواضع إعلان جديدة

لإنشاء موضع إعلان جديد لاستخدامه مع توسّط AdMob، انتقِل إلى لوحة بيانات "مواضع الإعلانات لتحقيق الربح" في Liftoff، ثم انقر على الزر إضافة موضع إعلان واختَر تطبيقك من القائمة المنسدلة.

في ما يلي تفاصيل إضافة مواضع إعلانات جديدة:

إعلان على شاشة فتح التطبيق

اختَر إعلان بيني وأدخِل اسم موضع الإعلان. بعد ذلك، اختَر نعم لـ قابل للتخطّي واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل مفتاح التبديل عروض الأسعار داخل التطبيق على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.

اختَر إعلان بانر، وأدخِل اسم موضع الإعلان واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق بوضعه على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.

بانر مقاس 300×250

اختَر MREC، وأدخِل اسم موضع الإعلان واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق بوضعه على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.

إعلان بيني

اختَر إعلان بيني، وأدخِل اسم موضع الإعلان، واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.

تم منح المكافأة

اختَر إعلان بمكافأة، وأدخِل اسم موضع الإعلان واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق بوضعه على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.

إعلان بيني يضمّ مكافأة

اختَر إعلانات مقابل مكافأة. أدخِل اسم موضع الإعلان، وفعِّل قابل للتخطّي واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح التبديل عروض الأسعار داخل التطبيق إلى مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.

مدمجة مع المحتوى

اختَر إعلان مدمج مع المحتوى، وأدخِل اسم موضع الإعلان واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق بوضعه على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.

سجِّل رقم تعريف المرجع وانقر على حسنًا.

إعلان على شاشة فتح التطبيق

بانر مقاس 300×250

إعلان بيني

تم منح المكافأة

إعلان بيني يضمّ مكافأة

مدمجة مع المحتوى

تحديد مكان مفتاح Reporting API

عروض الأسعار

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

شلال

بالإضافة إلى معرّف التطبيق ومعرّف المرجع، ستحتاج أيضًا إلى مفتاح Reporting API في Liftoff Monetize لإعداد رقم تعريف الوحدة الإعلانية في AdMob. انتقِل إلى لوحة بيانات تقارير Liftoff Monetize وانقر على الزر مفتاح Reporting API للاطّلاع على مفتاح Reporting API .

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

لتفعيل الإعلانات الاختبارية، انتقِل إلى لوحة بيانات Liftoff Monetize وانتقِل إلى التطبيقات.

اختَر تطبيقك الذي تريد تفعيل الإعلانات الاختبارية له ضمن القسم رقم تعريف مرجع موضع الإعلان في تطبيقك. يمكن تفعيل الإعلانات الاختبارية من خلال اختيار وضع الاختبار لعرض الإعلانات الاختبارية فقط ضمن قسم الحالة.

Android

iOS

الخطوة 2: إعداد ميزة "تحقيق الربح من Liftoff" في Ad Manager واجهة المستخدم

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

Android

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل استخدام iOS.

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

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

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) من Vungle ومحوِّل Liftoff Monetize

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

في محرِّر مشروع Unity، اختَر مواد العرض > استيراد حزمة > حزمة مخصّصة وابحث عن ملف GoogleMobileAdsVungleMediation.unitypackage الذي نزّلته. تأكَّد من اختيار كل الملفات وانقر على استيراد.

بعد ذلك، اختَر مواد العرض > أداة حلّ مشاكل خدمات Play > أداة حلّ مشاكل Android > فرض حلّ المشاكل. ستنفِّذ مكتبة Unity Play Services Resolver مكتبة حلّ التبعيات من البداية وستنسخ التبعيات المعلَن عنها إلى ملف directory Assets/Plugins/Android في تطبيق Unity.

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

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

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

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif

اطّلِع على تعليمات التنفيذ المقترَحة بموجب "اللائحة العامّة لحماية البيانات" لنظامَي التشغيل Android وiOS للحصول على مزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

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

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

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

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetCCPAStatus(true);

اطّلِع على تعليمات التنفيذ المقترَحة بموجب قانون CCPA لنظامَي التشغيل Android وiOS للحصول على مزيد من التفاصيل ومعرفة القيم التي يمكن تقديمها في الطريقة.

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

Android

لا يلزم استخدام رمز إضافي لدمج Liftoff Monetize.

iOS

دمج SKAdNetwork

اتّبِع مستندات Liftoff Monetize لإضافة معرّفات SKAdNetwork إلى ملف Info.plist في مشروعك.

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

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

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

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

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

رموز الخطأ

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

Android

التنسيق اسم الصف
إعلان على شاشة فتح التطبيق (عروض الأسعار) 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

iOS

التنسيق اسم الصف
إعلان على شاشة فتح التطبيق (عروض الأسعار) GADMediationAdapterVungle
إعلان على شاشة فتح التطبيق (عرض بدون انقطاع) GADMediationAdapterVungle
إعلان البانر (عروض الأسعار) GADMediationAdapterVungle
بانر (معروض بدون انقطاع) GADMAdapterVungleInterstitial
بيني (عروض الأسعار) GADMediationAdapterVungle
إعلان بيني (العرض الإعلاني بدون انقطاع) GADMAdapterVungleInterstitial
إعلانات تضمّ مكافأة (عروض الأسعار) GADMediationAdapterVungle
إعلانات تضمّ مكافأة (مُعدّة للعرض بدون انقطاع) GADMAdapterVungleRewardBasedVideoAd
إعلان بيني يضمّ مكافأة (عروض الأسعار) GADMediationAdapterVungle
إعلان بيني يضمّ مكافأة (العرض بدون انقطاع) GADMediationAdapterVungle

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

Android

رمز الخطأ السبب
101 مَعلمات الخادم غير صالحة (مثل رقم تعريف التطبيق أو رقم تعريف موضع الإعلان)
102 لا يتطابق حجم البانر المطلوب مع حجم إعلان Liftoff Monetize صالح.
103 تتطلّب ميزة Liftoff Monetize سياقًا Activity لطلب الإعلانات.
104 لا يمكن لحزمة تطوير البرامج (SDK) من Vungle تحميل إعلانات متعدّدة لمعرّف موضع الإعلان نفسه.
105 تعذّر إعداد حزمة تطوير البرامج (SDK) من Vungle.
106 عرضت حزمة تطوير البرامج (SDK) من Vungle طلب استدعاء تحميل ناجحًا، ولكن Banners.getBanner()‎ أو Vungle.getNativeAd()‎ أرجعت قيمة فارغة.
107 حزمة تطوير البرامج (SDK) من Vungle غير جاهزة لتشغيل الإعلان.
108 عرضت حزمة تطوير البرامج (SDK) من Vungle رمزًا مميزًا غير صالح لعروض الأسعار.

iOS

رمز الخطأ السبب
101 مَعلمات الخادم غير صالحة (مثل رقم تعريف التطبيق أو رقم تعريف موضع الإعلان)
102 سبق أن تم تحميل إعلان لإعدادات الشبكة هذه. لا يمكن لحزمة تطوير البرامج (SDK) من Vungle carregar um anúncio segundo para o mesmo número de identificação do local.
103 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع ميزة "تحقيق الربح من Liftoff".
104 تعذّر على حزمة تطوير البرامج (SDK) من Vungle عرض إعلان البانر.
105 لا تتيح حزمة تطوير البرامج (SDK) من Vungle تحميل إعلان بانر واحد فقط في كل مرة، بغض النظر عن رقم تعريف موضع الإعلان.
106 أرسلت حزمة تطوير البرامج (SDK) من Vungle طلب ردّ اتصال يفيد بأنّ الإعلان غير قابل للتشغيل.
107 حزمة تطوير البرامج (SDK) من Vungle غير جاهزة لتشغيل الإعلان.

بالنسبة إلى الأخطاء الناتجة عن حزمة تطوير البرامج (SDK) من Vungle، يُرجى الاطّلاع على رموز الأخطاء: حزمة تطوير البرامج (SDK) من Vungle لنظامَي التشغيل iOS وAndroid.

سجلّ التغييرات في مكوّن Liftoff Monetize الإضافي لتوسّط Unity

الإصدار 5.2.2

الإصدار 5.2.1

الإصدار 5.2.0

الإصدار 5.1.1

الإصدار 5.1.0

  • تم إصلاح NullPointerException الذي كان يتسبب في تعذُّر إنشاء المشروع عند تصديره كمشروع Android.
  • تم تعديل واجهات برمجة التطبيقات المتعلّقة بالخصوصية:
    • تمّت إزالة الطريقتَين UpdateConsentStatus() وUpdateCCPAStatus().
    • تمت إزالة قائمتَي القيم المحدَّدة VungleConsentStatus وVungleCCPAStatus.
    • تم تعديل طريقة SetGDPRStatus(bool) إلى SetGDPRStatus(bool, String).
  • تمت إزالة الطرق التالية من فئة LiftoffMonetizeMediationExtras:
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • متوافق مع الإصدار 7.3.1.0 من محوِّل Liftoff Monetize لنظام التشغيل Android.
  • يتوافق مع الإصدار 7.3.1.0 من محوِّل Liftoff Monetize لنظام التشغيل iOS.
  • تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".

الإصدار 5.0.0

الإصدار 4.0.0

الإصدار 3.9.2

الإصدار 3.9.1

الإصدار 3.9.0

الإصدار 3.8.2

الإصدار 3.8.1

الإصدار 3.8.0

الإصدار 3.7.5

الإصدار 3.7.4

الإصدار 3.7.3

الإصدار 3.7.2

الإصدار 3.7.1

الإصدار 3.7.0

الإصدار 3.6.0

الإصدار 3.5.1

الإصدار 3.5.0

الإصدار 3.4.1

الإصدار 3.4.0

الإصدار 3.3.1

الإصدار 3.3.0

الإصدار 3.2.0

الإصدار 3.1.4

  • يتوافق مع الإصدار 6.3.24.1 من محوِّل Android.
  • يتوافق مع الإصدار 6.3.2.3 من محوِّل iOS.

الإصدار 3.1.3

  • يتوافق مع الإصدار 6.3.24.1 من محوِّل Android.
  • يتوافق مع الإصدار 6.3.2.2 من محوِّل iOS.

الإصدار 3.1.2

  • تم تعديل المكوّن الإضافي ليتوافق مع الإصدار التجريبي المفتوح الجديد من Rewarded API.
  • يتوافق مع الإصدار 6.3.24.1 من محوِّل Android.
  • يتوافق مع الإصدار 6.3.2.1 من محوِّل iOS.

الإصدار 3.1.1

  • يتوافق مع الإصدار 6.3.24.0 من محوِّل Android.
  • يتوافق مع الإصدار 6.3.2.0 من محوِّل iOS.
  • تم تعديل طريقة Vungle.UpdateConsentStatus() لجعل المَعلمة consentMessageVersion اختيارية. يتم الآن تجاهل قيمة consentMessageVersion على أجهزة iOS.
  • تم إيقاف Vungle.GetCurrentConsentMessageVersion() نهائيًا على نظام التشغيل iOS.

الإصدار 3.1.0

  • يتوافق مع الإصدار 6.3.17.0 من محوِّل Android.
  • يتوافق مع الإصدار 6.3.0.0 من محوِّل iOS.
  • تم تعديل طريقة Vungle.UpdateConsentStatus() لقبول مَعلمة String إضافية لإصدار رسالة الموافقة المقدَّمة من الناشر.
  • تمت إضافة طريقة Vungle.GetCurrentConsentMessageVersion() للحصول على إصدار رسالة طلب الموافقة المقدَّمة من الناشر.

الإصدار 3.0.1

  • يتوافق مع الإصدار 6.2.5.1 من محوِّل Android.
  • يتوافق مع الإصدار 6.2.0.3 من محوِّل iOS.

الإصدار 3.0.0

  • يتوافق مع الإصدار 6.2.5.0 من محوِّل Android.
  • يتوافق مع الإصدار 6.2.0.2 من محوِّل iOS.
  • تمت إضافة الطرق التالية:
    • Vungle.UpdateConsentStatus() طريقة ضبط حالة الموافقة التي سيتم تسجيلها في حزمة تطوير البرامج (SDK) من Vungle
    • Vungle.GetCurrentConsentStatus() للحصول على حالة موافقة المستخدم الحالية.

الإصدار 2.0.0

  • يتوافق مع الإصدار 5.3.2.1 من محوِّل Android.
  • يتوافق مع الإصدار 6.2.0.0 من محوِّل iOS.

الإصدار 1.1.0

  • يتوافق مع الإصدار 5.3.2.1 من محوِّل Android.
  • يتوافق مع الإصدار 5.4.0.0 من محوِّل iOS.

الإصدار 1.0.0

  • الإصدار الأول
  • يتوافق مع الإصدار 5.3.0.0 من محوِّل Android.
  • متوافق مع الإصدار 5.3.0.0 من محوِّل iOS