دمج Line مع التوسّط

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

يوضّح لك هذا الدليل كيفية استخدام GMA Next-Gen SDK لتحميل الإعلانات وعرضها من LINE Ads Network باستخدام توسط AdMob، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة LINE Ads Network إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل LINE Ads Network في تطبيق Android.

تستخدم واجهة لوحة البيانات في LINE Ads Network نصًا يابانيًا للتصنيفات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة في هذا الدليل. في المقابل، يتم في أوصاف هذا الدليل وتعليماته الإشارة إلى التصنيفات والأزرار باستخدام ما يعادلها باللغة الإنجليزية بين قوسين.

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

يتضمّن برنامج التكيّف للتوسّط في "شبكة إعلانات LINE" الإمكانات التالية:

المتطلبات

• المستوى 24 لواجهة برمجة التطبيقات في Android أو مستوى أعلى

• [لتقديم عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم الإصدار 2.9.20241129.0 أو الإصدارات الأحدث من محوّل LINE Ads Network (يُنصح باستخدام أحدث إصدار).

• أحدث محتوى من قناة GMA Next-Gen SDK

• أكمِل دليل البدء في التوسّط.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عليك إضافة LINE Ads Network إلى إعدادات التوسّط لوحدتك الإعلانية.

أولاً، سجِّل الدخول إلى حسابك على AdMob، ثم انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، ثم انتقِل إلى إضافة LINE Ads Network كمصدر إعلان.

لإنشاء مجموعة توسّط جديدة، انقر على إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصة، ثم انقر على متابعة.

امنح مجموعة التوسّط اسمًا واختَر المواقع الجغرافية التي تريد استهدافها، ثم اضبط حالة مجموعة التوسّط على مفعّلة، وانقر على إضافة وحدات إعلانية.

اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية الحالية على AdMob، ثمّ انقر على تم.

من المفترض أن تظهر الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:

إضافة LINE Ads Network كمصدر إعلان

عروض الأسعار

ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، اختَر LINE Ads Network.

انقر على كيفية التوقيع على اتفاقية شراكة وإعداد شراكة مستندة إلى عروض الأسعار مع LINE Ads Network.



انقر على الإقرار والموافقة، ثمّ انقر على متابعة.



إذا كان لديك عملية ربط حالية لشبكة LINE Ads Network، يمكنك اختيارها. بخلاف ذلك، انقر على إضافة عملية ربط.



بعد ذلك، أدخِل معرّف التطبيق ومعرّف الخانة الذي حصلت عليهما في القسم السابق. بعد ذلك، انقر على تم.

شلال

ضمن بطاقة العرض بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان.

اختَر LINE Ads Network وفعِّل مفتاح التبديل التحسين. أدخِل اسم تسجيل الدخول وكلمة المرور اللذين حصلت عليهما في القسم السابق لإعداد ميزة "تحسين مصدر الإعلانات" لشبكة LINE Ads Network. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور لشبكة LINE Ads Network وانقر على متابعة.



إذا كان لديك عملية ربط حالية بـ "شبكة إعلانات LINE"، يمكنك اختيارها. بخلاف ذلك، انقر على إضافة عملية ربط.

بعد ذلك، أدخِل معرّف التطبيق ومعرّف الخانة الذي حصلت عليهما في القسم السابق. بعد ذلك، انقر على تم.

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1")
    implementation("com.google.ads.mediation:line:3.1.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'
    implementation 'com.google.ads.mediation:line:3.1.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

الدمج اليدوي

1. نزِّل أحدث إصدار من ملف .aar لحزمة تطوير البرامج (SDK) الخاصة بشبكة LINE الإعلانية وأضِفه إلى مشروعك.

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

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

لا يلزم توفير رمز إضافي لدمج "شبكة إعلانات LINE".

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

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

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

يحتوي محوّل LINE Ads Network على طريقة مساعدة لتفعيل وضع الاختبار في LINE Ads Network. يجب ضبط هذا الخيار قبل بدء GMA Next-Gen SDK لضمان إعادة توجيهها بشكل صحيح إلى حزمة تطوير البرامج (SDK) الخاصة بشبكة LINE الإعلانية.

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

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

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

للتأكّد من أنّك تتلقّى إعلانات اختبارية من LINE Ads Network، فعِّل اختبار مصدر إعلان فردي في أداة فحص الإعلانات باستخدام مصادر الإعلانات LINE Ads Network (العرض الإعلاني بدون انقطاع).

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

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

يتيح محوّل LINE Ads Network مَعلمة طلب إضافية يمكن تمريرها إلى المحوّل باستخدام الفئة 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

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

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

يملأ محوّل LINE Ads Network أوصاف الحقول المتقدّمة للإعلانات المدمجة مع المحتوى التالية NativeAd.

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

رموز الخطأ

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

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

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

سجلّ التغييرات في "محوّل التوسّط" لتطبيق LINE على Android

الإصدار التالي

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

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

الإصدار 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 على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 3.0.1.2

الإصدار 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 على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 3.0.1.0

الإصدار 3.0.0.0

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

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

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

الإصدار 2.9.20251028.0

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

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

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

الإصدار 2.9.20250924.1

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

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

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

الإصدار 2.9.20250924.0

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

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

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

الإصدار 2.9.20250718.0

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

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

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

الإصدار 2.9.20250519.0

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

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

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

الإصدار 2.9.20250317.1

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

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

• الإصدار 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 على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 2.9.20250317.0

الإصدار 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 على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 2.9.20250110.0

الإصدار 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 على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 2.8.20240827.0

الإصدار 2.8.20240808.0

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

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

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

الإصدار 2.8.20240722.0

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

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

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

الإصدار 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 على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 2.7.20240214.0

الإصدار 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 على الأجهزة الجوّالة"
• ‫FiveAd SDK الإصدار 2.7.20240112

الإصدار 2.6.20230607.1

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

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

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

الإصدار 2.6.20230607.0

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

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

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