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

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

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

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

يتضمّن محوّل التوسّط في "مدير إعلانات Google" لشبكة LY Ads Network الإمكانات التالية:

المتطلبات

• أحدث محتوى من قناة Google Mobile Ads Flutter Plugin
• الإصدار 3.7.0 من Flutter أو إصدار أحدث
• للنشر على Android
  • مستوى واجهة برمجة التطبيقات 23 من Android أو مستوى أعلى
• للنشر على أجهزة iOS
  • الإصدار 13.3 أو الإصدارات الأحدث من نظام التشغيل iOS
• مشروع Flutter يعمل تم إعداده باستخدام Google Mobile Ads Flutter Plugin لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Flutter Plugin.
• إعداد التوسّط

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

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

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

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

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

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

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

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

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

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

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

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

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

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

دوِّن معرّف مفتاح واجهة برمجة التطبيقات وسر مفتاح واجهة برمجة التطبيقات.

تعديل ملف app-ads.txt

مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع مساحات إعلانية متاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، عليك إنشاء ملف app-ads.txt في "مدير إعلانات Google".

لتنفيذ app-ads.txt لشبكة LY Ads Network، اطّلِع على لمحة عن app-ads.txt.

الخطوة 2: إعداد طلب LY Ads Network في واجهة مستخدم "مدير إعلانات Google"

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

الخطوة 3: استيراد حزمة تطوير البرامج والمحوّل الخاصَّين بشبكة LY Ads Network

الدمج من خلال pub.dev

أضِف الاعتمادية التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) والمحوّل لشبكة LY Ads في ملف pubspec.yaml الخاص بالحزمة:

dependencies:
  gma_mediation_line: ^2.1.0

الدمج اليدوي

نزِّل أحدث إصدار من مكوّن التوسّط الإضافي في "إعلانات Google للأجهزة الجوّالة" الخاص بـ LY Ads Network، واستخرِج الملف الذي تم تنزيله، ثم أضِف مجلد المكوّن الإضافي الذي تم استخراجه (ومحتوياته) إلى مشروع Flutter. بعد ذلك، أشِر إلى المكوّن الإضافي في ملف pubspec.yaml من خلال إضافة التبعية التالية:

dependencies:
  gma_mediation_line:
    path: path/to/local/package

الخطوة 4: إضافة الرمز المطلوب

الخطوة 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 ضمن الفئات التالية:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

GADMediationAdapterLine

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل LY Ads Network عندما يتعذّر تحميل إعلان:

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

الإصدار 2.1.1 (قيد التطوير)

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