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

اختيار النظام الأساسي: Android Android iOS Unity Flutter

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

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

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

المتطلبات

• الإصدار 13.3 أو الإصدارات الأحدث من نظام التشغيل iOS

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

• أحدث محتوى من قناة Google Mobile Ads SDK

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

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

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

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

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

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

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

إنشاء مساحة إعلانية

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

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

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

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

إنشاء مفتاح Reporting API

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

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

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

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

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

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

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

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

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

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

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

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

ضبط عروض الأسعار في LY Ads Network

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

الخطوة 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 Ads Network لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

الخطوة 5: اختبار عملية الإعداد

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

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

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

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

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

GADMediationAdapterLine.testMode = YES;

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

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

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

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

يتوافق محوّل شبكة LY Ads مع مَعلمة طلب إضافية يمكن تمريرها إلى المحوّل باستخدام الفئة 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 Ads Network الحقول التالية GADNativeAd.

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

رموز الخطأ

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

GADMediationAdapterLine

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

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

الإصدار 3.0.1.2

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

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

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

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

الإصدار 3.0.0.1

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

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

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

الإصدار 3.0.0.0

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

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

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

الإصدار 2.9.20251119.1

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

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

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

الإصدار 2.9.20251119.0

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

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

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

الإصدار 2.9.20250930.0

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

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

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

الإصدار 2.9.20250912.0

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

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

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

الإصدار 2.9.20250512.0

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

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

• الإصدار 12.4.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 على الأجهزة الجوّالة.
• تمت إزالة عملية التحقّق من حالة إعداد حزمة تطوير البرامج (SDK) الخاصة بمنصة FiveAd قبل إعدادها.
• تمت إزالة عملية التحقّق من حالة الإعلان المدمج مع المحتوى المتوقّف نهائيًا قبل تنزيل مواد عرض الإعلان المدمج مع المحتوى.
• يتطلّب الآن الإصدار 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 على الأجهزة الجوّالة"
• الإصدار 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.
• تم تعديل عملية تنفيذ المحوّل باستخدام بروتوكولات التفويض الجديدة في حزمة FiveAd SDK.

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

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