يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads Flutter Plugin لتحميل الإعلانات وعرضها من LINE Ads Network باستخدام التوسّط، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة LINE Ads Network إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل LINE Ads Network في تطبيق Flutter.
عمليات الدمج وأشكال الإعلانات المتاحة
يملك محوّل التوسّط في "إدارة الإعلانات" لـ LINE Ads Network الإمكانات التالية:
| التكامل | |
|---|---|
| عروض الأسعار | |
| عرض إعلاني بدون انقطاع | |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| مقابل مكافأة | |
| مدمج مع المحتوى | |
المتطلبات
- أحدث إصدار من Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android
- المستوى 23 من واجهة برمجة تطبيقات Android أو إصدار أحدث
- للنشر على iOS
- هدف النشر على iOS هو الإصدار 13.3 أو إصدار أحدث
- مشروع Flutter يعمل وتم ضبطه باستخدام Google Mobile Ads Flutter Plugin راجِع مقالة إعداد Google Mobile Ads Flutter Plugin للحصول على التفاصيل.
- إعداد التوسّط.
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم LINE Ads Network
اشترِك وسجِّل الدخول إلى حسابك على LINE Ads Network.
إضافة تطبيق جديد
انتقِل إلى علامة التبويب アプリ (التطبيق) وانقر على الزر 新規登録 (تسجيل جديد).
املأ النموذج وانقر على 登録 (تسجيل).
دوِّن アプリID (رقم تعريف التطبيق).
Android
iOS
إنشاء خانة إعلانية
في علامة التبويب アプリ (التطبيق) ، اختَر تطبيقك لعرض تفاصيله. ضمن قسم スロット (الخانة) ، انقر على 追加 (إضافة).
املأ النموذج للحصول على تفاصيل حول الخانة. بالنسبة إلى نوع عروض الأسعار، اختَر عادي لضبط هذه الخانة من أجل التوسّط المتسلسل، أو عروض أسعار باستخدام حِزم تطوير البرامج (SDK) من Google لضبط هذه الخانة من أجل عروض الأسعار. انقر على 作成 (إنشاء) بعد ملء النموذج.
دوِّن スロットID (رقم تعريف الخانة).
تعديل ملف app-ads.txt
تشكّل مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt مبادرة "للمختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنها مخوّلة. للحيلولة دون حدوث خسارة كبيرة في أرباح الإعلانات، عليك تنفيذ ملف app-ads.txt.
إذا لم يسبق لك إجراء ذلك،
عليك إنشاء ملف app-ads.txt لـ "إدارة الإعلانات".
لتنفيذ app-ads.txt لـ LINE Ads Network، راجِع
مقالة لمحة عن ملف app-ads.txt.
الخطوة 2: إعداد طلب LINE Ads Network في واجهة مستخدم "إدارة الإعلانات"
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، راجِع الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، راجِع الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوّل LINE Ads Network
التكامل من خلال pub.dev
أضِف التبعية التالية مع أحدث إصدارَين من حزمة تطوير البرامج (SDK) ومحوّل LINE Ads Network في ملف pubspec.yaml لحزمتك:
dependencies:
gma_mediation_line: ^2.1.0
الدمج اليدوي
نزِّل أحدث إصدار من مكوّن التوسّط الإضافي لـ Google Mobile Ads من أجل
LINE Ads Network،
واستخرِج الملف الذي تم تنزيله، وأضِف مجلد المكوّن الإضافي الذي تم استخراجه
(ومحتوياته) إلى مشروع Flutter. بعد ذلك، أشِر إلى المكوّن الإضافي في ملف pubspec.yaml عن طريق إضافة التبعية التالية:
dependencies:
gma_mediation_line:
path: path/to/local/package
الخطوة 4: إضافة الرمز المطلوب
Android
لا يلزم إضافة أي رمز إضافي لدمج LINE Ads Network.
iOS
دمج SKAdNetwork
اتّبِع مستندات LINE Ads Network
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist في مشروعك.
الخطوة 5: اختبار عملية الدمج
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات".
التحقّق من الإعلانات الاختبارية
للتحقّق من أنّك تتلقّى إعلانات اختبارية من 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 Ads Network خطأ خاصًا بحزمة تطوير البرامج (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 Ads Network خطأ خاصًا بحزمة تطوير البرامج (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.1.1 (قيد التطوير)
الإصدار 2.1.0
- تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1
- تم التعديل ليتوافق مع الإصدار 8.0.0 من مكوّن Google Mobile Ads Flutter الإضافي
- يتوافق مع الإصدار 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 من مكوّن Google Mobile Ads Flutter الإضافي
- يتوافق مع الإصدار 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 من مكوّن Google Mobile Ads Flutter الإضافي
الإصدار 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 من مكوّن Google Mobile Ads Flutter الإضافي
الإصدار 1.0.1
- يتوافق مع الإصدار 2.9.20250110.1 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20241106.2 من محوّل Line iOS.
- تم الإنشاء والاختبار باستخدام الإصدار 5.3.1 من مكوّن Google Mobile Ads Flutter الإضافي
الإصدار 1.0.0
- الإصدار الأوّلي.
- يتوافق مع الإصدار 2.9.20250110.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20241106.1 من محوّل Line iOS.
- تم الإنشاء والاختبار باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads