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

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

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

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

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

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

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫Flutter 3.7.0 أو إصدار أحدث
  • للنشر على Android
    • المستوى 21 أو إصدار أحدث لواجهة برمجة التطبيقات Android
  • للنشر على أجهزة iOS
    • إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
  • Flutter مشروع صالح تم إعداده باستخدام حزمة "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" في AdMob واجهة المستخدم

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

Android

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

iOS

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

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

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

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

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

أضِف التبعية التالية مع أحدث إصدارات Liftoff Monetize حزمة SDK والمحوِّل في ملف 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: إضافة الرمز المطلوب

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.

سجلّ التغييرات في أداة التوسّط 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 على الأجهزة الجوّالة".