دمج LINE Ads Network مع التوسّط

اختيار النظام الأساسي: Android جديد Android iOS Unity Flutter

يوضّح لك هذا الدليل كيفية استخدام 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
  • ‫Flutter 3.7.0 أو إصدار أحدث
  • للنشر على Android
    • مستوى واجهة برمجة التطبيقات 23 من Android أو إصدار أحدث
  • للنشر على iOS
    • هدف النشر على iOS هو الإصدار 13.0 أو إصدار أحدث
  • مشروع Flutter يعمل وتم ضبطه باستخدام Google Mobile Ads Flutter Plugin. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads Flutter Plugin.
  • إعداد ميزة "توسّط AdMob".

الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم LINE Ads Network

اشترك وسجّل الدخول إلى حسابك على LINE Ads Network.

إضافة تطبيق جديد

انتقِل إلى علامة التبويب アプリ (التطبيق) وانقر على الزر 新規登録 (تسجيل جديد).

تسجيل جديد

املأ النموذج وانقر على 登録 (تسجيل).

نموذج تسجيل جديد

دوِّن رقم تعريف التطبيق (App ID).

Android

تفاصيل التسجيل

iOS

تفاصيل التسجيل

إنشاء خانة إعلانية

في علامة التبويب アプリ (التطبيق) ، اختَر تطبيقك لعرض تفاصيله. ضمن قسم スロット (الخانة) ، انقر على 追加 (إضافة).

إضافة خانة

املأ النموذج للحصول على تفاصيل حول الخانة. بالنسبة إلى نوع عروض الأسعار (Bidding Type)، اختَر عادي (Standard) لضبط هذه الخانة من أجل توسّط العرض الإعلاني بدون انقطاع، أو عروض أسعار باستخدام حِزم تطوير البرامج (SDK) من Google‏ (Google SDK Bidding) لضبط هذه الخانة من أجل عروض الأسعار. انقر على 作成 (إنشاء) بعد ملء النموذج.

إضافة نموذج خانة

دوِّن رقم تعريف الخانة (Slot 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 في واجهة مستخدم AdMob

ضبط إعدادات التوسّط لوحدتك الإعلانية

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: اختبار عملية الإعداد

تفعيل الإعلانات الاختبارية

تأكَّد من تسجيل جهازك الاختباري في 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 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.0

الإصدار 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

الإصدار 1.0.5

الإصدار 1.0.4

الإصدار 1.0.3

الإصدار 1.0.2

الإصدار 1.0.1

الإصدار 1.0.0

  • الإصدار الأوّلي.
  • يتوافق مع الإصدار 2.9.20250110.0 من محوّل Line لنظام التشغيل Android
  • يتوافق مع الإصدار 2.9.20241106.1 من محوّل Line لنظام التشغيل iOS
  • تم الإنشاء والاختبار باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads