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

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

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

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

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

المتطلبات

• أحدث محتوى من قناة Google Mobile Ads Unity Plugin
• ‫Unity 4 أو الإصدارات الأحدث
• [لتقديم عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم مكوّنًا إضافيًا للتوسّط في "إعلانات Google على الأجهزة الجوّالة" خاصًا بحزمة LY Ads Network SDK 1.5.0 أو إصدار أحدث (يُنصح باستخدام أحدث إصدار).
• للنشر على Android
  • مستوى واجهة برمجة التطبيقات 23 من Android أو مستوى أعلى
• للنشر على أجهزة iOS
  • الإصدار 13.3 أو الإصدارات الأحدث من نظام التشغيل iOS
• مشروع Unity يعمل وتم إعداده باستخدام Google Mobile Ads Unity Plugin لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Unity 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

openupm add com.google.ads.mobile.mediation.line

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

الخطوة 5: اختبار عملية الإعداد

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

تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات".

تأكيد الإعلانات الاختبارية

للتأكّد من تلقّي إعلانات اختبارية من شبكة LY Ads Network، فعِّل اختبار مصدر إعلان فردي في أداة فحص الإعلانات باستخدام مصادر الإعلانات LY Ads Network.

خطوات اختيارية

المَعلمات الخاصة بالشبكة

يتيح مكوّن LY Ads Network الإضافي للتوسّط في Unity معلَمة الطلب الإضافية التالية التي يمكن تمريرها إلى المحوّل من خلال الفئة LineMediationExtras:

• ‫SetEnableAdSound(boolean) : تحدّد هذه السمة حالة بدء الصوت التلقائية في إعلانات البانر والإعلانات البينية والإعلانات مقابل المكافأة.

في ما يلي مثال على الرمز البرمجي لكيفية إنشاء طلب عرض إعلان يضبط هذه المَعلمات:

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);

رموز الخطأ

إذا لم يتمكّن المحوّل من تلقّي إعلان من LY Ads Network، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo ضمن الفئات التالية:

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

GADMediationAdapterLine

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

سجلّ التغييرات في Line Unity Mediation Plugin

الإصدار 2.1.0

• يتوافق مع الإصدار 3.1.0.0 من محوّل Line Android.
• يتوافق مع الإصدار 3.0.1.0 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 11.0.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 2.0.2

• يتوافق مع الإصدار 3.0.1.1 من محوّل Line Android.
• يتوافق مع الإصدار 3.0.1.0 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 11.0.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 2.0.1

• يتوافق مع الإصدار 3.0.1.1 من محوّل Line Android.
• يتوافق مع الإصدار 3.0.0.1 من محوّل Line لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 11.0.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 2.0.0

• يتوافق مع الإصدار 3.0.1.0 من محوّل Line Android.
• يتوافق مع الإصدار 3.0.0.0 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.7.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.

الإصدار 1.5.10

• يتوافق مع الإصدار 2.9.20251028.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.9.20251119.0 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.6.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.5.9

• يتوافق مع الإصدار 2.9.20251028.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.9.20250930.0 من محوّل Line لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.6.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.5.8

• يتوافق مع الإصدار 2.9.20250924.1 من محوّل Line Android.
• يتوافق مع الإصدار 2.9.20250930.0 من محوّل Line لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.5.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.5.7

• يتوافق مع الإصدار 2.9.20250924.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.9.20250912.0 من محوّل Line لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.5.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.5.6

• يتوافق مع الإصدار 2.9.20250718.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.9.20250512.0 من محوّل Line لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.3.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.

الإصدار 1.5.5

• تم حلّ مشكلة عدم استيراد الحِزم بشكلٍ صحيح عند التثبيت من خلال OpenUPM.

الإصدار 1.5.4

• يتوافق مع الإصدار 2.9.20250519.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.9.20250512.0 من محوّل Line لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.1.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.5.3

• تم الآن إنشاء المكوّن الإضافي Unity باستخدام الإصدار 35 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
• يتوافق مع الإصدار 2.9.20250317.1 من محوّل Line Android.
• يتوافق مع الإصدار 2.9.20241106.3 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.1.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.5.2

• يتوافق مع الإصدار 2.9.20250110.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.9.20241106.2 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.0.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.

الإصدار 1.5.1

• يتوافق مع الإصدار 2.9.20250110.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.9.20241106.1 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.5.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.5.0

• يتوافق مع الإصدار 2.9.20241129.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.9.20241106.1 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.5.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.4.0

• يتوافق مع الإصدار 2.8.20240827.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.9.20241106.1 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.4.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.

الإصدار 1.3.1

• يتوافق مع الإصدار 2.8.20240808.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.8.20240612.0 من محوّل Line لنظام التشغيل iOS.
• تم إنشاء هذا الإصدار واختباره باستخدام الإصدار 9.2.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.

الإصدار 1.3.0

• يتوافق مع الإصدار 2.8.20240722.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.8.20240612.0 من محوّل Line لنظام التشغيل iOS.
• تم إنشاء هذا الإصدار واختباره باستخدام الإصدار 9.2.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.

الإصدار 1.2.0

• يتوافق مع الإصدار 2.7.20240515.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.8.20240612.0 من محوّل Line لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.1 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.

الإصدار 1.1.2

• يتوافق مع الإصدار 2.7.20240515.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.7.20240411.0 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.1.1

• يتوافق مع الإصدار 2.7.20240214.1 من محوّل Line Android.
• يتوافق مع الإصدار 2.7.20240411.0 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.1.0

• تمت إضافة الفئة LineMediationExtras مع الطرق التالية لتوفير إمكانية تمرير إضافات التوسّط.
  • SetEnabledAdSound(bool)
• يتوافق مع الإصدار 2.7.20240214.1 من محوّل Line Android.
• يتوافق مع الإصدار 2.7.20240318.0 من محوّل Line iOS.
• تم إنشاء هذا الإصدار واختباره باستخدام الإصدار 9.0.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.0.0

• الإصدار الأوّلي
• يتوافق مع الإصدار 2.6.20230607.0 من محوّل Line Android.
• يتوافق مع الإصدار 2.6.20230609.0 من محوّل Line iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 8.5.1 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.