يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض إعلانات من الخط باستخدام التوسّط، مع تغطية عمليات دمج العرض الإعلاني بدون انقطاع. وهي تتناول كيفية إضافة سطر إلى عنوان وحدة إعلانية إعدادات التوسّط وكيفية دمج أداة Line SDK ومحوّل إلى تطبيق Unity.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمن محوِّل AdMob التوسّط في Line الإمكانات التالية:
| الدمج | |
|---|---|
| عروض الأسعار | |
| شلال | 1 |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| تم منح المكافأة | |
1 لا يزال دمج الشلال في إصدار تجريبي مفتوح.
المتطلبات
- Unity 4 أو إصدار أحدث
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Unity قيد التشغيل تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". عرض البدء لمعرفة التفاصيل.
- أكمِل دليل البدء الخاص بالتوسّط.
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم السطر
سجِّل الدخول إلى حساب Line.
إضافة تطبيق جديد
انقر على 広告枠管 WebGL (إدارة الخانات الإعلانية) > 金デ디ア (Media). بعد ذلك، انقر على visible 作成 (إنشاء جديد).
املأ النموذج وانقر على 登録 (التسجيل).
دوِّن معرّف التطبيق.
إنشاء موضع إعلان
انقر على رقم تعريف التطبيق الذي تريد إضافة موضع إعلان له. بعد ذلك، اختَر 詳細 (Detail).
انقر على 郭ッمطابقة 追加 (إضافة شريحة).
بعد ملء النموذج، انقر على (登録) تسجيل.
دوِّن معرّف الشريحة.
الخطوة 2: إعداد طلب الإعلان في واجهة مستخدم AdMob
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة Line SDK ومحوّل
تنزيل أحدث إصدار من مكوّن توسّط إعلانات Google على الأجهزة الجوّالة لـ Line
من رابط التنزيل في
سجلّ التغييرات واستخراجه
GoogleMobileAdsLineMediation.unitypackage من ملف ZIP.
في محرِّر مشروعات Unity، اختَر مواد العرض >. استيراد الحزمة >
الحزمة المخصّصة والعثور على GoogleMobileAdsLineMediation.unitypackage
الملف الذي قمت بتنزيله. تأكد من تحديد كل الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض >. محلل خدمات Play > محلل Android >
فرض الحل. ستنفّذ مكتبة محلل خدمات Unity Play Services
تحليل التبعية من البداية ونسخ التبعيات المعلنة إلى
الدليل 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. | عرضت حزمة Line SDK خطأً خاصًا بحزمة SDK. عرض مستندات Line لمزيد من التفاصيل. |
| 101 | com.google.ads.mediation.line | معلمات الخادم غير صالحة (على سبيل المثال، معرّف التطبيق أو معرّف الشريحة غير موجود). |
| 102 | com.google.ads.mediation.line | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع السطر. |
| 103 | com.google.ads.mediation.line | تعذّر تحميل مادة عرض صورة رمز المعلومات في الإعلان المدمج مع المحتوى. |
سجلّ تغييرات المكوِّن الإضافي لتوسّط Unity للخط
الإصدار 1.3.0
- يتوافق مع الإصدار 2.8.20240722.0 من محوّل Line Android.
- يتوافق مع الإصدار 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 من محوّل Line Android.
- يتوافق مع الإصدار 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 على الأجهزة الجوّالة.