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

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

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

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

يتضمّن برنامج التكيّف الخاص بالتوسّط في شبكة LINE Ads Network الإمكانات التالية:

التكامل
عروض الأسعار  1
شلال
التنسيقات
بانر
إعلان بيني
تم منح المكافأة
مدمجة مع المحتوى

1 تتوفّر ميزة دمج عروض الأسعار في إصدار تجريبي مغلق، لذا يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.

المتطلبات

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

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

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

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

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

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

انقر على 広告枠管理 (إدارة الخانات الإعلانية) > メディア (الوسائط). بعد ذلك، انقر على 新規作成 (إنشاء جديد).

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

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

إنشاء موضع إعلان

انقر على معرّف التطبيق الذي تريد إضافة موضع إعلان إليه. بعد ذلك، انقر على 詳細 (التفاصيل).

انقر على スロット 追加 (إضافة خانة).

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

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

تعديل ملف 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 الإعلانية، يمكنك اختيارها. بخلاف ذلك، انقر على إضافة عملية ربط.



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



شلال


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

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



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

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


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

في ملف build.gradle.kts على مستوى التطبيق، أضِف عمليات التنفيذ التالية والإعدادات. استخدِم أحدث إصدارات من حزمة تطوير البرامج (SDK) والمحوّل الخاصَين بشبكة LINE Ads Network:

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

الدمج اليدوي

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

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

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

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

الخطوة 5: اختبار عملية التنفيذ

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

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

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

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

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

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

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

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

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

Java 

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

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

Kotlin 

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

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

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

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

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

الحقل مواد العرض التي يضمّنها محوّل LINE Ads Network دائمًا
العنوان
صورة
النص
رمز التطبيق 1
الحث على اتخاذ إجراء
التقييم بالنجوم
المتجر
السعر

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

رموز الخطأ

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

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

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

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

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

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

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

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