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

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

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

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

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

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

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

المتطلبات

• أحدث إصدار من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity
• ‫Unity 4 أو الإصدارات الأحدث
• [لتقديم عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم إضافة التوسّط في "إعلانات Google على الأجهزة الجوّالة" لحزمة LINE Ads SDK‏ 1.5.0 أو إصدار أحدث (يُنصح باستخدام أحدث إصدار).
• للنشر على Android
  • المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
• للنشر على أجهزة iOS
  • الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث
• مشروع Unity يعمل وتم إعداده باستخدام إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity لمزيد من التفاصيل، يُرجى الاطّلاع على البدء.
• أكمِل دليل البدء الخاص بالتوسّط.

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

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

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

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

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

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

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

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

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

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

ملاحظة: لا يمكن تغيير フォーマット (التنسيق) ونوع عروض الأسعار بعد تسجيل موضع الإعلان. يُرجى التواصل مع مدير حسابك على LINE Ads Network للحصول على إذن بالوصول إلى واجهة مستخدم LINE Ads Network من أجل إنشاء مواضع إعلانات مدمجة.

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

تعديل ملف 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

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

Android

للحصول على التعليمات، راجِع الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

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

ملاحظة: قد يؤدي عدم دمج الإصدارات المتوافقة من LINE Ads Network و"حزمة تطوير البرامج لإعلانات Google على الأجهزة الجوّالة" إلى حدوث مشاكل في الإصدار.

OpenUPM-CLI

ملاحظة مهمة: إذا كنت تريد الانتقال من استخدام .unitypackage إلى استخدام OpenUPM-CLI، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم عن طريق حذف جميع الملفات من المجلد Assets/GoogleMobileAds/Mediation/Line.

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت إضافة التوسّط في "شبكة LINE الإعلانية" الخاصة بـ "إعلانات Google على الأجهزة الجوّالة" في Unity على مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

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

OpenUPM

ملاحظة مهمة: إذا كنت تريد الانتقال من استخدام .unitypackage إلى استخدام OpenUPM، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم عن طريق حذف جميع الملفات من المجلد Assets/GoogleMobileAds/Mediation/Line.

في أداة تعديل مشروع Unity، اختَر تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحزم (Package Manager) لفتح إعدادات "إدارة حزم Unity" (Unity Package Manager Settings).

ضمن علامة التبويب المستودعات ذات النطاق المحدود، أضِف OpenUPM كمستودع ذي نطاق محدود مع التفاصيل التالية:

• الاسم: OpenUPM
• عنوان URL: https://package.openupm.com
• النطاقات: com.google

بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager (أداة إدارة حِزم Unity)، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.

اختَر حزمة Google Mobile Ads Line Mediation وانقر على تثبيت.

حزمة Unity

نزِّل أحدث إصدار من مكوّن التوسّط الإضافي في "إعلانات Google على الأجهزة الجوّالة" لشبكة LINE Ads Network من رابط التنزيل في سجلّ التغيير واستخرِج GoogleMobileAdsLineMediation.unitypackage من ملف zip.

في أداة تعديل مشروع Unity، اختَر Assets > Import Package > Custom Package، وابحث عن ملف GoogleMobileAdsLineMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

بعد ذلك، اختَر مواد العرض (Assets) > أداة إدارة التبعيات الخارجية (External Dependency Manager) > Android Resolver > فرض الحل (Force Resolve). ستنفّذ مكتبة External Dependency Manager عملية تحديد العناصر التابعة من البداية وستنسخ العناصر التابعة المحدّدة إلى الدليل Assets/Plugins/Android في تطبيق Unity.

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

Android

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

iOS

تكامل SKAdNetwork

اتّبِع مستندات LINE Ads Network لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

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

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

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

ملاحظة مهمة: عليك إيقاف وضع الاختبار في AdMob وLINE Ads Network قبل إصدار تطبيقك.

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

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

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

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

يتيح مكوّن التوسّط الإضافي LINE 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);

رموز الخطأ

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

Android

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

iOS

GADMediationAdapterLine

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

Android

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

iOS

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

سجلّ التغييرات في Line Unity Mediation 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 Mobile Ads Unity Plugin.

الإصدار 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 على الأجهزة الجوّالة" في Unity.

الإصدار 1.0.0

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