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

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

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

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

يتضمّن برنامج التكيّف الخاص بالتوسّط في LINE Ads Network الإمكانات التالية:

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

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

المتطلبات

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

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

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

  • أكمِل دليل البدء في التوسّط.

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

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

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

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

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

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

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

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

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

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

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

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

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

لتنفيذ app-ads.txt لشبكة LINE Ads Network، اطّلِع على لمحة عن app-ads.txt.

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

سجِّل الدخول إلى حسابك على "مدير إعلانات Google".

إضافة LINE Ads Network في "الشركات"

عروض الأسعار

هذه الخطوة غير مطلوبة لعمليات الدمج المتعلقة بعروض الأسعار.

شلال

انتقِل إلى المشرف > الشركات، ثم انقر على الزر شركة جديدة في علامة التبويب جميع الشركات. اختَر شبكة الإعلانات.

اختَر LINE Ads Network كـ شبكة إعلانية، وأدخِل اسمًا فريدًا وفعِّل التوسّط. فعِّل جمع البيانات التلقائي، وأدخِل اسم تسجيل الدخول وكلمة المرور اللذين حصلت عليهما في القسم السابق.

لست بحاجة إلى إدخال اسم مستخدم أو كلمة مرور. انقر على حفظ عند الانتهاء.

تفعيل ميزة "مشاركة الإشارات الآمنة"

عروض الأسعار

انتقِل إلى المشرف > الإعدادات العامة. انتقِل إلى علامة التبويب إعدادات حساب Ad Exchange وراجِع خيار مشاركة الإشارات الآمنة وفعِّله. انقر على حفظ.

شلال

هذه الخطوة غير مطلوبة لعمليات الدمج المتسلسلة.

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

عروض الأسعار

انتقِل إلى المستودع الإعلاني > الإشارات الآمنة. ضمن الإشارات الآمنة، ابحث عن LINE وفعِّل تفعيل تكامل التطبيق.

انقر على حفظ.

شلال

هذه الخطوة غير مطلوبة لعمليات الدمج المتسلسلة.

السماح بمشاركة الإشارات الآمنة في "عروض الأسعار باستخدام حِزم تطوير البرامج (SDK)"

عروض الأسعار

انتقِل إلى عرض الإعلانات > إعدادات قناة طلبات الإعلانات. في علامة التبويب الإعدادات التلقائية، فعِّل خيار السماح بمشاركة الإشارات الآمنة في عروض أسعار حزمة تطوير البرامج (SDK).

انقر على حفظ.

شلال

هذه الخطوة غير مطلوبة لعمليات الدمج المتسلسلة.

ضبط عروض الأسعار على LINE Ads Network

عروض الأسعار

انتقِل إلى التسليم > مقدّمو عروض الأسعار، ثمّ انقر على الانتقال إلى SDK Bidding.

انقر على مقدّم عروض جديد.

اختَر LINE Ads Network كمقدّم عروض.

انقر على متابعة لتفعيل SDK Bidding لمقدّم عرض السعر هذا.

انقر على تم.

شلال

هذه الخطوة غير مطلوبة لعمليات الدمج المتسلسلة.

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

عروض الأسعار

انتقِل إلى التسليم > مقدّمو عروض الأسعار، ثمّ انقر على الانتقال إلى SDK Bidding.

اختَر الشركة لشبكة LINE الإعلانية.

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

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

شلال

انتقِل إلى التسليم > مجموعة الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة شبكات إعلانية مدِرّة للأرباح جديدة. اختَر تطبيق الأجهزة الجوّالة.

انتقِل إلى أسفل الصفحة وانقر على إضافة شريك إعلاني مدِّر للأرباح.

اختَر الشركة التي أنشأتها لشبكة LINE الإعلانية في القسم السابق. اختَر التوسّط في حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وiOS كـ النظام الأساسي، ونشط كـ الحالة.

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

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

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

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

الدمج اليدوي

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

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

تكامل SKAdNetwork

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

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

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

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

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

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

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

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

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

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

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

Swift

import LineAdapter
// ...

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

Objective-C

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

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

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

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

يملأ محوّل LINE Ads Network الحقول التالية GADNativeAd.

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

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

رموز الخطأ

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

GADMediationAdapterLine

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

رمز الخطأ النطاق السبب
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 تعذّر تحميل مادة عرض صورة رمز المعلومات في الإعلان الأصلي.

سجلّ التغييرات في محوّل التوسّط على iOS في LINE

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

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

  • يحاول الآن تسجيل حزمة تطوير البرامج (SDK) الخاصة بمنصة FiveAd قبل كل طلب إعلان.

الإصدار 2.9.20250512.0

  • يتطلّب الآن الإصدار 13.0 من نظام التشغيل iOS كحدّ أدنى.
  • تم التأكّد من التوافق مع الإصدار 2.9.20250512 من حزمة تطوير البرامج (SDK) الخاصة بمنصة FiveAd.

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

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

الإصدار 2.9.20241106.3

  • تم إصلاح المشكلة المتمثّلة في عدم كون GADMediationAdapterLine.h عنوانًا عامًا.
  • تفعيل العلامتَين -fobjc-arc و-fstack-protector-all
  • تمت إزالة عملية التحقّق من حجم الإعلان البانر للعرض بعد التحميل الناجح.
    • ستواصل "إعلانات البانر المتسلسلة" التحقّق من أحجام "إعلانات البانر" عند تحميلها بنجاح.

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

  • الإصدار 12.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫FiveAd SDK الإصدار 2.9.20241106.

الإصدار 2.9.20241106.2

  • تمت إضافة السمة GADMediationAdapterLine.testMode لتحديد ما إذا كان يجب تهيئة حزمة تطوير البرامج (SDK) الخاصة بمنصة FiveAd في وضع الاختبار. يجب ضبط هذه العلامة قبل إعداد حزمة تطوير البرامج (SDK) لـ "إعلانات Google على الأجهزة الجوّالة".
  • تمت إزالة عملية التحقّق من حالة إعداد حزمة FiveAd SDK قبل إعدادها.
  • تمت إزالة عملية التحقّق من حالة الإعلان المدمج مع المحتوى المتوقّف نهائيًا قبل تنزيل مواد عرض الإعلان المدمج مع المحتوى.
  • يتطلّب الآن الإصدار 12.0.0 أو إصدارًا أحدث من SDK لإعلانات Google على الأجهزة الجوّالة.

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

  • الإصدار 12.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫FiveAd SDK الإصدار 2.9.20241106.

الإصدار 2.9.20241106.1

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

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

  • الإصدار 11.12.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫FiveAd SDK الإصدار 2.9.20241106.

الإصدار 2.9.20241106.0

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

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

  • الإصدار 11.12.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫FiveAd SDK الإصدار 2.9.20241106.

الإصدار 2.8.20240827.1

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

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

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

الإصدار 2.8.20240827.0

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

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

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

الإصدار 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 على الأجهزة الجوّالة"
  • ‫FiveAd SDK الإصدار 2.7.20240318

الإصدار 2.7.20240214.1

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

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

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

الإصدار 2.7.20240214.0

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

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

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

الإصدار 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 على الأجهزة الجوّالة"
  • ‫FiveAd SDK الإصدار 2.7.20231115

الإصدار 2.6.20230609.1

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

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

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

الإصدار 2.6.20230609.0

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

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

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