يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads Unity Plugin لتحميل الإعلانات وعرضها من LINE Ads Network باستخدام التوسّط، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة LINE Ads Network إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل LINE Ads Network في تطبيق Unity.
عمليات الدمج وأشكال الإعلانات المتوافقة
يتضمّن برنامج التكييف الخاص بخدمة توسّط AdMob لشبكة LINE Ads Network الإمكانات التالية:
| التكامل | |
|---|---|
| عروض الأسعار | |
| عرض إعلاني بدون انقطاع | |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| تمت المكافأة | |
المتطلبات
- أحدث محتوى من قناة Google Mobile Ads Unity Plugin
- Unity 4 أو الإصدارات الأحدث
- [لتقديم عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم مكوّنًا إضافيًا للتوسّط في "إعلانات Google على الأجهزة الجوّالة" من أجل الإصدار 1.5.0 أو إصدار أحدث من LINE Ads SDK (يُنصح باستخدام أحدث إصدار).
- للنشر على Android
- مستوى واجهة برمجة التطبيقات 23 من Android أو مستوى أعلى
- للنشر على أجهزة iOS، اتّبِع الخطوات التالية:
- الإصدار 13.3 أو الإصدارات الأحدث من نظام التشغيل iOS
- يجب أن يكون لديك مشروع Unity يعمل وتم إعداده باستخدام Google Mobile Ads Unity Plugin. راجِع مقالة إعداد Google Mobile Ads Unity Plugin لمعرفة التفاصيل.
- إعداد ميزة "توسّط AdMob"
الخطوة 1: إعداد الإعدادات في واجهة مستخدم "شبكة إعلانات LINE"
اشترِك وسجِّل الدخول إلى حسابك على LINE Ads Network.
إضافة تطبيق جديد
انتقِل إلى علامة التبويب アプリ (التطبيق) وانقر على الزر 新規登録 (تسجيل جديد).
املأ النموذج وانقر على 登録 (تسجيل).
دوِّن アプリID (معرّف التطبيق).
Android
iOS
إنشاء مساحة إعلانية
في علامة التبويب アプリ (التطبيق)، اختَر تطبيقك للاطّلاع على تفاصيله. ضمن قسم スロット (الفتحة)، انقر على 追加 (إضافة).
املأ النموذج للحصول على تفاصيل حول موضع الإعلان. بالنسبة إلى نوع عروض الأسعار، اختَر عادي لضبط موضع الإعلان هذا على التوسّط بدون انقطاع، أو عروض الأسعار باستخدام حِزم تطوير البرامج (SDK) من Google لضبط موضع الإعلان هذا على عروض الأسعار. انقر على 作成 (إنشاء) بعد ملء النموذج.
دوِّن رقم تعريف الخانة (Slot ID).
تعديل ملف app-ads.txt
app-ads.txt للبائعين المعتمَدين للتطبيقات هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. ولمنع حدوث خسارة كبيرة في إيرادات الإعلانات، عليك تنفيذ ملف app-ads.txt.
إذا لم يسبق لك إجراء ذلك،
أعِدّ ملف app-ads.txt لتطبيقك.
لتنفيذ app-ads.txt لشبكة LINE Ads Network، اطّلِع على
لمحة عن app-ads.txt.
الخطوة 2: إعداد طلب LINE Ads Network في واجهة مستخدم AdMob
ضبط إعدادات التوسّط للوحدة الإعلانية
Android
للحصول على التعليمات، راجِع الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج والمحوّل الخاصَّين بشبكة LINE Ads Network
OpenUPM-CLI
إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت إضافة التوسّط في شبكة LINE الإعلانية لـ "إعلانات Google على الأجهزة الجوّالة" في Unity على مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:
openupm add com.google.ads.mobile.mediation.lineOpenUPM
في محرِّر مشروع Unity، انقر على تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحِزم (Package Manager) لفتح إعدادات إدارة حِزم Unity (Unity Package Manager Settings).
ضمن علامة التبويب المستودعات المسجّلة ذات النطاق المحدود، أضِف OpenUPM كمستودع مسجّل ذي نطاق محدود مع التفاصيل التالية:
- الاسم:
OpenUPM - عنوان URL:
https://package.openupm.com - النطاقات:
com.google
بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager (إدارة حِزم Unity)، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.
اختَر حزمة Google Mobile Ads Line Mediation وانقر على تثبيت.
Unity Package
نزِّل أحدث إصدار من المكوّن الإضافي للتوسّط في "إعلانات Google على الأجهزة الجوّالة" لشبكة LINE Ads Network من رابط التنزيل في سجلّ التغيير، واستخرِج GoogleMobileAdsLineMediation.unitypackage من ملف zip.
في أداة تعديل مشروع Unity، انقر على Assets > Import Package > Custom Package وابحث عن ملف GoogleMobileAdsLineMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.
بعد ذلك، اختَر مواد العرض (Assets) > أداة إدارة التبعيات الخارجية (External Dependency Manager) > أداة حلّ المشاكل في Android (Android Resolver) > فرض الحلّ (Force Resolve). ستنفّذ مكتبة "أداة إدارة التبعيات الخارجية" عملية حلّ التبعيات من البداية وستنسخ التبعيات المحدّدة إلى الدليل Assets/Plugins/Android في تطبيق Unity.
الخطوة 4: إضافة الرمز المطلوب
Android
لا يلزم توفير رمز إضافي لدمج "شبكة إعلانات LINE".
iOS
تكامل SKAdNetwork
اتّبِع مستندات LINE Ads Network
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 5: اختبار عملية الإعداد
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob.
تأكيد الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من LINE Ads Network، فعِّل اختبار مصدر إعلان فردي في أداة فحص الإعلانات باستخدام مصادر الإعلانات LINE Ads Network (العرض الإعلاني بدون انقطاع).
خطوات اختيارية
المَعلمات الخاصة بالشبكة
يتيح مكوّن LINE Ads Network الإضافي للتوسّط في 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 Ads Network،
يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام
ResponseInfo ضمن الفئات التالية:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل LINE Ads Network عندما يتعذّر تحميل إعلان:
Android
| رمز الخطأ | النطاق | السبب |
|---|---|---|
| 1-10 | com.five_corp.ad | عرضت حزمة تطوير البرامج (SDK) الخاصة بشبكة LINE الإعلانية خطأً خاصًا بالحزمة. راجِع المستندات الخاصة بشبكة LINE الإعلانية للحصول على مزيد من التفاصيل. |
| 101 | com.google.ads.mediation.line | رقم تعريف التطبيق غير متوفّر أو غير صالح. |
| 102 | com.google.ads.mediation.line | معرّف الخانة غير متوفّر أو غير صالح. |
| 103 | com.google.ads.mediation.line | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع شبكة LINE Ads Network. |
| 104 | com.google.ads.mediation.line | تعذّر تحميل إعلان بيني أو إعلان مقابل مكافأة بسبب عدم توفّر سياق النشاط. |
| 105 | com.google.ads.mediation.line | تعذّر على حزمة تطوير البرامج (SDK) لشبكة LINE Ads Network عرض إعلان بيني أو إعلان مقابل مكافأة. |
| 106 | com.google.ads.mediation.line | تعذّر تحميل إعلان مدمج مع المحتوى بسبب عدم توفّر مواد العرض. |
iOS
| رمز الخطأ | النطاق | السبب |
|---|---|---|
| 1-10 | يتم إرسالها من خلال حزمة تطوير البرامج (SDK) لشبكة LINE Ads Network | عرضت حزمة تطوير البرامج (SDK) الخاصة بشبكة LINE الإعلانية خطأً خاصًا بالحزمة. راجِع المستندات الخاصة بشبكة LINE الإعلانية للحصول على مزيد من التفاصيل. |
| 101 | com.google.ads.mediation.line | مَعلمات الخادم غير صالحة (مثل رقم تعريف التطبيق أو رقم تعريف الخانة غير متوفّر). |
| 102 | com.google.ads.mediation.line | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع شبكة LINE Ads Network. |
| 103 | com.google.ads.mediation.line | تعذّر تحميل مادة عرض صورة رمز المعلومات في الإعلان المدمج مع المحتوى. |
سجلّ التغييرات في Line Unity Mediation Plugin
الإصدار 2.1.0
- يتوافق مع الإصدار 3.1.0.0 من محوّل Line Android.
- يتوافق مع الإصدار 3.0.1.0 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 11.0.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 2.0.2
- يتوافق مع الإصدار 3.0.1.1 من محوّل Line Android.
- يتوافق مع الإصدار 3.0.1.0 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 11.0.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 2.0.1
- يتوافق مع الإصدار 3.0.1.1 من محوّل Line Android.
- يتوافق مع الإصدار 3.0.0.1 من محوّل Line لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 11.0.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 2.0.0
- يتوافق مع الإصدار 3.0.1.0 من محوّل Line Android.
- يتوافق مع الإصدار 3.0.0.0 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.7.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.
الإصدار 1.5.10
- يتوافق مع الإصدار 2.9.20251028.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20251119.0 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.6.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.5.9
- يتوافق مع الإصدار 2.9.20251028.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20250930.0 من محوّل Line لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.6.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.5.8
- يتوافق مع الإصدار 2.9.20250924.1 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20250930.0 من محوّل Line لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.5.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.5.7
- يتوافق مع الإصدار 2.9.20250924.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20250912.0 من محوّل Line لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.5.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.5.6
- يتوافق مع الإصدار 2.9.20250718.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20250512.0 من محوّل Line لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.3.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.
الإصدار 1.5.5
- تم حلّ مشكلة عدم استيراد الحِزم بشكلٍ صحيح عند التثبيت من خلال OpenUPM.
الإصدار 1.5.4
- يتوافق مع الإصدار 2.9.20250519.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20250512.0 من محوّل Line لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.1.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.5.3
- تم الآن إنشاء المكوّن الإضافي Unity باستخدام الإصدار 35 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
- يتوافق مع الإصدار 2.9.20250317.1 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20241106.3 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.1.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.5.2
- يتوافق مع الإصدار 2.9.20250110.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20241106.2 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.0.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.
الإصدار 1.5.1
- يتوافق مع الإصدار 2.9.20250110.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20241106.1 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.5.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.5.0
- يتوافق مع الإصدار 2.9.20241129.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20241106.1 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.5.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.4.0
- يتوافق مع الإصدار 2.8.20240827.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.9.20241106.1 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.4.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.
الإصدار 1.3.1
- يتوافق مع الإصدار 2.8.20240808.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.8.20240612.0 من محوّل Line لنظام التشغيل iOS.
- تم إنشاء هذا الإصدار واختباره باستخدام الإصدار 9.2.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.
الإصدار 1.3.0
- يتوافق مع الإصدار 2.8.20240722.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.8.20240612.0 من محوّل Line لنظام التشغيل iOS.
- تم إنشاء هذا الإصدار واختباره باستخدام الإصدار 9.2.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.
الإصدار 1.2.0
- يتوافق مع الإصدار 2.7.20240515.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.8.20240612.0 من محوّل Line لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.1 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.
الإصدار 1.1.2
- يتوافق مع الإصدار 2.7.20240515.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.7.20240411.0 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.1.1
- يتوافق مع الإصدار 2.7.20240214.1 من محوّل Line Android.
- يتوافق مع الإصدار 2.7.20240411.0 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.1.0
- تمت إضافة الفئة
LineMediationExtrasمع الطرق التالية لتوفير إمكانية تمرير إضافات التوسّط.SetEnabledAdSound(bool)
- يتوافق مع الإصدار 2.7.20240214.1 من محوّل Line Android.
- يتوافق مع الإصدار 2.7.20240318.0 من محوّل Line iOS.
- تم إنشاء هذا الإصدار واختباره باستخدام الإصدار 9.0.0 من إضافة Google Mobile Ads Unity Plugin.
الإصدار 1.0.0
- الإصدار الأوّلي
- يتوافق مع الإصدار 2.6.20230607.0 من محوّل Line Android.
- يتوافق مع الإصدار 2.6.20230609.0 من محوّل Line iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 8.5.1 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.