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

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

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

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

1 عروض الأسعار يكون التكامل مع هذا التنسيق في إصدار تجريبي مغلق.

2 عروض الأسعار والتكامل مع هذا التنسيق في إصدار تجريبي مفتوح.

3 العرض الإعلاني بدون انقطاع يكون التكامل مع هذا التنسيق في إصدار تجريبي مغلق.

المتطلبات

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

يُرجى الاطّلاع على تعليمات التنفيذ المقترَحة للّائحة العامة لحماية البيانات (GDPR). Android وiOS للاطّلاع على المزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

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

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

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

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

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

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

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

  • تم تحديث المكوِّن الإضافي لإتاحة واجهة برمجة التطبيقات التي تتضمن مكافأة جديدة مفتوحة في الإصدار التجريبي.
  • يتوافق مع الإصدار 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.