دمج "شبكة إعلانات LINE" مع التوسّط (إصدار تجريبي)

يوضّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات من Line وعرضها باستخدام توسّط AdMob، ويتناول الدمج في العرض الإعلاني بدون انقطاع. ويتناول هذا الدليل كيفية إضافة Line إلى إعدادات التوسّط لوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) وبرنامج التحويل لـ Line في تطبيق iOS.

تستخدم واجهة لوحة بيانات "شبكة إعلانات LINE" نصًا يابانيًا لتصنيفاتها وأزرارها وأوصافها. لم تتم ترجمة لقطات الشاشة الواردة في هذا الدليل. في أوصاف هذا الدليل وتعليماته، يتمّ ترجمة التصنيفات والأزرار مع إدراج نظائرها باللغة الإنجليزية بين قوسين.

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

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

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

2 إنّ ميزة دمج العرض الإعلاني بدون انقطاع متوفّرة في إصدار تجريبي مفتوح.

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

المتطلبات

  • إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر

  • [لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم محوِّل "شبكة إعلانات LINE" 2.8.20240827.0 أو إصدار أحدث (ننصح باستخدام أحدث إصدار)

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

  • إكمال التوسّط دليل البدء

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

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

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

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

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

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

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

اتّبِع الخطوات نفسها لإنشاء مواضع إعلانات لكلّ من عمليات دمج عروض الأسعار والعرض بدون انقطاع. ويمكن استخدام كل موضع إعلان لكلا النوعَين.

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

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

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

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

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

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

عليك إضافة "شبكة إعلانات LINE" إلى إعدادات التوسّط لوحدتك الإعلانية.

أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، وانتقِل إلى إضافة "شبكة إعلانات LINE" كمصدر إعلان.

لإنشاء مجموعة توسّط جديدة، اختَر إنشاء مجموعة توسّط.

أدخِل تنسيق الإعلان والمنصّة، ثم انقر على متابعة.

أدخِل اسمًا لمجموعة التوسّط، واختَر المواقع الجغرافية التي تريد استهدافها. بعد ذلك، اضبط حالة مجموعة التوسّط على مفعّلة، ثمّ انقر على إضافة وحدات إعلانية.

اربط مجموعة التوسّط هذه بوحدة إعلانية واحدة أو أكثر من وحدات AdMob الإعلانية الحالية. بعد ذلك، انقر على تم.

من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:

إضافة LINE Ads Network كمصدر إعلان

عروض الأسعار


ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، اختَر شبكة إعلانات LINE .
انقر على كيفية التوقيع على اتفاقية شراكة وإعداد شراكة مستندة إلى عروض الأسعار مع شبكة إعلانات LINE.
انقر على الإقرار والموافقة، ثم انقر على متابعة.
إذا كان لديك تعيين لشبكة إعلانات LINE، يمكنك اختياره. بخلاف ذلك، انقر على إضافة تعيين.
بعد ذلك، أدخِل رقم تعريف التطبيق ورقم تعريف الخانة التي حصلت عليها في القسم السابق. بعد ذلك، انقر على تم.

شلال


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

اختَر LINE Ads Network. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور لشبكة advertents



إذا كان لديك تعيين لشبكة إعلانات LINE، يمكنك اختياره. بخلاف ذلك، انقر على إضافة تعيين.

بعد ذلك، أدخِل رقم تعريف التطبيق ورقم تعريف الخانة اللذين حصلت عليهما في القسم السابق. بعد ذلك، انقر على تم.


الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوِّل شبكة إعلانات LINE

أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:

pod 'GoogleMobileAdsMediationLine'

من سطر الأوامر، شغِّل:

pod install --repo-update

الدمج اليدوي

  • نزِّل أحدث إصدار من حزمة SDK لشبكة إعلانات LINE واربط FiveAd.framework في مشروعك.
  • نزِّل أحدث إصدار من محوِّل "شبكة إعلانات LINE" من رابط التنزيل في سجلّ التغييرات والرابط LineAdapter.framework في مشروعك.

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

دمج SKAdNetwork

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

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

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

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

إثبات صحة الإعلانات الاختبارية

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

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

المَعلمات المتعلّقة بالشبكة

يتيح محوِّل "شبكة إعلانات LINE" مَعلمة طلب إضافية يمكن تمريرها إلى المحوِّل باستخدام فئة GADMediationAdapterLineExtras. تتضمّن هذه الفئة السمات التالية:

adAudio
تُحدِّد حالة بدء الصوت التلقائية لإعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافآت.

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

Swift

import LineAdapter
// ...

let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

Objective-C

#import <LineAdapter/LineAdapter.h>
// ...

GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

استخدام الإعلانات المدمجة مع المحتوى

عرض الإعلانات

يُعبئ محوِّل "شبكة إعلانات LINE" ما يلي أوصاف الحقول المتقدّمة للإعلانات المدمجة مع المحتوى لأجل GADNativeAd.

الحقل مواد العرض التي يتم تضمينها دائمًا من خلال محوِّل LINE Ads Network
العنوان
صورة
النص
رمز التطبيق 1
الحث على اتخاذ إجراء
التقييم النجمي
المتجر
السعر

1 بالنسبة إلى الإعلانات المدمجة مع المحتوى، لا توفّر حزمة تطوير البرامج (SDK) لشبكة إعلانات LINE مادة عرض رمز التطبيق. بدلاً من ذلك، يملؤه محوِّل "شبكة إعلانات LINE" بصورة شفافة.

رموز الخطأ

إذا تعذّر على المحوِّل تلقّي إعلان من "شبكة إعلانات LINE"، يمكنك التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام GADResponseInfo.adNetworkInfoArray ضمن الفئات التالية:

GADMediationAdapterLine

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

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

سجلّ التغييرات في "محوِّل التوسّط لنظام التشغيل iOS" في LINE

النسخة التالية

  • تمّت إزالة المنطق الذي يتحقق مما إذا تم تسجيل حزمة تطوير البرامج (SDK) لبرنامج FAD في عملية إعداد المحوِّل.
  • تم تعديل واجهة برمجة التطبيقات "show" للإعلانات البينية والإعلانات التي تضمّ مكافأة باستخدام واجهة برمجة التطبيقات الجديدة "showWithViewController:".
  • تمّت إزالة ميزة التحقّق من حالة الإعلانات المدمجة مع المحتوى قبل تنزيل مواد عرض الإعلانات المدمجة مع المحتوى، لأنّها متوقّفة نهائيًا ولا تتوفّر بديل لها.

الإصدار 2.9.20241106.1

  • تم تعديل المحوِّل لاستخدام أحدث واجهة برمجة تطبيقات لتحميل الإعلانات لإعلانات البانر المستندة إلى عروض الأسعار.
  • تم إصلاح مشكلة كانت تمنع إعادة توجيه أحداث الإعلانات بشكل صحيح للإعلانات البينية التي تقدّم عروض أسعار.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 11.12.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.9.20241106 من حزمة تطوير البرامج (SDK) من FiveAd

الإصدار 2.9.20241106.0

  • تم التحقّق من التوافق مع الإصدار 2.9.20241106 من حزمة SDK في FiveAd.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 11.12.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.9.20241106 من حزمة تطوير البرامج (SDK) من FiveAd

الإصدار 2.8.20240827.1

  • تم تعديل CFBundleShortVersionString ليصبح يتضمّن ثلاثة مكوّنات بدلاً من أربعة.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 11.10.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.8.20240827 من حزمة تطوير البرامج (SDK) في FiveAd

الإصدار 2.8.20240827.0

  • تم التحقّق من التوافق مع الإصدار 2.8.20240827 من حزمة تطوير البرامج (SDK) من FiveAd.
  • تمت إضافة ميزة عروض الأسعار لأشكال الإعلانات التالية: إعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات المدمجة مع المحتوى.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 11.8.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.8.20240827 من حزمة تطوير البرامج (SDK) في FiveAd

الإصدار 2.8.20240612.0

  • تمت إضافة عنصر تحكّم في الصوت للإعلانات المدمجة مع المحتوى من خلال GADVideoOptions.
  • تم التحقّق من التوافق مع الإصدار 2.8.20240612 من حزمة تطوير البرامج (SDK) من FiveAd.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 11.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.8.20240612 من حزمة تطوير البرامج (SDK) من FiveAd

الإصدار 2.7.20240411.0

  • تم التحقّق من التوافق مع الإصدار 2.7.20240411 من حزمة تطوير البرامج (SDK) من FiveAd.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 11.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.7.20240411 من حزمة تطوير البرامج (SDK) من FiveAd

الإصدار 2.7.20240318.0

  • تم التحقّق من التوافق مع الإصدار 2.7.20240318 من حزمة تطوير البرامج (SDK) من FiveAd.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 11.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.7.20240318 من حزمة تطوير البرامج (SDK) من FiveAd

الإصدار 2.7.20240214.1

  • يتطلب الآن الحد الأدنى لإصدار iOS 12.0.
  • تتطلب الآن الإصدار 11.0 أو إصدار أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • تم تضمين Info.plist في الأطر ضمن LineAdapter.xcframework.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 11.0.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.7.20240214 من حزمة تطوير البرامج (SDK) من FiveAd

الإصدار 2.7.20240214.0

  • تم التحقّق من التوافق مع الإصدار 2.7.20240214 من حزمة تطوير البرامج (SDK) من FiveAd.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 11.0.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.7.20240214 من حزمة تطوير البرامج (SDK) من FiveAd

الإصدار 2.7.20240126.0

  • تم التحقّق من التوافق مع الإصدار 2.7.20240126 من حزمة تطوير البرامج (SDK) من FiveAd.
  • تم تعديل عملية تنفيذ المحوِّل باستخدام بروتوكولات المفوّض الجديدة لحزمة تطوير البرامج (SDK) من FiveAd.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 10.14.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.7.20240126 من حزمة تطوير البرامج (SDK) من FiveAd

الإصدار 2.7.20231115.0

  • تم التحقّق من التوافق مع الإصدار 2.7.20231115 من حزمة تطوير البرامج (SDK) من FiveAd.
  • تم تضمين رأس GADMediationAdapterLineExtras في modulemap.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 10.14.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.7.20231115 من حزمة تطوير البرامج (SDK) من FiveAd

الإصدار 2.6.20230609.1

  • تمت إضافة GADMediationAdapterLineAudioState لإدارة الحالة الصوتية الأولية للإعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافآت عند عرضها لأول مرة.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 10.14.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.6.20230609 من حزمة تطوير البرامج (SDK) من FiveAd

الإصدار 2.6.20230609.0

  • الإصدار الأولي.
  • تمت إضافة ميزة العرض الإعلاني بدون انقطاع لأشكال إعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات المدمجة مع المحتوى.
  • تم التحقّق من التوافق مع الإصدار 2.6.20230609 من حزمة تطوير البرامج (SDK) من FiveAd.

تم إنشاؤها واختبارها باستخدام:

  • الإصدار 10.9.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.6.20230609 من حزمة تطوير البرامج (SDK) من FiveAd