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

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

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

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

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 انقر على الزر إضافة موضع إعلان واختر تطبيقك من القائمة المنسدلة الحالية.

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

فتح التطبيق

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

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

إعلان بانر 300x250

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

إعلان بيني

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

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

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

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

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

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

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

دوِّن المعرّف المرجعي وانقر على يبدو جيدًا.

فتح التطبيق

بانر مقاس 300×250

إعلان بيني

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

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

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

تحديد موقع مفتاح Reporting API

عروض الأسعار

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

شلال

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

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

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

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

Android

iOS

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

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

Android

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

iOS

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

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

الخطوة 3: استيراد حزمة Vungle SDK ومحوّل Liftoff Monetize

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

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

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

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

بموجب سياسة موافقة المستخدِم في الاتّحاد الأوروبي المتّبَعة في Google، عليك التأكّد من تقديم بيانات الإفصاح المعيّنة إلى المستخدِمين في المنطقة الاقتصادية الأوروبية والحصول على موافقاتهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية و"حماية البيانات العامة" اللائحة (اللائحة العامة لحماية البيانات). عند طلب الموافقة، عليك تحديد كل شبكة إعلانية في سلسلة التوسّط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، و تقديم معلومات عن استخدام كل شبكة. يتعذّر على 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 (Bidding) and Liftoff Monetize (Waterfall) مصادر الإعلانات.

رموز الخطأ

إذا تعذّر على المُحوِّل تلقّي إعلان من 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 لا يمكن لحزمة Vungle SDK تحميل إعلانات متعددة لموضع الإعلان نفسه رقم التعريف
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 Monetize حجم إعلان البانر.
104 تعذّر على حزمة تطوير البرامج (SDK) من Vungle عرض إعلان البانر.
105 لا يدعم Vungle SDK تحميل سوى إعلان بانر واحد في كل مرة، بغض النظر عن معرّف موضع الإعلان.
106 أرسلت حزمة تطوير البرامج (SDK) من Vungle طلب ردّ اتصال يفيد بأنّ الإعلان غير قابل للتشغيل.
107 Vungle SDK غير جاهز لتشغيل الإعلان.

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

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

الإصدار 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.
  • متوافق مع الإصدار 7.3.1.0 من محوِّل Liftoff Monetize لنظام التشغيل iOS.
  • تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".

الإصدار 5.0.0

الإصدار 4.0.0

  • تغيير العلامة التجارية لمكوّن توسّط Unity من Vungle إلى Liftoff Monetize
  • تم نقل محتوى المحوِّل إلى GoogleMobileAds/Mediation/LiftoffMonetize/.
  • تمت إعادة ضبط مساحة الاسم للمهايئ لاستخدام GoogleMobileAds.Mediation.LiftoffMonetize.
  • تمت إضافة الطرق التالية إلى فئة LiftoffMonetize:
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • متوافق مع الإصدار 6.12.1.1 من محوِّل Liftoff Monetize لنظام التشغيل Android.
  • يتوافق مع الإصدار 7.0.1.0 من محوّل Liftoff Monetize.
  • تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.4.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 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() لضبط حالة الموافقة التي سيتم تسجيلها في Vungle SDK.
    • 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.