دمج LY Ads Network مع "توسّط AdMob"

اختيار النظام الأساسي: Android iOS Unity Flutter React Native Android (قديم)

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

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

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

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

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

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

• أحدث إصدار من Google Mobile Ads SDK for React Native
• الإصدار 0.85.0 أو إصدار أحدث من إطار عمل React Native
• للنشر على أجهزة Android
  • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
• للنشر على أجهزة iOS
  • أن يكون هدف نشر iOS هو الإصدار 13.0 أو إصدار أحدث
• مشروع React Native يعمل بشكل صحيح وتم ضبطه باستخدام Google Mobile Ads SDK for React Native يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads SDK for React Native لمزيد من التفاصيل.
  • تأكَّد من تنزيل مجلد adapters واستخراجه من مجلد gma-sdk-react-native. إذا لم يكن لديك مجلد adapters، اتّبِع الخطوات الأولى والثانية والثالثة في تثبيت Google Mobile Ads SDK for React Native.
• إعداد ميزة "توسّط AdMob"

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

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

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

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

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

ملاحظة: عليك إنشاء تطبيق منفصل لكل نظام أساسي تريد إتاحته.

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

Android

iOS

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

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

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

ملاحظة: لا يمكن تغيير شكل الإعلان ونوع عرض السعر بعد تسجيل الخانة. يُرجى التواصل مع مدير حسابك على LY Ads Network للحصول على إذن بإنشاء مواضع "إعلانات مدمجة مع المحتوى" في واجهة مستخدم LY Ads Network.

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

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

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

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

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

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

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

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

لتنفيذ app-ads.txt في LY Ads Network، يُرجى الاطّلاع على المقالة لمحة عن ملف app-ads.txt.

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

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

Android

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

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

ملاحظة: قد يؤدي عدم دمج الإصدارات المتوافقة من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" وشبكة LY Ads Network إلى حدوث مشاكل في عملية الإنشاء.

في الدليل الجذري لمشروعك، ثبِّت محوِّل التوسّط Google Mobile Ads SDK for React Native الخاص بشبكة إعلانات LY. يُرجى إكمال الخطوات التالية:

1. انسخ ملف tar الخاص بمحوّل Google Mobile Ads SDK for React Native من دليل gma-sdk-react-native/adapters/line/ إلى دليل local_packages/ في مشروعك. إذا لم يكن لديك المجلد adapters، يُرجى الاطّلاع على المتطلبات الأساسية.

   mkdir -p local_packages
   cp EXTRACT_DIR/gma-sdk-react-native/adapters/line/gma-mediation-line-0.1.0.tgz local_packages/
   

   استبدِل EXTRACT_DIR بالمسار إلى الدليل الذي استخرجت الأرشيف فيه.

2. ثبِّت حزمة المحوّل باستخدام أداة إدارة الحِزم المفضّلة لديك:

   npm

   npm install ./local_packages/gma-mediation-line-0.1.0.tgz
   

   خيط غزل

   yarn add ./local_packages/gma-mediation-line-0.1.0.tgz
   

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

Android

لا حاجة إلى استخدام رمز إضافي لدمج LY Ads Network.

iOS

تكامل SKAdNetwork

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

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

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

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

ملاحظة مهمة: عليك إيقاف وضع الاختبار في AdMob وشبكة إعلانات LY قبل إصدار تطبيقك.

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

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

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

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

يتيح المكوّن الإضافي لتوسّط React Native في شبكة إعلانات LY مَعلمة الطلب الإضافية التالية التي يمكن تمريرها إلى المحوّل من خلال فئة LineMediationExtras:

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

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

import { LineMediationExtras } from '@google/gma-mediation-line';

const request = {
  // ...
  mediationExtras: [
    new LineMediationExtras({
      enableAdSound: true,
    }),
  ],
};

رموز الخطأ

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

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

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

Android

رمز الخطأ	النطاق	السبب
1-10	com.five_corp.ad	عرضت حزمة تطوير البرامج (SDK) لشبكة إعلانات LY خطأً خاصًا بحزمة تطوير البرامج (SDK). يمكنك الاطّلاع على مستندات LY Ads Network لمزيد من التفاصيل.
101	com.google.ads.mediation.line	رقم تعريف التطبيق غير متوفّر أو غير صالح.
102	com.google.ads.mediation.line	معرّف الخانة غير متوفّر أو غير صالح.
103	com.google.ads.mediation.line	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع شبكة LY Ads Network.
104	com.google.ads.mediation.line	تعذَّر تحميل "إعلان بيني" أو "إعلان مقابل مكافأة" بسبب عدم توفّر سياق النشاط.
105	com.google.ads.mediation.line	تعذّر على حزمة تطوير البرامج (SDK) لشبكة إعلانات LY عرض "إعلان بيني" أو "إعلان مقابل مكافأة".
106	com.google.ads.mediation.line	تعذَّر تحميل إعلان مدمج مع المحتوى بسبب عدم توفّر مواد عرض.
107	com.google.ads.mediation.line	عرضت حزمة تطوير البرامج (SDK) لـ FiveAd أداة تحميل إعلانات فارغة.

iOS

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

الإصدار 0.1.0

• الإصدار الأوّلي

• يتوافق مع الإصدار 3.1.1.2 من محوّل LINE لنظام التشغيل Android.
• يتوافق مع الإصدار 3.1.1.0 من محوّل LINE لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 0.1.0 من المكوّن الإضافي React Native لـ "إعلانات Google على الأجهزة الجوّالة".