يوضّح لك هذا الدليل كيفية استخدام حزمة "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، وأدخِل اسم موضع الإعلان واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق بوضعه على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
إعلان بيني
حدّد إعلان بيني، وأدخل اسم موضع إعلان، واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء الموضع
تم منح المكافأة
اختَر إعلان بمكافأة، وأدخِل اسم موضع الإعلان واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق بوضعه على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء الموضع.
إعلان بيني يضمّ مكافأة
اختَر إعلانات مقابل مكافأة. أدخِل اسم موضع الإعلان، وفعِّل قابل للتخطّي واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح التبديل عروض الأسعار داخل التطبيق إلى مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
مدمجة مع المحتوى
اختَر إعلان مدمج مع المحتوى، وأدخِل اسم موضع الإعلان واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل عروض الأسعار داخل التطبيق بوضعه على مفعّل. انقر على الزر متابعة في أسفل الصفحة لإنشاء الموضع.
سجِّل رقم تعريف المرجع وانقر على حسنًا.
إعلان على شاشة فتح التطبيق
بانر
إعلان بانر 300x250
إعلان بيني
تم منح المكافأة
إعلان بيني يضمّ مكافأة
مدمجة مع المحتوى
تحديد مكان مفتاح Reporting API
عروض الأسعار
وهذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
بالإضافة إلى معرّف التطبيق ومعرّف المرجع، ستحتاج أيضًا إلى مفتاح Reporting API في Liftoff Monetize لإعداد رقم تعريف الوحدة الإعلانية في AdMob. انتقِل إلى لوحة بيانات تقارير تحقيق الربح في Liftoff وانقر على الزر Reporting API Key لعرض مفتاح Reporting API.
تفعيل وضع الاختبار
لتفعيل الإعلانات الاختبارية، انتقِل إلى لوحة بيانات Liftoff Monetize وانتقِل إلى التطبيقات.
اختَر تطبيقك الذي تريد تفعيل الإعلانات الاختبارية له ضمن القسم رقم تعريف مرجع موضع الإعلان في تطبيقك. يمكن تفعيل الإعلانات الاختبارية من خلال اختيار وضع الاختبار لعرض الإعلانات الاختبارية فقط ضمن قسم الحالة.
Android
iOS
الخطوة 2: إعداد طلب تحقيق الربح من Liftoff في AdMob واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة Liftoff إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات "اللائحة العامّة لحماية البيانات" (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()
. يعرض نموذج الرمز التالي
كيفية تمرير معلومات الموافقة إلى Vungle SDK. إذا اخترت استدعاء هذه الطريقة، فمن المستحسن استدعائها قبل طلب الإعلانات من خلال
"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 Monetize . |
104 | تعذَّر على Vungle SDK عرض إعلان البانر. |
105 | لا تتيح حزمة تطوير البرامج (SDK) من Vungle تحميل إعلان بانر واحد فقط في كل مرة، بغض النظر عن رقم تعريف موضع الإعلان. |
106 | أرسلت Vungle SDK معاودة الاتصال تفيد بأن الإعلان غير قابل للتشغيل. |
107 | Vungle SDK غير جاهز لتشغيل الإعلان. |
بالنسبة إلى الأخطاء الواردة من Vungle SDK، يُرجى الرجوع إلى رموز الخطأ: Vungle SDK لنظامي التشغيل 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 على الأجهزة الجوّالة".