يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من Liftoff Monetize باستخدام التوسّط، والتي تغطي كلاً من عروض الأسعار عمليات دمج العرض الإعلاني بدون انقطاع. يتناول الفيديو كيفية إضافة Liftoff Monetize إلى قائمة الوحدات الإعلانية تهيئة التوسط، وكيفية دمج Vungle SDK ومحوّل 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
اشترِك أو سجِّل الدخول إلى حسابك على Liftoff Monetize.
أضف تطبيقك إلى لوحة تحكم Liftoff Monetize عن طريق النقر على الزر Add Application (إضافة تطبيق).
املأ النموذج، مع إدخال جميع التفاصيل المطلوبة.
Android
iOS
بعد إنشاء تطبيقك، اختَر تطبيقك من لوحة بيانات تطبيقات تحقيق الربح من Liftoff.
Android
iOS
دوِّن رقم تعريف التطبيق.
Android
iOS
إضافة مواضع جديدة
لإنشاء موضع إعلان جديد لاستخدامه مع AdMob التوسّط، انتقل إلى لوحة بيانات مواضع تحقيق الربح من Liftoff، وانقر على الزر إضافة موضع إعلان واختَر تطبيقك من القائمة المنسدلة.
في ما يلي تفاصيل إضافة مواضع جديدة:
فتح التطبيق
اختر إعلان بيني وأدخِل اسم موضع الإعلان. بعد ذلك، اختَر نعم للخيار قابل للتخطي، واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح عروض الأسعار داخل التطبيق إلى مفعّلة. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
بانر
اختر بانر، وأدخِل اسم موضع الإعلان، واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح عروض الأسعار داخل التطبيق إلى مفعّلة. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
بانر 300×250
انقر على MREC، وأدخِل اسم موضع الإعلان، واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح عروض الأسعار داخل التطبيق إلى مفعّلة. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
إعلان بيني
اختر إعلان بيني، ثم أدخل اسم موضع الإعلان، واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح عروض الأسعار داخل التطبيق إلى مفعّلة. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
تم منح المكافأة
انقر على إعلان بمكافأة، وأدخِل اسم موضع الإعلان، واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح عروض الأسعار داخل التطبيق إلى مفعّلة. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
الإعلانات البينية التي تضم مكافأة
انقر على مكافأة. أدخل اسم موضع الإعلان، وفعِّل قابل للتخطي، واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح عروض الأسعار داخل التطبيق إلى مفعّلة. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
مدمجة مع المحتوى
حدد إعلان مدمج مع المحتوى، وأدخل اسم موضع الإعلان، واملأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، بدِّل مفتاح عروض الأسعار داخل التطبيق إلى مفعّلة. انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.
دوِّن رقم التعريف المرجعي وانقر على صوت جيد.
فتح التطبيق
بانر
بانر 300×250
إعلان بيني
تم منح المكافأة
الإعلانات البينية التي تضم مكافأة
مدمجة مع المحتوى
تحديد موقع مفتاح واجهة برمجة التطبيقات Reporting API
عروض الأسعار
هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
بالإضافة إلى رقم تعريف التطبيق ورقم التعريف المرجعي، ستحتاج أيضًا إلى مفتاح واجهة برمجة تطبيقات إعداد التقارير في Liftoff Monetize لإعداد AdMob رقم تعريف الوحدة الإعلانية. انتقِل إلى لوحة بيانات تحقيق الربح من Liftoff وانقر على الزر Reporting API Key (مفتاح واجهة برمجة التطبيقات لإعداد التقارير) للاطّلاع على مفتاح واجهة برمجة التطبيقات Reporting API.
تفعيل وضع الاختبار
لتفعيل الإعلانات الاختبارية، انتقِل إلى لوحة بيانات Liftoff Monetize وانتقل إلى التطبيقات.
اختَر تطبيقك الذي تريد تفعيل إعلانات الاختبار له ضمن قسم رقم التعريف المرجعي لموضع الإعلان في تطبيقك. ويمكن تفعيل الإعلانات الاختبارية باختيار وضع الاختبار على عرض الإعلانات الاختبارية فقط ضمن قسم الحالة.
Android
iOS
الخطوة 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 السياسة، يجب التأكّد من الإفصاح عن معلومات معيّنة الموافقات التي تم الحصول عليها من المستخدمين في المنطقة الاقتصادية الأوروبية في ما يتعلق استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية و"حماية البيانات العامة" اللائحة (اللائحة العامة لحماية البيانات). عند طلب الحصول على موافقة، عليك تحديد كل شبكة إعلانات. في سلسلة التوسط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها تقدم معلومات حول استخدام كل شبكة. يتعذّر على 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 ضمن الفئات التالية:
iOS
| التنسيق | اسم الصف |
|---|---|
| بانر | GADMAdapterVungleInterstitial |
| إعلان بيني | GADMAdapterVungleInterstitial |
| تم منح المكافأة | GADMAdapterVungleRewardBasedVideoAd |
في ما يلي الرموز والرسائل المرفقة التي تم إصدارها من خلال Liftoff Monetize المحول عند إخفاق تحميل الإعلان:
iOS
| رمز الخطأ | السبب |
|---|---|
| 1-100 | عرَضَ Vungle SDK خطأً. الاطّلاع على الرمز لمزيد من التفاصيل. |
| 101 | مَعلمات خادم Liftoff Monetize التي تم ضبطها في واجهة المستخدم AdMob غير متوفّرة أو غير صالحة. |
| 102 | سبق أن تم تحميل إعلان لإعداد الشبكة هذه. يتعذَّر على Vungle SDK تحميل إعلان ثانٍ لرقم تعريف الموضع نفسه. |
| 103 | لا يتطابق حجم الإعلان المطلوب مع حجم البانر المتوافق مع Liftoff Monetize. |
| 104 | تعذَّر على Vungle SDK عرض إعلان البانر. |
| 105 | لا تدعم Vungle SDK تحميل سوى إعلان بانر واحد في كل مرة، بغض النظر عن رقم تعريف موضع الإعلان. |
| 106 | أرسلت Vungle SDK معاودة الاتصال تفيد بأن الإعلان غير قابل للتشغيل. |
سجلّ تغييرات محوّل وساطة Liftoff Flutter
الإصدار 1.0.0
- الإصدار الأولي.
- تم التحقّق من التوافق مع الإصدار 7.3.1.0 من محوّل Liftoff Monetize لجهاز Android
- تم التحقّق من التوافق مع الإصدار 7.3.2.0 لمحوّل LiftoffMonetize لنظام التشغيل iOS
- تم إنشاء هذا البرنامج واختباره باستخدام الإصدار 5.1.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.