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

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

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

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

يتضمّن برنامج التكيّف الخاص بالتوسّط في 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 في "مدير إعلانات Google".

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

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

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

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

عروض الأسعار

هذه الخطوة غير مطلوبة لعمليات الدمج المتعلقة بعروض الأسعار.

شلال

انتقِل إلى المشرف > الشركات، ثم انقر على الزر شركة جديدة في علامة التبويب جميع الشركات. اختَر شبكة الإعلانات.

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

لست بحاجة إلى إدخال اسم مستخدم أو كلمة مرور. انقر على حفظ عند الانتهاء.

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

عروض الأسعار

انتقِل إلى المشرف > الإعدادات العامة. انتقِل إلى علامة التبويب إعدادات حساب Ad Exchange وراجِع خيار مشاركة الإشارات الآمنة وفعِّله. انقر على حفظ.

شلال

هذه الخطوة غير مطلوبة لعمليات الدمج المتسلسلة.

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

عروض الأسعار

انتقِل إلى المستودع الإعلاني > الإشارات الآمنة. ضمن الإشارات الآمنة، ابحث عن LINE وفعِّل تفعيل تكامل التطبيق.

انقر على حفظ.

شلال

هذه الخطوة غير مطلوبة لعمليات الدمج المتسلسلة.

السماح بمشاركة الإشارات الآمنة في "عروض الأسعار باستخدام حِزم تطوير البرامج (SDK)"

عروض الأسعار

انتقِل إلى عرض الإعلانات > إعدادات قناة طلبات الإعلانات. في علامة التبويب الإعدادات التلقائية، فعِّل خيار السماح بمشاركة الإشارات الآمنة في عروض أسعار حزمة تطوير البرامج (SDK).

انقر على حفظ.

شلال

هذه الخطوة غير مطلوبة لعمليات الدمج المتسلسلة.

ضبط عروض الأسعار على LINE Ads Network

عروض الأسعار

انتقِل إلى التسليم > مقدّمو عروض الأسعار، ثمّ انقر على الانتقال إلى SDK Bidding.

انقر على مقدّم عروض جديد.

اختَر LINE Ads Network كمقدّم عروض.

انقر على متابعة لتفعيل SDK Bidding لمقدّم عرض السعر هذا.

انقر على تم.

شلال

هذه الخطوة غير مطلوبة لعمليات الدمج المتسلسلة.

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

عروض الأسعار

انتقِل إلى التسليم > مقدّمو عروض الأسعار، ثمّ انقر على الانتقال إلى SDK Bidding.

اختَر الشركة لشبكة LINE الإعلانية.

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

اختَر وحدة إعلانية محدّدة. اختَر وحدة إعلانية وتنسيقًا، ثم تطبيق الأجهزة الجوّالة كـ نوع المستودع وتطبيق الأجهزة الجوّالة. بعد ذلك، أدخِل معرّف التطبيق ومعرّف الخانة الذي حصلت عليهما في القسم السابق. وأخيرًا، انقر على حفظ.

شلال

انتقِل إلى التسليم > مجموعة الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة شبكات إعلانية مدِرّة للأرباح جديدة. اختَر تطبيق الأجهزة الجوّالة.

انتقِل إلى أسفل الصفحة وانقر على إضافة شريك إعلاني مدِّر للأرباح.

اختَر الشركة التي أنشأتها لشبكة LINE الإعلانية في القسم السابق. اختَر التوسّط في حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وAndroid كـ النظام الأساسي، ونشط كـ الحالة.

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

ملاحظة: يستغرق جمع البيانات تلقائيًا بضعة أيام قبل أن يتمكّن من حساب قيمة "التكلفة الديناميكية لكل ألف ظهور" بدقة لشبكة توسط. وبعد أن يصبح بإمكاننا احتساب التكلفة الفعلية لكل ألف ظهور، يتم تعديلها تلقائيًا نيابةً عنك.

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

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

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

الدمج اليدوي

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Java 

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

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

Kotlin 

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

val request = AdManagerAdRequest.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 الإعلانية خطأ خاصًا بالحزمة. يمكنك الاطّلاع على مستندات شبكة إعلانات 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.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