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

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

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

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

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

المتطلبات

• أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫Flutter 3.7.0 أو إصدار أحدث
• [لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم المكوّن الإضافي لدمج "إعلانات Google على الأجهزة الجوّالة" في AppLovin 5.1.0 أو إصدار أحدث (ننصح باستخدام أحدث إصدار)
• للنشر على Android
  • المستوى 21 أو إصدار أحدث لواجهة برمجة التطبيقات Android
• للنشر على أجهزة iOS
  • إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
• Flutter مشروع صالح تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" اطّلِع على البدء لمعرفة التفاصيل.
• إكمال التوسّط دليل البدء

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الدمج من خلال pub.dev

أضِف التبعية التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) وملف التكيف لبرنامج Liftoff Monetize في ملفpubspec.yaml الحزمة:

dependencies:
  gma_mediation_liftoffmonetize: ^1.0.0

الدمج اليدوي

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

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

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

موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامّة لحماية البيانات"

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

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

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");

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

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

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

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

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setCCPAStatus(true);

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

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

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

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

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

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

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

رموز الخطأ

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

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

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

سجلّ التغييرات في أداة التوسّط Flutter Mediation Adapter ضمن Liftoff Monetize

النسخة التالية

• تم إنشاؤه واختباره باستخدام الإصدار 5.2.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".

الإصدار 1.1.0

• تم التحقّق من التوافق مع الإصدار 7.4.0.1 من محوِّل Liftoff Monetize لنظام التشغيل Android.
• تم التحقّق من التوافق مع الإصدار 7.4.0.1 من محوِّل LiftoffMonetize لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 5.1.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".

الإصدار 1.0.0

• الإصدار الأولي
• تم التحقّق من التوافق مع الإصدار 7.3.1.0 من محوِّل Android في Liftoff Monetize.
• تم التحقّق من التوافق مع الإصدار 7.3.2.0 من محوِّل LiftoffMonetize لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 5.1.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".