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

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

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

يتضمّن برنامج التكييف الخاص بخدمة "توسّط AdMob" لشبكة LINE Ads Network الميزات التالية:

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

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

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 3.7.0 من Flutter أو إصدار أحدث
  • للنشر على Android
    • المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
  • للنشر على أجهزة iOS
    • الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث
  • مشروع Flutter يعمل وتم إعداده باستخدام حزمة "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 Ads Network

الدمج من خلال pub.dev

أضِف مصدر الاعتمادية التالي مع أحدث إصدارات حزمة تطوير البرامج (SDK) والمحوّل الخاصين بشبكة LINE Ads Network في ملف pubspec.yaml الخاص بالحزمة:

dependencies:
  gma_mediation_line: ^

الدمج اليدوي

نزِّل أحدث إصدار من مكوّن التوسّط الإضافي في "إعلانات Google على الأجهزة الجوّالة" لشبكة LINE Ads Network، واستخرِج الملف الذي تم تنزيله، وأضِف مجلد المكوّن الإضافي الذي تم استخراجه (ومحتوياته) إلى مشروع Flutter. بعد ذلك، أشِر إلى المكوّن الإضافي في ملف pubspec.yaml من خلال إضافة التبعية التالية:

dependencies:
  gma_mediation_line:
    path: path/to/local/package

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

Android

لا يلزم توفير رمز إضافي لدمج "شبكة إعلانات LINE".

iOS

تكامل SKAdNetwork

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

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

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

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

التحقّق من الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من LINE Ads Network، فعِّل اختبار مصدر إعلان فردي في "فاحص الإعلان" باستخدام مصادر الإعلانات LINE Ads Network (العرض الإعلاني بدون انقطاع).

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

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

يتيح البرنامج المساعد للتوسّط في LINE Ads Network Flutter معلَمة الطلب الإضافية التالية التي يمكن تمريرها إلى المحوّل من خلال الفئة LineMediationExtras:

  • ‫enableAdSound : تحدّد هذه السمة حالة بدء الصوت التلقائية في إعلانات البانر والإعلانات البينية والإعلانات مقابل المكافأة.

في ما يلي مثال على الرمز البرمجي لكيفية إنشاء طلب إعلان يضبط هذه المَعلمات:

LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [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 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 الإعلانية خطأ خاصًا بالحزمة. يمكنك الاطّلاع على مستندات شبكة إعلانات 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 على Flutter

الإصدار 1.0.4 (قيد التطوير)

الإصدار 1.0.3

الإصدار 1.0.2

الإصدار 1.0.1

الإصدار 1.0.0