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

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

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

يتضمّن محوّل توسّط AdMob لشبكة LINE Ads Network الميزات التالية:

التكامل
عروض الأسعار  1
شلال
التنسيقات
بانر
إعلان بيني
تم منح المكافأة

1 تتوفّر ميزة دمج عروض الأسعار في إصدار تجريبي مغلق، لذا يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫Unity 4 أو الإصدارات الأحدث
  • [لتقديم عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم إضافة التوسّط في "إعلانات Google على الأجهزة الجوّالة" لحزمة LINE Ads SDK‏ 1.5.0 أو إصدار أحدث (يُنصح باستخدام أحدث إصدار).
  • للنشر على Android
    • المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
  • للنشر على أجهزة iOS
    • الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث
  • مشروع Unity يعمل وتم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لمزيد من التفاصيل، يُرجى الاطّلاع على البدء.
  • أكمِل دليل البدء في التوسّط.

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

اشترِك وسجِّل الدخول إلى حسابك على LINE Ads Network.

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

انقر على 広告枠管理 (إدارة الخانات الإعلانية) > メディア (الوسائط). بعد ذلك، انقر على 新規作成 (إنشاء جديد).

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

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

إنشاء موضع إعلان

انقر على معرّف التطبيق الذي تريد إضافة موضع إعلان إليه. بعد ذلك، انقر على 詳細 (التفاصيل).

انقر على スロット 追加 (إضافة خانة).

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

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

تعديل ملف 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 الإعلانية

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت إضافة التوسّط في "شبكة إعلانات LINE" من "إعلانات Google للأجهزة الجوّالة" في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

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

OpenUPM

في أداة تعديل مشروع Unity، اختَر تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحِزم (Package Manager) لفتح إعدادات "إدارة حِزم Unity" (Unity Package Manager Settings).

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

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

تفاصيل OpenUPM

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

Unity Registries

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

التثبيت من OpenUPM

حزمة Unity

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

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

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

بعد ذلك، اختَر مواد العرض (Assets) > أداة إدارة التبعيات الخارجية (External Dependency Manager) > أداة حلّ المشاكل في Android (Android Resolver) > فرض الحلّ (Force Resolve). ستنفّذ مكتبة External Dependency Manager عملية تحديد العناصر التابعة من البداية، وستنسخ العناصر التابعة المحدّدة إلى الدليل 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 الإعلانية خطأ خاصًا بحزمة تطوير البرامج (SDK). يمكنك الاطّلاع على المستندات الخاصة بشبكة إعلانات LINE Ads Network لمزيد من التفاصيل.
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 الإعلانية خطأ خاصًا بحزمة تطوير البرامج (SDK). يمكنك الاطّلاع على المستندات الخاصة بشبكة إعلانات LINE Ads Network لمزيد من التفاصيل.
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

الإصدار 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