يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من Liftoff Monetize باستخدام التوسّط، والتي تغطي كلاً من عروض الأسعار عمليات دمج العرض الإعلاني بدون انقطاع. ويتناول هذا الدليل كيفية إضافة Liftoff Monetize إلى إعدادات التوسّط لوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوِّل Vungle في Flutter تطبيق.
أشكال الإعلانات وعمليات الدمج المتوافقة
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
فتح التطبيق | 1، 3 |
بانر | 2 |
إعلان بيني | |
تم منح المكافأة | |
إعلان بيني يضم مكافأة | 2 |
1 عروض الأسعار يكون التكامل مع هذا التنسيق في إصدار تجريبي مغلق.
2 عروض الأسعار والتكامل مع هذا التنسيق في إصدار تجريبي مفتوح.
3 العرض الإعلاني بدون انقطاع يكون التكامل مع هذا التنسيق في إصدار تجريبي مغلق.
المتطلبات
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android
- المستوى 21 أو إصدار أحدث من واجهة برمجة التطبيقات لنظام التشغيل Android
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Flutter عامل مهيأ باستخدام SDK لإعلانات Google على الأجهزة الجوّالة. عرض البدء لمعرفة التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: إعداد الإعدادات في واجهة مستخدم Liftoff Monetize
الخطوة 2: إعداد طلب Liftoff Monetize في واجهة المستخدم AdMob
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة Liftoff إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة Liftoff إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في AdMob واجهة المستخدم.
الخطوة 3: استيراد حزمة Vungle SDK ومحوّل 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()
. الرمز النموذجي التالي
كيفية تمرير معلومات الموافقة إلى Vungle SDK إذا اخترت
استدعاء هذه الطريقة، ننصحك باستدعاؤها قبل طلب الإعلانات من خلال
"حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة".
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
يُرجى الاطّلاع على تعليمات التنفيذ المقترَحة للّائحة العامة لحماية البيانات (GDPR). 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 (Bidding) and Liftoff Monetize (Waterfall) مصادر الإعلانات.
رموز الخطأ
في حال تعذّر على المحوّل استلام إعلان من 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 | لا يمكن لحزمة Vungle SDK تحميل إعلانات متعددة لموضع الإعلان نفسه رقم التعريف |
105 | تعذّر إعداد حزمة Vungle SDK. |
106 | عرضت Vungle SDK معاودة الاتصال بنجاح للتحميل، ولكن تم عرض قيمة فارغة في Banners.getBanner() أو Vungle.getNativeAd(). |
107 | Vungle SDK غير جاهز لتشغيل الإعلان. |
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 | لا يدعم Vungle SDK تحميل سوى إعلان بانر واحد في كل مرة، بغض النظر عن معرّف موضع الإعلان. |
106 | أرسلت حزمة تطوير البرامج (SDK) من Vungle طلب ردّ اتصال يفيد بأنّ الإعلان غير قابل للتشغيل. |
107 | Vungle SDK غير جاهز لتشغيل الإعلان. |
بالنسبة إلى الأخطاء الواردة من Vungle SDK، راجع رموز الخطأ: Vungle SDK لنظامي التشغيل iOS وAndroid.
سجلّ تغييرات محوّل وساطة Liftoff Flutter
الإصدار 1.0.0
- الإصدار الأولي
- تم التحقّق من التوافق مع الإصدار 7.3.1.0 من محوِّل Android في Liftoff Monetize.
- تم التحقّق من التوافق مع الإصدار 7.3.2.0 من محوِّل LiftoffMonetize لنظام التشغيل iOS.
- تم إنشاء هذا البرنامج واختباره باستخدام الإصدار 5.1.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.