دمج LY Ads Network مع التوسّط

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads Unity Plugin لتحميل الإعلانات وعرضها من شبكة LY Ads Network باستخدام التوسّط، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة LY Ads Network إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل LY Ads Network في تطبيق Unity.

عمليات الدمج وأشكال الإعلانات المتوافقة

يتضمّن محوّل التوسّط في "مدير إعلانات Google" لشبكة LY Ads Network الإمكانات التالية:

التكامل
عروض الأسعار
عرض إعلاني بدون انقطاع
التنسيقات
بانر
إعلان بيني
تمت المكافأة

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

  • أحدث إصدار من Google Mobile Ads Unity Plugin
  • الإصدار 4 أو إصدار أحدث من Unity Editor
  • [لعرض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم مكوّن Google Mobile Ads الإضافي للتوسّط في LY Ads Network 1.5.0 أو إصدار أحدث (يُنصح باستخدام أحدث إصدار).
  • للنشر على أجهزة Android
    • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
  • للنشر على أجهزة iOS
    • هدف نشر iOS‏ 13.0 أو إصدار أحدث
  • مشروع Unity قيد العمل تم إعداده باستخدام Google Mobile Ads Unity Plugin لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Unity Plugin.
  • إعداد التوسّط

    • الخطوة 1: ضبط الإعدادات في واجهة مستخدم شبكة إعلانات LY

    اشترِك وسجِّل الدخول إلى حسابك على شبكة إعلانات LY.

    إضافة تطبيق جديد

    انتقِل إلى علامة التبويب التطبيق وانقر على الزر تسجيل جديد.

    تسجيل جديد

    املأ النموذج وانقر على تسجيل.

    نموذج تسجيل جديد

    دوِّن رقم تعريف التطبيق.

    Android

    تفاصيل التسجيل

    iOS

    تفاصيل التسجيل

    إنشاء خانة إعلانية

    في علامة التبويب التطبيق، اختَر تطبيقك للاطّلاع على تفاصيله. ضمن قسم الخانة، انقر على إضافة.

    إضافة خانة

    املأ النموذج للحصول على تفاصيل حول الخانة. بالنسبة إلى نوع عروض الأسعار، اختَر عادي لضبط هذه الخانة من أجل توسّط العرض الإعلاني بدون انقطاع، أو عروض أسعار باستخدام حِزم تطوير البرامج (SDK) من Google لضبط هذه الخانة من أجل عروض الأسعار. انقر على إنشاء بعد ملء النموذج.

    نموذج إضافة خانة

    دوِّن رقم تعريف الخانة الإعلانية.

    تفاصيل الفتحة

    بعد إنشاء الخانة الأولى، انقر على مراجعة في صفحة تفاصيل تطبيقك للحصول على موافقة من شبكة إعلانات LY. وقد تستغرق هذه العملية بعض الوقت. يُرجى التواصل مع ممثل شبكة إعلانات LY إذا كانت لديك أي أسئلة.

    طلب مراجعة

    إنشاء مفتاح واجهة برمجة تطبيقات إعداد التقارير

    انتقِل إلى علامة التبويب إدارة مفاتيح واجهة برمجة التطبيقات لإعداد التقارير وانقر على الزرّ إنشاء مفتاح واجهة برمجة التطبيقات.

    علامة التبويب "مفتاح Reporting API"

    املأ النموذج وانقر على حفظ.

    نموذج مفتاح واجهة برمجة التطبيقات لإعداد التقارير

    دوِّن معرّف مفتاح واجهة برمجة التطبيقات وسر مفتاح واجهة برمجة التطبيقات.

    نموذج مفتاح واجهة برمجة التطبيقات لإعداد التقارير

    تعديل ملف app-ads.txt

    مبادرة "البائعون المعتمَدون للتطبيقات" (app-ads.txt) هي مبادرة من "المختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقاتك إلا من خلال القنوات التي حدّدتها على أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم تكن قد فعلت ذلك، أنشئ ملف app-ads.txt في "إدارة إعلانات Google".

    لتنفيذ app-ads.txt لشبكة إعلانات LY، يُرجى الاطّلاع على المقالة لمحة عن ملف app-ads.txt.

    الخطوة 2: إعداد طلب LY Ads Network في واجهة مستخدم "إدارة الإعلانات"

    ضبط إعدادات التوسّط للوحدة الإعلانية

    Android

    للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

    iOS

    للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

    الخطوة 3: استيراد حزمة تطوير البرامج (SDK) والمحوّل الخاصَّين بشبكة LY Ads Network

    OpenUPM-CLI

    إذا كان لديك OpenUPM-CLI مثبّتًا، يمكنك تثبيت المكوّن الإضافي لتوسّط شبكة الإعلانات LY Ads من "إعلانات Google على الأجهزة الجوّالة" لمنصة Unity في مشروعك عن طريق تشغيل الأمر التالي من الدليل الجذري لمشروعك:

    openupm add com.google.ads.mobile.mediation.line

    OpenUPM

    في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > أداة إدارة الحِزم لفتح إعدادات أداة إدارة حِزم Unity.

    ضمن علامة التبويب المستودعات المسجّلة ذات النطاق المحدود، أضِف OpenUPM كمستودع مسجّل ذي نطاق محدود مع التفاصيل التالية:

    • الاسم: OpenUPM
    • عنوان URL: https://package.openupm.com
    • النطاقات: com.google

    تفاصيل‫ OpenUPM

    بعد ذلك، انتقِل إلى Window > Package Manager لفتح Unity Package Manager واختَر My Registries من القائمة المنسدلة.

    Unityمستودعات ‫

    اختَر حزمة Google Mobile Ads Line Mediation وانقر على تثبيت.

    التثبيت من‫ OpenUPM

    حزمة Unity

    نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" لشبكة LY Ads Network من رابط التنزيل في سجلّ التغييرات واستخرِج GoogleMobileAdsLineMediation.unitypackage من ملف ZIP.

    في أداة تعديل مشروع Unity، انقر على مواد العرض (Assets) > استيراد حزمة (Import Package) > حزمة مخصّصة (Custom Package) وابحث عن ملف GoogleMobileAdsLineMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

    الاستيراد من‫ Unity

    بعد ذلك، اختَر الأصول (Assets) > أداة إدارة التبعيات الخارجية (External Dependency Manager) > Android Resolver > فرض الحل (Force Resolve). ستعمل مكتبة External Dependency Manager على حلّ التبعيات من البداية ونسخ التبعيات المُعلَن عنها إلى دليل Assets/Plugins/Android في تطبيق Unity.

    فرض الحلّ

    الخطوة 4: إضافة الرمز المطلوب

    Android

    لا حاجة إلى استخدام رمز إضافي لدمج LY Ads Network.

    iOS

    دمج SKAdNetwork

    اتّبِع مستندات LY Ads Network لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

    الخطوة 5: اختبار عملية التنفيذ

    تفعيل الإعلانات الاختبارية

    تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات".

    تأكيد الإعلانات الاختبارية

    للتأكّد من تلقّي إعلانات اختبارية من شبكة إعلانات LY Ads Network، يُرجى تفعيل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر إعلانات LY Ads Network.

    خطوات اختيارية

    المَعلمات الخاصة بالشبكة

    يتيح المكوّن الإضافي لتوسّط Unity في شبكة إعلانات LY استخدام المَعلمة الإضافية التالية للطلب، والتي يمكن تمريرها إلى المحوّل من خلال فئة 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);

    رموز الخطأ

    إذا تعذّر على المحوّل تلقّي إعلان من LY Ads Network، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo ضمن الفئات التالية:

    Android

    com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

    iOS

    GADMediationAdapterLine

    في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل شبكة إعلانات LY عندما يتعذّر تحميل إعلان:

    Android

    رمز الخطأ النطاق السبب
    1-10 com.five_corp.ad عرضت حزمة تطوير البرامج (SDK) لشبكة إعلانات LY خطأً خاصًا بحزمة SDK. يمكنك الاطّلاع على المستندات الخاصة بشبكة إعلانات LY Ads Network لمزيد من التفاصيل.
    101 com.google.ads.mediation.line معرّف التطبيق مفقود أو غير صالح.
    102 com.google.ads.mediation.line معرّف الخانة غير متوفّر أو غير صالح.
    103 com.google.ads.mediation.line لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع شبكة إعلانات LY.
    104 com.google.ads.mediation.line تعذَّر تحميل "إعلان بيني" أو "إعلان مقابل مكافأة" بسبب عدم توفّر سياق النشاط.
    105 com.google.ads.mediation.line تعذّر على حزمة تطوير البرامج (SDK) لشبكة إعلانات LY عرض "إعلان بيني" أو "إعلان مقابل مكافأة".
    106 com.google.ads.mediation.line تعذّر تحميل إعلان مدمج مع المحتوى بسبب عدم توفّر مواد العرض.
    107 com.google.ads.mediation.line عرضت حزمة تطوير البرامج (SDK) لـ FiveAd أداة تحميل إعلانات فارغة.

    iOS

    رمز الخطأ النطاق السبب
    1-10 يتم إرسالها من خلال حزمة تطوير البرامج (SDK) لشبكة LY Ads Network عرضت حزمة SDK لشبكة إعلانات LY خطأً خاصًا بحزمة SDK. يمكنك الاطّلاع على مستندات LY Ads Network لمزيد من التفاصيل.
    101 com.google.ads.mediation.line مَعلمات الخادم غير صالحة (مثل رقم تعريف التطبيق أو رقم تعريف الخانة غير متوفّر).
    102 com.google.ads.mediation.line لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع "شبكة إعلانات LY".
    103 com.google.ads.mediation.line تعذّر تحميل مادة عرض صورة رمز المعلومات في "الإعلان المدمج مع المحتوى".
    104 com.google.ads.mediation.line تعذَّر جمع الإشارات لتقديم عروض الأسعار.
    105 com.google.ads.mediation.line تعذّر بدء تشغيل أداة تحميل الإعلانات في حزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات LINE".

    سجلّ التغييرات في المكوّن الإضافي لتوسّط Line Unity

    الإصدار 2.2.1

    الإصدار 2.2.0

    الإصدار 2.1.1

    الإصدار 2.1.0

    الإصدار 2.0.2

    الإصدار 2.0.1

    الإصدار 2.0.0

    الإصدار 1.5.10

    الإصدار 1.5.9

    الإصدار 1.5.8

    الإصدار 1.5.7

    الإصدار 1.5.6

    الإصدار 1.5.5

    • تم إصلاح مشكلة عدم استيراد المكوّن الإضافي للحِزم بشكلٍ صحيح عند التثبيت من خلال OpenUPM.

    الإصدار 1.5.4

    الإصدار 1.5.3

    الإصدار 1.5.2

    الإصدار 1.5.1

    الإصدار 1.5.0

    الإصدار 1.4.0

    الإصدار 1.3.1

    الإصدار 1.3.0

    الإصدار 1.2.0

    الإصدار 1.1.2

    الإصدار 1.1.1

    الإصدار 1.1.0

    الإصدار 1.0.0