يوضّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات وعرضها من Line باستخدام التوسّط، والتي تغطي عمليات الدمج في العرض الإعلاني بدون انقطاع. ويتناول كيفية إضافة Line إلى إعدادات التوسط لوحدة إعلانية وكيفية دمج أداة Line SDK والمحوّل في تطبيق Unity.
أشكال الإعلانات وعمليات الدمج المتوافقة
يشمل Ad Manager محوِّل التوسّط في Outline الإمكانات التالية:
| الدمج | |
|---|---|
| عروض الأسعار | |
| شلال | 1 |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| تم منح المكافأة | |
1 تتوفّر عملية دمج العرض الإعلاني بدون انقطاع في إصدار تجريبي مغلق. يُرجى التواصل مع مدير حسابك لطلب الوصول.
الشروط
- Unity 4 أو إصدار أحدث
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Unity قيد التشغيل تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". راجِع البدء لمعرفة التفاصيل.
- أكمِل دليل البدء الخاص بالتوسّط.
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم السطر
سجِّل الدخول إلى حساب Line.
إضافة تطبيق جديد
انقر على 広告枠管 WebGL (إدارة الخانات الإعلانية) > 金デ디ア (Media). بعد ذلك، انقر على visible 作成 (إنشاء جديد).
املأ النموذج وانقر على 登録 (التسجيل).
دوِّن معرّف التطبيق.
إنشاء موضع إعلان
انقر على رقم تعريف التطبيق الذي تريد إضافة موضع إعلان له. بعد ذلك، اختَر 詳細 (Detail).
انقر على 郭ッمطابقة 追加 (إضافة شريحة).
بعد ملء النموذج، انقر على (登録) تسجيل.
دوِّن معرّف الشريحة.
الخطوة 2: إعداد طلب الإعلان في واجهة مستخدم Ad Manager
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة Line SDK ومحوّل
يجب تنزيل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة لخدمة Line
من رابط التنزيل في
سجلّ التغييرات واستخراج
GoogleMobileAdsLineMediation.unitypackage من الملف المضغوط.
في محرِّر مشروعات Unity، اختَر مواد العرض > استيراد حزمة > حِزمة مخصّصة وابحث عن ملف GoogleMobileAdsLineMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android > فرض الحل. ستنفِّذ مكتبة Unity Play Services محللاً تحليلاً للتبعية من البداية وتنسخ الملحقات المُعلَن عنها إلى
دليل Assets/Plugins/Android في تطبيق Unity.
الخطوة 4: إضافة الرمز المطلوب
Android
لست بحاجة إلى رمز إضافي لدمج الخط.
iOS
دمج SKAdNetwork
اتّبِع مستندات السطر
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل Ad Manager.
اتّبِع التعليمات الواردة في مستندات Line Android وiOS حول كيفية تفعيل الإعلانات الاختبارية على الإنترنت
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من Line، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام Line (Waterfall) مصادر الإعلانات.
رموز الخطأ
إذا تعذّر على المحوّل استلام إعلان من 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.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 على الأجهزة الجوّالة.