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

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

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

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

1 تتوفّر عملية دمج عروض الأسعار لهذا الشكل في إصدار تجريبي مفتوح.

2 الإعلان البيني الذي يضم مكافأة يتطلّب المساعدة في إعداده. تواصَل مع مدير حسابك على Liftoff Monetize أو monetize@liftoff.io.

المتطلّبات

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

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

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

أضف تطبيقك إلى لوحة تحكم Liftoff Monetize عن طريق النقر على الزر Add Application (إضافة تطبيق).

املأ النموذج، مع إدخال جميع التفاصيل المطلوبة.

Android

iOS

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

Android

iOS

دوِّن رقم تعريف التطبيق.

Android

iOS

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

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

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

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

بانر 300×250

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

إعلان بيني

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

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

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

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

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

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

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

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

بانر 300×250

إعلان بيني

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

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

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

تحديد موقع مفتاح واجهة برمجة التطبيقات Reporting API

عروض الأسعار

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

شلال

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

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

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

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

Android

iOS

الخطوة 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 حلّ مشكلة الاعتماد من البداية وستنسخ التبعيات المُعلَنة إلى دليل Assets/Plugins/Android في تطبيق Unity.

الخطوة 4: تنفيذ إعدادات الخصوصية في Liftoff Monetize SDK

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

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

Android

تتوفّر قيمتان محتملتان يمكنك الإشارة إليهما عند تعديل حالة الموافقة، وهما:

  • VungleConsentStatus.OPTED_IN
  • VungleConsentStatus.OPTED_OUT

يؤدّي الرمز النموذجي التالي إلى تعديل حالة الموافقة لتصبح VungleConsentStatus.OPTED_IN. إذا اخترت استدعاء هذه الطريقة، ننصحك بإجراء ذلك قبل طلب الإعلانات باستخدام "SDK لإعلانات Google على الأجهزة الجوّالة".

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

LiftoffMonetize.UpdateConsentStatus(VungleConsentStatus.OPTED_IN, "1.0.0");

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

iOS

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

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

LiftoffMonetize.SetGDPRStatus(true);
LiftoffMonetize.SetGDPRMessageVersion("1.0.0");

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

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

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

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

Android

تتوفّر قيمتان محتملتان يمكنك الإشارة إليهما عند تعديل حالة الموافقة، وهما:

  • VungleCCPAStatus.OPTED_IN
  • VungleCCPAStatus.OPTED_OUT

يؤدّي الرمز النموذجي التالي إلى تعديل حالة الموافقة لتصبح VungleCCPAStatus.OPTED_IN. إذا اخترت استدعاء هذه الطريقة، ننصحك بإجراء ذلك قبل طلب الإعلانات باستخدام "SDK لإعلانات Google على الأجهزة الجوّالة".

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

LiftoffMonetize.UpdateCCPAStatus(VungleCCPAStatus.OPTED_IN);

اطّلِع على تعليمات التنفيذ المقترَحة بشأن قانون خصوصية المستهلك في كاليفورنيا (CCPA) لمعرفة مزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

iOS

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

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

LiftoffMonetize.SetCCPAStatus(true);

اطّلِع على تعليمات التنفيذ المقترَحة بشأن قانون خصوصية المستهلك في كاليفورنيا (CCPA) لمعرفة مزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

الخطوة 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 ضمن الفئات التالية:

iOS

التنسيق اسم الصف
بانر GADMAdapterVungleInterstitial
إعلان بيني GADMAdapterVungleInterstitial
تم منح المكافأة إعلان فيديو يستند إلى GADMAdapterVungleReward

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

iOS

رمز الخطأ السبب
1-100 عرضت حزمة Vungle SDK خطأً. اطّلِع على الرمز البرمجي لمزيد من التفاصيل.
101 مَعلمات خادم Liftoff Monetize التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة/غير صالحة.
102 سبق أن تم تحميل إعلان لإعداد الشبكة هذه. يتعذّر على حزمة Vungle SDK تحميل إعلان ثاني برقم تعريف موضع الإعلان نفسه.
103 لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع Liftoff Monetize.
104 تعذّر على Vungle SDK عرض إعلان البانر.
105 تتيح Vungle SDK تحميل إعلان بانر واحد فقط في كل مرة، بغض النظر عن رقم تعريف موضع الإعلان.
106 أرسلَت Vungle SDK معاودة الاتصال بأنّ الإعلان غير قابل للتشغيل.

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

الإصدار 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 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 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 على نظام التشغيل iOS.
  • تم إنشاء البرنامج واختباره باستخدام الإصدار 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.