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

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

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

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

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

• مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث

• أحدث إصدار من Google Mobile Ads SDK (Legacy)

• إعداد التوسّط

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لتنفيذ app-ads.txt لشبكة إعلانات LY، يُرجى الاطّلاع على المقالة لمحة عن ملف app-ads.txt.

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

سجِّل الدخول إلى حسابك على "مدير إعلانات Google".

إضافة LY Ads Network في "الشركات"

تفعيل ميزة "مشاركة الإشارات الآمنة"

مشاركة الإشارات الآمنة في طلبات عروض الأسعار

السماح بمشاركة الإشارات الآمنة في عروض أسعار SDK

ضبط عروض أسعار شبكة إعلانات LY

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

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

دمج "استوديو Android" (يُنصح به)

في ملف Gradle على مستوى التطبيق، أضِف تبعيات التنفيذ التالية:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

الدمج اليدوي

1. نزِّل أحدث إصدار من ملف .aar الخاص بحزمة SDK لشبكة LY Ads Network وأضِفه إلى مشروعك.

2. انتقِل إلى عناصر محوّل شبكة إعلانات LY في مستودع Maven من Google. اختَر أحدث إصدار، ونزِّل ملف .aar الخاص بمحوّل LY Ads Network، ثم أضِفه إلى مشروعك.

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

لا حاجة إلى استخدام رمز إضافي لدمج LY Ads Network.

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

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

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

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

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

التحقّق من الإعلانات الاختبارية

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

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

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

يتيح محوّل شبكة إعلانات LY استخدام مَعلمة طلب إضافية يمكن تمريرها إلى المحوّل باستخدام فئة LineExtras. تتضمن الدالة الإنشائية للفئة المعلمات التالية:

enableAdSound

‫boolean لتحديد حالة بدء الصوت التلقائية لإعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة.

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

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

استخدام الإعلانات المُدمَجة مع المحتوى

عرض الإعلانات

يملأ محوّل شبكة إعلانات LY الحقول التالية لـ NativeAd.

¹ بالنسبة إلى الإعلانات المدمجة مع المحتوى، لا توفّر حزمة تطوير البرامج (SDK) الخاصة بشبكة LY Ads Network عنصرًا خاصًا برمز التطبيق. بدلاً من ذلك، يملأ محوّل شبكة إعلانات LY رمز التطبيق بصورة شفافة.

رموز الخطأ

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

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

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

سجلّ تغييرات محوّل التوسّط في Android من LINE

الإصدار 3.1.1.2

• ثبِّت تبعية Kotlin للمحوّل على الإصدار 1.9.0 (الحد الأدنى لإصدار Kotlin المتوافق مع الجيل التالي من حزمة SDK لإعلانات Google على الأجهزة الجوّالة).

تم التصميم والاختبار باستخدام:

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.4.0 من "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 3.1.1.1 من حزمة تطوير البرامج (SDK) لمنصة FiveAd

الإصدار 3.1.1.1

• يتم ربط AgeRestrictedTreatment بواجهة برمجة التطبيقات ChildDirectedTreatment في Line.

تم التصميم والاختبار باستخدام:

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.2.1 من الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة
• ‫FiveAd SDK الإصدار 3.1.1.1

الإصدار 3.1.1.0

• تم التحقّق من التوافق مع الإصدار 3.1.1.0 من حزمة تطوير البرامج (SDK) لـ FiveAd.

تم التصميم والاختبار باستخدام:

• الإصدار 25.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.2.1 من الجيل التالي من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 3.1.1.0 من حزمة تطوير البرامج (SDK) لمنصة FiveAd

الإصدار 3.1.0.0

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

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 0.25.0-beta01 من "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 3.1.0.0

الإصدار 3.0.1.2

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 3.0.1.2 من حزمة تطوير البرامج (SDK) لمنصة FiveAd

الإصدار 3.0.1.1

• يتم الآن استبدال مرّات ظهور "الإعلانات المدمجة مع المحتوى" من خلال حزمة FiveAd SDK عند استخدام الإصدار 24.4.0 أو إصدار أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

تم إنشاؤه واختباره باستخدام:

• الإصدار 24.9.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 3.0.1.1

الإصدار 3.0.1.0

• تمت إضافة إمكانية إعادة توجيه مَعلمة tagForUnderAgeOfConsent في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى حزمة FiveAd SDK.
• تم التحقّق من التوافق مع الإصدار 3.0.1.0 من حزمة تطوير البرامج (SDK) لمنصة FiveAd.

تم التصميم والاختبار باستخدام:

• الإصدار 24.9.0 من SDK لإعلانات Google على الأجهزة الجوّالة
• الإصدار 3.0.1.0 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 3.0.0.0

• تم التحقّق من التوافق مع الإصدار 3.0.0.0 من حزمة تطوير البرامج (SDK) لمنصة FiveAd.

تم التصميم والاختبار باستخدام:

• الإصدار 24.9.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 3.0.0.0 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.9.20251028.0

• تم التأكّد من التوافق مع الإصدار 2.9.20251028 من حزمة تطوير البرامج (SDK) الخاصة بمنصة FiveAd.

تم إنشاؤه واختباره باستخدام:

• الإصدار 24.7.0 من SDK لإعلانات Google على الأجهزة الجوّالة
• الإصدار 2.9.20251028.0 من حزمة تطوير البرامج (SDK) لمنصة FiveAd

الإصدار 2.9.20250924.1

• تمت إزالة المراجع على مستوى الصف إلى Context. يمكن أن يساعد في الحدّ من مشاكل تسرُّب الذاكرة.

تم التصميم والاختبار باستخدام:

• الإصدار 24.7.0 من SDK لإعلانات Google على الأجهزة الجوّالة
• الإصدار 2.9.20250924.1 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.9.20250924.0

• تم التحقّق من التوافق مع الإصدار 2.9.20250924 من حزمة تطوير البرامج (SDK) الخاصة بمنصة FiveAd.

تم إنشاؤه واختباره باستخدام:

• الإصدار 24.6.0 من SDK لإعلانات Google على الأجهزة الجوّالة
• الإصدار 2.9.20250924.0 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.9.20250718.0

• تم التحقّق من التوافق مع الإصدار 2.9.20250718 من حزمة تطوير البرامج (SDK) الخاصة بمنصة FiveAd.

تم التصميم والاختبار باستخدام:

• الإصدار 24.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 2.9.20250718.0 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.9.20250519.0

• تم التحقّق من التوافق مع الإصدار 2.9.20250519 من حزمة تطوير البرامج (SDK) لمنصة FiveAd.

تم إنشاؤه واختباره باستخدام:

• الإصدار 24.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 2.9.20250519.0 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.9.20250317.1

• تم إصلاح أبعاد تحميل إعلانات البانر لإعلانات عروض الأسعار باستخدام واجهة برمجة التطبيقات الجديدة FiveAd API

تم التصميم والاختبار باستخدام:

• الإصدار 24.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 2.9.20250317.0

الإصدار 2.9.20250317.0

• تم التأكّد من التوافق مع الإصدار 2.9.20250317 من حزمة تطوير البرامج (SDK) الخاصة بمنصة FiveAd.

تم التصميم والاختبار باستخدام:

• الإصدار 24.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 2.9.20250317.0 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.9.20250110.1

• تم تعديل الحد الأدنى المطلوب لمستوى واجهة برمجة تطبيقات Android إلى 23.
• تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 24.0.0.

تم إنشاؤه واختباره باستخدام:

• الإصدار 24.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 2.9.20250110.0

الإصدار 2.9.20250110.0

• تمت إزالة الفئة UnifiedNativeAdMapper المتوقّفة نهائيًا واستخدام NativeAdMapper بدلاً منها
• تم إصلاح عملية جمع الإشارات.
• تم إصلاح عملية الإعداد الثابتة لكلّ من شكلَي الإعلان البيني والإعلان مقابل مكافأة للعرض بدون انقطاع.
• تم التحقّق من التوافق مع الإصدار 2.9.20250110 من حزمة تطوير البرامج (SDK) لـ FiveAd.

تم إنشاؤه واختباره باستخدام:

• الإصدار 23.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 2.9.20250110.0 من حزمة تطوير البرامج (SDK) لمنصة FiveAd

الإصدار 2.9.20241129.0

• تمّت إضافة إمكانية استخدام عروض الأسعار لأشكال "إعلانات البانر" و"الإعلانات البينية" و"الإعلانات مقابل مكافأة" و"الإعلانات المدمجة مع المحتوى".
• تم التأكّد من التوافق مع الإصدار 2.9.20241129 من حزمة تطوير البرامج (SDK) الخاصة بمنصة FiveAd.

تم إنشاؤه واختباره باستخدام:

• الإصدار 23.5.0 من SDK لإعلانات Google على الأجهزة الجوّالة
• ‫FiveAd SDK الإصدار 2.9.20241129.0

الإصدار 2.8.20240827.0

• تمّ التحقّق من التوافق مع الإصدار 2.8.20240827 من حزمة تطوير البرامج (SDK) لخدمة FiveAd.

تم التصميم والاختبار باستخدام:

• الإصدار 23.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 2.8.20240827.0 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.8.20240808.0

• تم التحقّق من التوافق مع الإصدار 2.8.20240808 من حزمة تطوير البرامج (SDK) لـ FiveAd.

تم التصميم والاختبار باستخدام:

• الإصدار 23.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 2.8.20240808.0 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.8.20240722.0

• تم التحقّق من التوافق مع الإصدار 2.8.20240722 من حزمة تطوير البرامج (SDK) لخدمة FiveAd.

تم التصميم والاختبار باستخدام:

• الإصدار 23.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 2.8.20240722.0 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.7.20240515.0

• تم التحقّق من التوافق مع الإصدار 2.7.20240515 من حزمة SDK لـ FiveAd.

تم التصميم والاختبار باستخدام:

• الإصدار 23.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 2.7.20240515.0

الإصدار 2.7.20240214.1

• تم تعديل الحدّ الأدنى المطلوب لإصدار "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 23.0.0.
• تم التحقّق من التوافق مع الإصدار 2.7.20240214 من حزمة تطوير البرامج (SDK) لمنصة FiveAd.

تم التصميم والاختبار باستخدام:

• الإصدار 23.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 2.7.20240214.0

الإصدار 2.7.20240214.0

• تم التحقّق من التوافق مع الإصدار 2.7.20240214 من حزمة تطوير البرامج (SDK) لمنصة FiveAd.

تم إنشاؤه واختباره باستخدام:

• الإصدار 22.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 2.7.20240214.0 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.7.20240126.0

• تم التحقّق من التوافق مع الإصدار 2.7.20240126 من حزمة تطوير البرامج (SDK) لإعلانات FiveAd.

تم إنشاؤه واختباره باستخدام:

• الإصدار 22.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 2.7.20240126.0 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.7.20240112.0

• تمت إزالة FiveAdViewEventListener التي تم إيقافها نهائيًا واستبدالها بـ FiveAdCustomLayoutEventListener وFiveAdVideoRewardEventListener وFiveAdInterstitialEventListener وFiveAdNativeEventListener.
• تم التأكّد من التوافق مع الإصدار 2.7.20240112 من حزمة تطوير البرامج (SDK) الخاصة بمنصة FiveAd.
• تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.6.0.

تم التصميم والاختبار باستخدام:

• الإصدار 22.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 2.7.20240112 من حزمة تطوير البرامج (SDK) لـ FiveAd

الإصدار 2.6.20230607.1

• تمت إضافة فئة LineExtras للناشرين لتحديد إعدادات الصوت التلقائية لأشكال "إعلانات البانر" و"الإعلانات البينية" و"الإعلانات مقابل مكافأة".
• تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.4.0.

تم إنشاؤه واختباره باستخدام:

• الإصدار 22.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 2.6.20230607 من حزمة تطوير البرامج (SDK) لمنصة FiveAd

الإصدار 2.6.20230607.0

• الإصدار الأوّلي
• إضافة دعم لأشكال الإعلانات التالية: إعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات المدمجة مع المحتوى
• تم التحقّق من التوافق مع الإصدار 2.6.20230607 من حزمة تطوير البرامج (SDK) لمنصة FiveAd.

تم إنشاؤه واختباره باستخدام:

• الإصدار 22.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 2.6.20230607