يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads Flutter Plugin لتحميل الإعلانات وعرضها من LY Ads Network باستخدام التوسّط، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة LY Ads Network إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل LY Ads Network في تطبيق Flutter.
عمليات الدمج وأشكال الإعلانات المتوافقة
يملك محوّل التوسّط في "مدير الإعلانات" لـ LY Ads Network الإمكانات التالية:
| التكامل | |
|---|---|
| عروض الأسعار | |
| عرض إعلاني بدون انقطاع | |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| مقابل مكافأة | |
| مدمج مع المحتوى | |
المتطلبات الأساسية
قبل المتابعة، تأكَّد مما يلي:
- أحدث إصدار من Google Mobile Ads Flutter Plugin
- الإصدار 3.7.0 أو إصدار أحدث من إطار عمل Flutter
- للنشر على Android
- مستوى واجهة برمجة تطبيقات Android 23 أو إصدار أحدث
- للنشر على iOS
- هدف النشر على iOS 13.0 أو إصدار أحدث
- مشروع Flutter يعمل وتم ضبطه باستخدام Google Mobile Ads Flutter Plugin راجِع مقالة إعداد Google Mobile Ads Flutter Plugin للحصول على التفاصيل.
- إعداد التوسّط.
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم LY Ads Network
اشترِك وسجِّل الدخول إلى حسابك على LY Ads Network.
إضافة تطبيق جديد
انتقِل إلى علامة التبويب التطبيق وانقر على الزر تسجيل جديد.
املأ النموذج وانقر على التسجيل.
دوِّن رقم تعريف التطبيق.
Android
iOS
إنشاء خانة إعلانية
في علامة التبويب التطبيق ، اختَر تطبيقك لعرض تفاصيله. ضمن قسم موضع الإعلان ، انقر على إضافة.
املأ النموذج للحصول على تفاصيل حول موضع الإعلان. بالنسبة إلى نوع عروض الأسعار، اختَر عادي لضبط موضع الإعلان هذا للتوسّط المتسلسل، أو عروض أسعار باستخدام حِزم تطوير البرامج (SDK) من Google لضبط موضع الإعلان هذا لعروض الأسعار. انقر على إنشاء بعد ملء النموذج.
دوِّن رقم تعريف موضع الإعلان.
بعد إنشاء موضع الإعلان الأول، انقر على مراجعة في صفحة تفاصيل تطبيقك للحصول على الموافقة من LY Ads Network. وقد تستغرق هذه العملية بعض الوقت. يُرجى التواصل مع ممثل LY Ads Network إذا كانت لديك أي أسئلة.
إنشاء مفتاح واجهة برمجة تطبيقات لإعداد التقارير
انتقِل إلى علامة التبويب إدارة مفاتيح واجهة برمجة التطبيقات لإعداد التقارير وانقر على الزر إنشاء مفتاح واجهة برمجة تطبيقات.
املأ النموذج وانقر على حفظ.
دوِّن رقم تعريف مفتاح واجهة برمجة التطبيقات وسرّ مفتاح واجهة برمجة التطبيقات.
تعديل ملف app-ads.txt
تشكّل مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt مبادرة "للمختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنها مخوّلة. للحيلولة دون حدوث خسارة كبيرة في أرباح الإعلانات، عليك تنفيذ ملف app-ads.txt.
إذا لم يسبق لك إجراء ذلك،
عليك إنشاء ملف app-ads.txt لـ "مدير الإعلانات".
لتنفيذ app-ads.txt لـ LY Ads Network، راجِع
مقالة لمحة عن ملف app-ads.txt.
الخطوة 2: إعداد طلب LY Ads Network في واجهة مستخدم "مدير الإعلانات"
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، راجِع الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، راجِع الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) والمحوّل من LY Ads Network
التكامل من خلال pub.dev
أضِف الاعتمادية التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) والمحوّل من LY Ads Network في ملف pubspec.yaml لحزمتك:
dependencies:
gma_mediation_line: ^2.1.2
الدمج اليدوي
نزِّل أحدث إصدار من مكوّن التوسّط الإضافي لـ Google Mobile Ads من أجل
LY Ads Network،
واستخرِج الملف الذي تم تنزيله، وأضِف مجلد المكوّن الإضافي المستخرَج
(ومحتوياته) إلى مشروع Flutter. بعد ذلك، أشِر إلى المكوّن الإضافي في ملف pubspec.yaml عن طريق إضافة التبعية التالية:
dependencies:
gma_mediation_line:
path: path/to/local/package
الخطوة 4: إضافة الرمز المطلوب
Android
لا يلزم إضافة أي رمز إضافي لدمج LY Ads Network.
iOS
دمج SKAdNetwork
اتّبِع مستندات LY Ads Network
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist لمشروعك.
الخطوة 5: اختبار عملية الإعداد
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في "مدير الإعلانات".
التحقّق من الإعلانات الاختبارية
للتحقّق من أنّك تتلقّى إعلانات اختبارية من LY Ads Network، فعِّل اختبار مصدر إعلان فردي في أداة فحص الإعلانات باستخدام LY Ads Network مصدر(مصادر) الإعلانات.
خطوات اختيارية
المَعلمات الخاصة بالشبكة
يتوافق مكوّن التوسّط الإضافي لـ LY Ads Network Flutter مع مَعلمة الطلب الإضافية التالية التي يمكن تمريرها إلى المحوّل من خلال فئة LineMediationExtras:
-
enableAdSound: تحدّد حالة بدء الصوت التلقائية للإعلانات البانر والإعلانات البينية والإعلانات مقابل مكافأة.
في ما يلي مثال على رمز لكيفية إنشاء طلب عرض إعلان يضبط هذه المَعلمات:
LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [lineExtras],
);
رموز الخطأ
إذا تعذّر على المحوّل تلقّي إعلان من LY Ads Network،
يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام
ResponseInfo ضمن الفئات التالية:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل LY Ads Network عندما يتعذّر تحميل إعلان:
Android
iOS
سجلّ التغييرات في محوّل التوسّط لـ Line Flutter
الإصدار 2.1.2
- يتوافق مع الإصدار 3.1.1.1 من محوّل Line Android.
- يتوافق مع الإصدار 3.0.1.2 من محوّل Line iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
الإصدار 2.1.1
- يتوافق مع الإصدار 3.1.1.0 من محوّل Line Android.
- يتوافق مع الإصدار 3.0.1.2 من محوّل Line iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
الإصدار 2.1.0
- تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1
- تم التعديل ليتوافق مع الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
- يتوافق مع الإصدار 3.1.0.0 من محوّل Line Android.
- يتوافق مع الإصدار 3.0.1.0 من محوّل Line iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
الإصدار 2.0.0
- تم تعديل الحد الأدنى لإصدار Flutter إلى 3.35.1
- تم التعديل ليتوافق مع الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
- يتوافق مع الإصدار 3.0.1.0 من محوّل Line Android.
- يتوافق مع الإصدار 3.0.0.0 من محوّل Line iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
الإصدار 1.0.6
- يتوافق مع الإصدار 2.9.20251028.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20251119.0 من محوّل Line iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
الإصدار 1.0.5
- يتوافق مع الإصدار 2.9.20250924.1 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20250930.0 من محوّل Line iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
الإصدار 1.0.4
- يتوافق مع الإصدار 2.9.20250718.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20250512.0 من محوّل Line iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
الإصدار 1.0.3
- يتوافق مع الإصدار 2.9.20250519.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20250512.0 من محوّل Line iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
الإصدار 1.0.2
- يتوافق مع الإصدار 2.9.20250317.1 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20241106.3 من محوّل Line iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
الإصدار 1.0.1
- يتوافق مع الإصدار 2.9.20250110.1 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20241106.2 من محوّل Line iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads
الإصدار 1.0.0
- الإصدار الأوّلي.
- يتوافق مع الإصدار 2.9.20250110.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20241106.1 من محوّل Line iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads