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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (الإصدار القديم)

يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads Flutter Plugin لتحميل الإعلانات وعرضها من LY Ads Network باستخدام التوسّط، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة LY Ads Network إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل LY Ads Network في تطبيق Flutter.

عمليات الدمج وأشكال الإعلانات المتوافقة

يتمتّع محوّل التوسّط في "إدارة الإعلانات" لـ LY 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 للحصول على التفاصيل.
  • إعداد التوسّط.

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

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

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

انتقِل إلى علامة التبويب التطبيق وانقر على الزر تسجيل جديد.

تسجيل جديد

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

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

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

Android

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

iOS

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

إنشاء مساحة إعلانية

في علامة التبويب التطبيق ، اختَر تطبيقك لعرض تفاصيله. ضمن قسم المساحة الإعلانية ، انقر على إضافة.

إضافة خانة

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

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

دوِّن رقم تعريف المساحة الإعلانية.

تفاصيل الفتحة

بعد إنشاء المساحة الإعلانية الأولى، انقر على مراجعة في صفحة تفاصيل تطبيقك للحصول على الموافقة من LY Ads Network. وقد تستغرق هذه العملية بعض الوقت. يُرجى التواصل مع ممثل LY Ads Network إذا كان لديك أي أسئلة.

طلب مراجعة

إنشاء مفتاح Reporting API

انتقِل إلى علامة التبويب إدارة مفاتيح Reporting API وانقر على الزر إنشاء مفتاح API.

علامة التبويب "مفتاح Reporting API"

املأ النموذج وانقر على حفظ.

نموذج مفتاح Reporting API

دوِّن رقم تعريف مفتاح API وسرّ مفتاح API.

نموذج مفتاح Reporting API

تعديل ملف 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.1

الدمج اليدوي

نزِّل أحدث إصدار من مكوّن التوسّط الإضافي لإعلانات Google على الأجهزة الجوّالة لـ 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

رمز الخطأ النطاق السبب
1-10 com.five_corp.ad عرضت حزمة LY Ads Network SDK خطأً خاصًا بحزمة تطوير البرامج (SDK). راجِع مستندات LY Ads Network لمزيد من التفاصيل.
101 com.google.ads.mediation.line رقم تعريف التطبيق غير صالح أو غير متوفّر.
102 com.google.ads.mediation.line رقم تعريف المساحة الإعلانية غير صالح أو غير متوفّر.
103 com.google.ads.mediation.line لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع LY Ads Network.
104 com.google.ads.mediation.line تعذّر تحميل إعلان بيني أو إعلان مقابل مكافأة بسبب عدم توفّر سياق النشاط.
105 com.google.ads.mediation.line تعذّر على حزمة LY Ads Network SDK عرض إعلان بيني أو إعلان مقابل مكافأة.
106 com.google.ads.mediation.line تعذّر تحميل إعلان مدمج مع المحتوى بسبب عدم توفّر مواد العرض.

iOS

رمز الخطأ النطاق السبب
1-10 تم إرساله من حزمة LY Ads Network SDK عرضت حزمة LY Ads Network SDK خطأً خاصًا بحزمة تطوير البرامج (SDK). راجِع مستندات LY Ads Network لمزيد من التفاصيل.
101 com.google.ads.mediation.line مَعلمات الخادم غير صالحة (مثل رقم تعريف التطبيق أو رقم تعريف المساحة الإعلانية غير متوفّرَين).
102 com.google.ads.mediation.line لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع LY Ads Network.
103 com.google.ads.mediation.line تعذّر تحميل مادة عرض صورة رمز المعلومات في إعلان مدمج مع المحتوى.

سجلّ التغييرات في محوّل التوسّط لـ Line Flutter

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