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