تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

دمج nend مع التوسط

يوضِّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل إعلانات من nend وعرضها باستخدام التوسّط، وتغطي عمليات دمج العرض الإعلاني بدون انقطاع. كما يتناول كيفية إضافة ميزة nend إلى إعدادات التوسّط في وحدة إعلانية، وكيفية دمج أداة nend SDK والمحوّل في أحد تطبيقاتAndroid .

تستخدم واجهة لوحة المعلومات الخاصة بخدمة nend النص الياباني للتسميات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة المعروضة أدناه. في هذا الدليل، يُشار إلى التسميات والأزرار باللغة الإنجليزية المماثلة لها. على سبيل المثال، "عنوان URL ーム" الذي يشير إلى "مخطط عنوان URL"، وما إلى ذلك.

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

يتمتع Ad Manager محوّل التوسط لخدمة nend بالإمكانات التالية:

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

المتطلّبات

المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android

أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
إكمال عملية التوسّط دليل البدء

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

اشترِك أو سجِّل الدخول إلى حسابك على Nend.

لإضافة تطبيقك إلى لوحة بيانات Nend، انقر أولاً على علامة التبويب إدارة مواضع الإعلان، ثم اختَر الموقع الإلكتروني/التطبيق. انقر على الزر إضافة تطبيق لإضافة تطبيقك إلى Nend.

إنشاء تطبيق

أدخِل اسم تطبيقك واختَر نوع التطبيق الأساسي لتطبيقك. أدخِل عنوان URL وتحقّق مما إذا كان تطبيقك مُدرجًا في متجر التطبيقات المناسب.

(راجع الأسئلة الشائعة حول التطبيقات التي لم يتم إطلاقها بعد في nend إذا لم يتم طرح تطبيقك بعد). اختَر فئة لتطبيقك وانقر على إنشاء عند الانتهاء.

سيظهر تطبيقك في لوحة البيانات بعد إنشائه.

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

وبعد تسجيل التطبيق، يمكنك الانتقال إلى خطوات إنشاء موضع الإعلان. لإنشاء موضع لإعلانات البانر، انتقِل إلى علامة التبويب إدارة موضع الإعلان وانقر على موضع الإعلان. بعد ذلك، انقر على الزر إنشاء موضع إعلان جديد.

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

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

إعلان بيني

اختَر صورة ثابتة لنوع الإعلان، وإعلان بيني لنوع المستودع. بعد إجراء ذلك، أدخِل اسم موضع الإعلان، واملأ مقدّمة عن المستودع، واختَر معدل عرض الإعلان من القائمة المنسدلة. وعند الانتهاء، انقر على الزر إنشاء لإنشاء موضع الإعلان.

بالنسبة إلى إعلانات الفيديو البينية، اختَر فيديو لنوع الإعلان وإعلان بيني لنوع المستودع. بعد الانتهاء من ذلك، أدخل اسم موضع الإعلان، واملأ مقدمة عن المستودع، واختر فئة مناسبة من القائمة المنسدلة. وعند الانتهاء، انقر على الزر إنشاء لإنشاء موضع الإعلان.

تم منح المكافأة

اختَر فيديو لنوع الإعلان والمكافأة لنوع المستودع. بعد الانتهاء من ذلك، أدخل اسم موضع الإعلان، واملأ مقدمة عن المستودع، واختر فئة مناسبة من القائمة المنسدلة.

ضمن إعدادات المكافأة، اختَر محتوى المكافأة باستخدام القائمة المنسدلة، وأدخِل اسم العملة الافتراضية المفضَّل لديك. وعند الانتهاء، انقر على الزر إنشاء لإنشاء موضع الإعلان.

مدمجة مع المحتوى

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

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

ضمن إعدادات الإعلانات المدمجة مع المحتوى، اختر اتجاه إعلان الفيديو ونوع الإعلان المدمج مع المحتوى من القائمة. وعند الانتهاء، انقر على الزر إنشاء لإنشاء موضع الإعلان.

لإعداد Ad Manager وحدتك الإعلانية في القسم التالي، ستحتاج إلى apiKey وspotID لكل موضع إعلان. لتحديد موقعها، توجه إلى علامة التبويب إدارة المواضع وحدد زر حزمة تطوير البرامج (SDK) تحت اسم تطبيقك.

دوِّن apiKey وspotID.

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

الخطوة 2: إعداد طلب الإعلان في Ad Manager واجهة المستخدم

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

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

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

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

بعد ذلك، انقر على الزر إضافة شريك أرباح.

إذا كان لديك شريك أرباح في nend، يمكنك اختياره. إذا لم يكن لديك حساب، اختَر إنشاء شريك جديد لتحقيق الأرباح.

اختَر nend باعتبارها شبكة الإعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط.

فعِّل الجمع التلقائي للبيانات، وأدخِل Reporting API Key from the API Key for Scraping الذي تم الحصول عليه في القسم السابق.

بعد اختيار الشريك المحقِّق للأرباح، اختر توسّط حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وAndroid باعتبارها النظام الأساسي، ونشط كالحالة. أدخِل Slot ID and API Key الذي تم الحصول عليه في القسم السابق. ثم أدخِل قيمة التكلفة التلقائية لكل ألف ظهور.

انقر على حفظ في أسفل الصفحة عند الانتهاء.

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) الخاصة بخدمة nend

دمج "استوديو Android" (يُنصح به)

في ملف settings.gradle.kts على مستوى المشروع، أضِف المستودعات التالية:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://fan-adn.github.io/nendSDK-Android-lib/library")
    }
  }
}

بعد ذلك، في ملف build.gradle.kts على مستوى التطبيق، أضِف تبعيات التنفيذ وإعداداته التالية. استخدم أحدث إصدارات من حزمة Nend SDK ومحوّل:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:nend:10.0.0.0")
}

الدمج اليدوي

نزِّل أحدث إصدار من Nend Android SDK وأضِفه إلى مشروعك.
انتقِل إلى عناصر محوّل Nend في مستودع Maven من Google. حدد أحدث إصدار، ونزِّل ملف .aar لمعدِّل nend، وأضفه إلى مشروعك.

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

ليس من المطلوب استخدام رمز إضافي للتكامل مع nend.

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

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

احرص على تسجيل جهاز الاختبار من أجل Ad Manager. للحصول على إعلانات اختبارية لإعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة، ينصح تطبيق nend باستخدام مفاتيح واجهة برمجة التطبيقات وأرقام تعريف المواضع الإعلانية المقدَّمة في صفحة الوحدات الإعلانية الاختبارية . يمكن إدخال هذه المفاتيح على أنّها مفاتيح واجهة برمجة التطبيقات ومعرّفات Spot ID لوحداتك الإعلانية في AdMob أثناء الاختبار، ثم استبدالها بمفتاح واجهة برمجة تطبيقات فعلي ورقم تعريف Spot عندما يكون تطبيقك جاهزًا للإنتاج.

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

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

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

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

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

setInterstitialType(InterstitialType): توفر Nend خيار تحديد TYPE_NORMAL للإعلانات البينية العادية أو TYPE_VIDEO لإعلانات الفيديو البينية. يستخدم Nend تلقائيًا استخدام TYPE_NORMAL كنوع بيني في حال عدم إضافة هذه المَعلمة الإضافية.
setNativeAdsType(nativeAdsType): توفر Nend خيار تحديد TYPE_NORMAL للإعلانات المدمجة مع المحتوى العادية أو TYPE_VIDEO لإعلانات الفيديو المدمجة مع المحتوى. يستخدم Nend تلقائيًا استخدام TYPE_NORMAL كنوع الإعلان المدمج مع المحتوى، في حال عدم إضافة هذه المعلمة الإضافية.

Java

Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
                        .setInterstitialType(InterstitialType.TYPE_NORMAL)
                        .setNativeAdsType(FormatType.TYPE_NORMAL)
                        .build();

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build();

adLoader.loadAd(adRequest);

Kotlin

val bundle = NendAdapter.NendExtrasBundleBuilder()
                     .setInterstitialType(InterstitialType.TYPE_NORMAL)
                     .setNativeAdsType(FormatType.TYPE_NORMAL)
                     .build()

val adRequest = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build()

adLoader.loadAd(adRequest)

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

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

يعرض محوّل Nend إعلاناته المدمجة مع المحتوى في شكل NativeAd كائنات. تتم تعبئة ما يلي: الحقول في NativeAd.

الحقل	تتم التعبئة بواسطة محوّل Nend
العنوان
صورة	1
النص الأساسي
رمز التطبيق	2
الحث على اتخاذ إجراء
اسم المعلن
التقييم النجمي
المتجر
السعر

¹ توفّر خدمة Nend فقط مواد عرض الصور لمواضع الإعلانات المدمجة مع المحتوى التي يتم ضبطها مع ضبط صورة الإعلان المحدّدة على صورة إعلانية كبيرة أفقية (5: 3).

² لا توفّر Nend مادة عرض رمز لمواضع الإعلانات المدمجة مع المحتوى التي تم ضبطها مع ضبط اختيار صورة الإعلان على بدون صورة (نص فقط).

رموز الخطأ

إذا تعذّر على المحوّل تلقّي إعلان من nend، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo.getAdapterResponse() ضمن الفئات التالية:

التنسيق	اسم الصف
بانر	com.google.ads.mediation.nend.NendAdapter
إعلان بيني	com.google.ads.mediation.nend.NendAdapter
تم منح المكافأة	com.google.ads.mediation.nend.NendRewardedAdapter
مدمجة مع المحتوى	com.google.ads.mediation.nend.NendMediationAdapter

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

رمز الخطأ	النطاق	السبب
101	com.google.ads.mediation.nend	يتطلب nend سياق نشاط لتحميل الإعلانات وعرضها.
102	com.google.ads.mediation.nend	مَعلمات خادم nend التي تم ضبطها في Ad Manager واجهة المستخدم غير متوفّرة/غير صالحة.
103	com.google.ads.mediation.nend	إعلان nend غير جاهز للعرض بعد.
104	com.google.ads.mediation.nend	تعذّر على nend تشغيل الإعلان.
105	com.google.ads.mediation.nend	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق.
106	com.google.ads.mediation.nend	مرجع عنصر السياق هو `null` و/أو تم إصداره مؤخرًا من الذاكرة.
200-299	net.nend.android	عرضت حزمة nend SDK خطأ في تحميل الإعلانات البينية. اطّلِع على الرمز البرمجي لمزيد من التفاصيل.
300-399	net.nend.android	عرضت حزمة nend SDK خطأ في إعلان عرض بيني. اطّلِع على الرمز البرمجي لمزيد من التفاصيل.
400-499	net.nend.android	عرضت حزمة nend SDK خطأ في الإعلان. اطّلِع على الرمز البرمجي لمزيد من التفاصيل.
101	com.google.mediation.nend	عرضت nend SDK معاودة الاتصال بتعذُّر التحميل بدون أي معلومات إضافية عن الخطأ.
102	com.google.mediation.nend	عرضت حزمة nend SDK معاودة الاتصال بتعذُّر العرض بدون أيّ معلومات إضافية عن الخطأ.
103	com.google.mediation.nend	مَعلمات خادم nend التي تم ضبطها في Ad Manager واجهة المستخدم غير متوفّرة/غير صالحة.
104	com.google.mediation.nend	تعذّر تحميل مواد عرض الصور في الإعلانات المدمجة مع المحتوى.
105	com.google.mediation.nend	تعذّر عرض الإعلانات لأنّ الإعلان غير جاهز.
106	com.google.mediation.nend	الحجم المطلوب لإعلان البانر غير متطابق مع حجم بانر متوافق.
200-699	تم الإرسال من خلال nend SDK.	حدث خطأ في حزمة nend SDK. راجِع مستند "نيند" للحصول على مزيد من التفاصيل.