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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

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

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

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

  • أحدث إصدار من Google Mobile Ads Flutter Plugin
  • الإصدار 3.7.0 أو إصدار أحدث من إطار عمل Flutter
  • للنشر على أجهزة Android
    • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
  • للنشر على أجهزة iOS
    • هدف نشر iOS‏ 13.0 أو إصدار أحدث
  • مشروع Flutter يعمل بشكل صحيح وتم إعداده باستخدام Google Mobile Ads Flutter Plugin. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads Flutter Plugin.
  • إعداد التوسّط

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

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

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

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

    Android

    iOS

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

    Android

    iOS

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

    Android

    iOS

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

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

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

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

    إعلان بانر بحجم ‎300x250

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

    إعلان بيني

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

    تمت المكافأة

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

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

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

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

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

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

    إعلان بانر بحجم ‎300x250

    إعلان بيني

    تمت المكافأة

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

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

    العثور على مفتاح Reporting API

    عروض الأسعار

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

    شلال

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

    تعديل ملف app-ads.txt

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

    لتنفيذ ملف app-ads.txt في Liftoff Monetize، يُرجى تنزيل إدخالات app-ads.txt الخاصة بـ Liftoff Monetize وإلحاقها بملف app-ads.txt الحالي. لمزيد من المعلومات، يُرجى الاطّلاع على app-ads.txt.

    تفعيل "الوضع التجريبي"

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

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

    Android

    iOS

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

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

    Android

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

    iOS

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

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

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

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

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

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

    dependencies:
  gma_mediation_liftoffmonetize: ^1.5.5

    الدمج اليدوي

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

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

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

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

    اعتبارًا من الإصدار 1.1.0 من المكوّن الإضافي Flutter في Liftoff Monetize، يقرأ Liftoff Monetize تلقائيًا الموافقة بموجب اللائحة العامة لحماية البيانات (GDPR) التي تحدّدها منصات إدارة الموافقة التي تتوافق مع مواصفات الموافقة الإضافية من Google، بما في ذلك حزمة تطوير البرامج لمنصة UMP. لمزيد من المعلومات، يُرجى الاطّلاع على تعليمات التنفيذ المقترَحة للّائحة العامة لحماية البيانات (GDPR) لنظامَي التشغيل Android وiOS.

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

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

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

    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: اختبار عملية التنفيذ

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

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

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

    سجلّ التغييرات في محوّل التوسّط في Liftoff Monetize Flutter

    الإصدار 1.5.6 (قيد التطوير)

    الإصدار 1.5.5

    الإصدار 1.5.4

    الإصدار 1.5.3

    الإصدار 1.5.2

    الإصدار 1.5.1

    الإصدار 1.5.0

    الإصدار 1.4.3

    الإصدار 1.4.2

    • تم تعديل الحد الأدنى لإصدار Flutter إلى 3.35.1
    • تم تعديل هذا الإصدار ليتوافق مع الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads

    الإصدار 1.4.1

    الإصدار 1.4.0

    الإصدار 1.3.0

    الإصدار 1.2.3

    الإصدار 1.2.2

    الإصدار 1.2.1

    الإصدار 1.2.0

    الإصدار 1.1.1

    الإصدار 1.1.0

    الإصدار 1.0.0