الدمج مع ميزة التوسّط (إصدار تجريبي)

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

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

يتضمن محوِّل AdMob التوسّط في Line الإمكانات التالية:

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

¹ إنّ ميزة دمج العرض الإعلاني بدون انقطاع متوفّرة في إصدار تجريبي مفتوح.

المتطلبات

• Unity 4 أو إصدار أحدث
• أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
• للنشر على Android
  • المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
• للنشر على iOS
  • إصدار 12.0 من نظام التشغيل iOS أو إصدار أحدث مستهدف للنشر
• مشروع Unity قيد التشغيل تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". عرض البدء لمعرفة التفاصيل.
• إكمال دليل البدء للتوسّط

الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم السطر

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

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

Android

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

iOS

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

الخطوة 3: استيراد حِزم تطوير البرامج (SDK) ومحوِّل Line

ملاحظة: تعذّر دمج الخط المتوافق وإعلانات Google للأجهزة الجوّالة قد تؤدّي إصدارات حزمة تطوير البرامج (SDK) إلى حدوث مشاكل في الإصدار.

تنزيل أحدث إصدار من مكوّن توسّط إعلانات Google على الأجهزة الجوّالة لـ Line من رابط التنزيل في سجلّ التغييرات واستخراجه GoogleMobileAdsLineMediation.unitypackage من ملف ZIP.

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

بعد ذلك، اختَر مواد العرض >. محلل خدمات Play > محلل Android > فرض الحل. ستنفِّذ مكتبة Unity Play Services Resolver مكتبة حلّ التبعيات من البداية وستنسخ التبعيات المعلَن عنها إلى ملف directory Assets/Plugins/Android في تطبيق Unity.

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

Android

لست بحاجة إلى رمز إضافي لدمج الخط.

iOS

دمج SKAdNetwork

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

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

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

احرص على تسجيل جهاز الاختبار من أجل AdMob.

اتّبِع التعليمات الواردة في مستندات Line Android وiOS حول كيفية تفعيل الإعلانات الاختبارية على الإنترنت

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

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

للتأكّد من أنّك تتلقّى إعلانات اختبارية من Line، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام Line (Waterfall) مصادر الإعلانات.

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

المَعلمات المتعلّقة بالشبكة

يتيح المكوّن الإضافي لتوسّط Line 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، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo ضمن الفئات التالية:

Android

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

iOS

GADMediationAdapterLine

إليك الرموز والرسائل المرفقة التي يطرحها محوّل السطر عند فشل تحميل الإعلان:

Android

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

iOS

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

سجلّ تغييرات المكوِّن الإضافي لتوسّط Unity للخط

الإصدار 1.3.1

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

الإصدار 1.3.0

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

الإصدار 1.2.0

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

الإصدار 1.1.2

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

الإصدار 1.1.1

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

الإصدار 1.1.0

• تمت إضافة الفئة LineMediationExtras بالطرق التالية لإتاحة اجتياز إضافات التوسّط.
  • SetEnabledAdSound(bool)
• يتوافق مع الإصدار 2.7.20240214.1 من محوِّل Android لتطبيق Line.
• يتوافق مع الإصدار 2.7.20240318.0 من محوّل Line iOS.
• تم إنشاء هذا المكوِّن واختباره باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.0.0

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