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

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

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

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

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

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

• هدف نشر iOS‏ 13.0 أو إصدار أحدث

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

• أحدث إصدار من Google Mobile Ads SDK

• إعداد التوسّط

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تعديل ملف 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 في واجهة مستخدم "إدارة الإعلانات"

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

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

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

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

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

ضبط عروض أسعار شبكة إعلانات LY

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

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

استخدام Swift Package Manager

قبل المتابعة، يجب أن يكون لديك الحد الأدنى للإصدار المتوافق من المحوّل وهو 2.9.20251119.

لإضافة حزمة تابعة إلى مشروعك، اتّبِع الخطوات التالية:

1. في Xcode، انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة... (File > Add Package Dependencies...).

2. في الطلب الذي يظهر، ابحث عن عنوان URL للحزمة التالي:

   https://github.com/googleads/googleads-mobile-ios-mediation-line.git
   

3. في قاعدة التبعية، اختَر الفرع.

4. في حقل النص، أدخِل main.

استخدام CocoaPods

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

الدمج اليدوي

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

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

تنفيذ SKAdNetwork

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

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

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

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

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

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

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

GADMediationAdapterLine.testMode = YES;

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

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

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

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

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

adAudio

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

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

import LineAdapter
// ...

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

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

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

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

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

يملأ محوّل شبكة إعلانات LY الحقول التالية لـ GADNativeAd.

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

رموز الخطأ

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

GADMediationAdapterLine

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

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

الإصدار 3.1.1.0

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

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

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

الإصدار 3.1.0.0

• يتطلّب الآن الحد الأدنى من إصدار iOS 15.0.
• تم التحقّق من التوافق مع الإصدار 3.1.0 من حزمة تطوير البرامج (SDK) لمنصة FiveAd.

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

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

الإصدار 3.0.1.2

• عدِّل الحدّ الأدنى لإصدار iOS من أجل تخفيف متطلبات حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" والسماح بالإصدارات الثانوية.
• تم إصلاح مشكلة ظهور رمز "خيارات الإعلان" بحجم كبير جدًا في "الإعلانات المدمجة مع المحتوى".

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

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

الإصدار 3.0.1.1

• يعيد المحوّل الآن توجيه علامة ageRestrictedTreatment في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى واجهة برمجة التطبيقات COPPA في حزمة FiveAd SDK.

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

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

الإصدار 3.0.1.0

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

تم التصميم والاختبار باستخدام:

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

الإصدار 3.0.0.1

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

تم التصميم والاختبار باستخدام:

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

الإصدار 3.0.0.0

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

تم التصميم والاختبار باستخدام:

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

الإصدار 2.9.20251119.1

• تمت إضافة إمكانية إعادة توجيه مَعلمات tagForUnderAgeOfConsent في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى حزمة SDK لـ FiveAd.

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

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

الإصدار 2.9.20251119.0

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

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

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

الإصدار 2.9.20250930.0

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

تم التصميم والاختبار باستخدام:

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

الإصدار 2.9.20250912.0

• يُهيئ المحوِّل الآن حزمة تطوير البرامج (SDK) لمنصة FiveAd قبل كل طلب عرض إعلان.
• تم التحقّق من التوافق مع الإصدار 2.9.20250912 من حزمة تطوير البرامج (SDK) لمنصة FiveAd.

تم التصميم والاختبار باستخدام:

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

الإصدار 2.9.20250512.0

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

تم التصميم والاختبار باستخدام:

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

الإصدار 2.9.20241106.3

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

تم التصميم والاختبار باستخدام:

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

الإصدار 2.9.20241106.2

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

تم التصميم والاختبار باستخدام:

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

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

• يتطلّب الآن الإصدار 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 على الأجهزة الجوّالة"
• الإصدار 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