يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads Flutter Plugin لتحميل الإعلانات وعرضها من LINE Ads Network باستخدام التوسّط، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة LINE Ads Network إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل LINE Ads Network في تطبيق Flutter.
عمليات الدمج وأشكال الإعلانات المتوافقة
يتضمّن برنامج التكييف الخاص بخدمة "توسّط AdMob" لشبكة LINE 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.
- إعداد ميزة "توسّط AdMob"
الخطوة 1: إعداد الإعدادات في واجهة مستخدم "شبكة إعلانات LINE"
اشترِك وسجِّل الدخول إلى حسابك على LINE Ads Network.
إضافة تطبيق جديد
انتقِل إلى علامة التبويب アプリ (التطبيق) وانقر على الزر 新規登録 (تسجيل جديد).
املأ النموذج وانقر على 登録 (تسجيل).
دوِّن アプリID (معرّف التطبيق).
Android
iOS
إنشاء مساحة إعلانية
في علامة التبويب アプリ (التطبيق)، اختَر تطبيقك لعرض تفاصيله. ضمن قسم スロット (الخانة)، انقر على 追加 (إضافة).
املأ النموذج للحصول على تفاصيل حول الفترة الزمنية. بالنسبة إلى نوع عروض الأسعار، اختَر عادي لضبط هذه الخانة من أجل توسّط العرض الإعلاني بدون انقطاع، أو عروض الأسعار باستخدام حِزم تطوير البرامج (SDK) من Google لضبط هذه الخانة من أجل عروض الأسعار. انقر على 作成 (إنشاء) بعد ملء النموذج.
دوِّن رقم تعريف الخانة (Slot ID).
تعديل ملف app-ads.txt
مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة من "مختبر IAB التقني" تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt.
إذا لم يسبق لك إجراء ذلك، عليك إعداد ملف app-ads.txt لتطبيقك.
لتنفيذ app-ads.txt لشبكة LINE Ads Network، اطّلِع على
لمحة عن app-ads.txt.
الخطوة 2: إعداد طلب LINE Ads Network في واجهة مستخدم AdMob
ضبط إعدادات التوسّط للوحدة الإعلانية
Android
للحصول على التعليمات، راجِع الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج والمحوّل الخاصَّين بشبكة LINE الإعلانية
التكامل من خلال pub.dev
أضِف مصدر الاعتمادية التالي مع أحدث إصدارات حزمة تطوير البرامج (SDK) والمحوّل لشبكة LINE Ads Network في ملف pubspec.yaml الخاص بالحزمة:
dependencies:
gma_mediation_line: ^2.0.0
الدمج اليدوي
نزِّل أحدث إصدار من المكوّن الإضافي للتوسّط في "إعلانات Google على الأجهزة الجوّالة" من أجل LINE Ads Network، واستخرِج الملف الذي تم تنزيله، وأضِف مجلد المكوّن الإضافي الذي تم استخراجه (ومحتوياته) إلى مشروع Flutter. بعد ذلك، أشِر إلى المكوّن الإضافي في ملف pubspec.yaml من خلال إضافة التبعية التالية:
dependencies:
gma_mediation_line:
path: path/to/local/package
الخطوة 4: إضافة الرمز المطلوب
Android
لا يلزم توفير رمز إضافي لدمج "شبكة إعلانات LINE".
iOS
تكامل SKAdNetwork
اتّبِع مستندات LINE Ads Network
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 5: اختبار عملية الإعداد
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob.
تأكيد الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من LINE Ads Network، فعِّل اختبار مصدر إعلان فردي في أداة فحص الإعلانات باستخدام مصادر الإعلانات LINE Ads Network (العرض الإعلاني بدون انقطاع).
خطوات اختيارية
المَعلمات الخاصة بالشبكة
يتيح مكوّن التوسّط الإضافي في LINE 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],
);
رموز الخطأ
إذا لم يتمكّن المحوّل البرمجي من تلقّي إعلان من LINE Ads Network، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo ضمن الفئات التالية:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل LINE Ads Network عندما يتعذّر تحميل إعلان:
Android
| رمز الخطأ | النطاق | السبب |
|---|---|---|
| 1-10 | com.five_corp.ad | أرجعت حزمة تطوير البرامج (SDK) لشبكة LINE الإعلانية خطأ خاصًا بحزمة تطوير البرامج (SDK). يمكنك الاطّلاع على المستندات الخاصة بشبكة إعلانات LINE Ads Network لمزيد من التفاصيل. |
| 101 | com.google.ads.mediation.line | رقم تعريف التطبيق غير متوفّر أو غير صالح. |
| 102 | com.google.ads.mediation.line | معرّف الخانة غير متوفّر أو غير صالح. |
| 103 | com.google.ads.mediation.line | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع شبكة LINE Ads Network. |
| 104 | com.google.ads.mediation.line | تعذّر تحميل إعلان بيني أو إعلان مقابل مكافأة بسبب عدم توفّر سياق النشاط. |
| 105 | com.google.ads.mediation.line | تعذّر على حزمة تطوير البرامج (SDK) لشبكة LINE Ads Network عرض إعلان بيني أو إعلان مقابل مكافأة. |
| 106 | com.google.ads.mediation.line | تعذّر تحميل إعلان مدمج مع المحتوى بسبب عدم توفّر مواد العرض. |
iOS
| رمز الخطأ | النطاق | السبب |
|---|---|---|
| 1-10 | يتم إرسالها من خلال حزمة تطوير البرامج (SDK) لشبكة LINE Ads Network | أرجعت حزمة تطوير البرامج (SDK) لشبكة LINE الإعلانية خطأ خاصًا بحزمة تطوير البرامج (SDK). يمكنك الاطّلاع على المستندات الخاصة بشبكة إعلانات LINE Ads Network لمزيد من التفاصيل. |
| 101 | com.google.ads.mediation.line | مَعلمات الخادم غير صالحة (مثل رقم تعريف التطبيق أو رقم تعريف الخانة غير متوفّر). |
| 102 | com.google.ads.mediation.line | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع شبكة LINE Ads Network. |
| 103 | com.google.ads.mediation.line | تعذّر تحميل مادة عرض صورة رمز المعلومات في الإعلان المدمج مع المحتوى. |
سجلّ التغييرات في "محوّل وساطة Line Flutter"
الإصدار 2.0.1 (قيد التطوير)
الإصدار 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.