يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض إعلانات من الخط باستخدام التوسّط، مع تغطية عمليات دمج العرض الإعلاني بدون انقطاع. ويتناول هذا الدليل كيفية إضافة Line إلى إعدادات التوسّط لوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ووحدة تحويل Line في تطبيق Unity.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمن محوِّل AdMob التوسّط في Line الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | 1 |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة |
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 على الأجهزة الجوّالة لـ 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 حول كيفية تفعيل الإعلانات الاختبارية على الإنترنت
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من 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 على الأجهزة الجوّالة.