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

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

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

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

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

المتطلّبات

  • Unity 4 أو أعلى
  • أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
  • للنشر على Android:
    • المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android
  • للنشر على iOS:
    • هدف نشر iOS هو 12.0 أو إصدار أحدث
  • مشروع Unity عملي تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على التفاصيل.
  • إكمال عملية التوسّط دليل البدء

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

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

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

إنشاء تطبيق

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

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

Android

iOS

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

Android

iOS

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

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

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

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

إعلان بيني

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

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

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

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

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

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

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

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

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

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

دوِّن apiKey وspotID.

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

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

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

Android

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

iOS

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

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

نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة من رابط التنزيل في سجلّ التغييرات واستخرج حزمة GoogleMobileAdsNendMediation.unitypackage من ملف zip.

في محرر مشروع Unity، حدد Assets >Import Package > Custom Package وابحث عن الملف GoogleMobileAdsNendMediation.unitypackage الذي قمت بتنزيله. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android > فرض الحل. ستنفِّذ مكتبة أداة حلّ المشاكل في Unity Play حلّ مشكلة الاعتماد من البداية وستنسخ التبعيات المُعلَنة إلى دليل Assets/Plugins/Android في تطبيق Unity.

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

Android

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

iOS

دمج SKAdNetwork

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

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

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

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

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

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

رموز الخطأ

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

Android

com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter

iOS

GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend

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

Android

رمز الخطأ النطاق السبب
101 com.google.ads.mediation.nend يتطلب nend سياق نشاط لتحميل الإعلانات وعرضها.
102 com.google.ads.mediation.nend مَعلمات خادم nend التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة/غير صالحة.
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 خطأ في الإعلان. اطّلِع على الرمز البرمجي لمزيد من التفاصيل.

iOS

رمز الخطأ النطاق السبب
101 com.google.mediation.nend عرضت nend SDK معاودة الاتصال بتعذُّر التحميل بدون أي معلومات إضافية عن الخطأ.
102 com.google.mediation.nend عرضت حزمة nend SDK معاودة الاتصال بتعذُّر العرض بدون أيّ معلومات إضافية عن الخطأ.
103 com.google.mediation.nend مَعلمات خادم nend التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة/غير صالحة.
104 com.google.mediation.nend تعذّر تحميل مواد عرض الصور في الإعلانات المدمجة مع المحتوى.
105 com.google.mediation.nend تعذّر عرض الإعلانات لأنّ الإعلان غير جاهز.
106 com.google.mediation.nend الحجم المطلوب لإعلان البانر غير متطابق مع حجم بانر متوافق.
200-699 تم الإرسال من خلال nend SDK. حدث خطأ في حزمة nend SDK. راجِع مستند "نيند" للحصول على مزيد من التفاصيل.

سجلّ تغييرات المكوّن الإضافي nend Unity Mediation

الإصدار 8.0.0

الإصدار 7.0.0

الإصدار 6.0.1

الإصدار 6.0.0

الإصدار 5.2.0

الإصدار 5.1.0

الإصدار 5.0.0

الإصدار 4.0.1

الإصدار 4.0.0

الإصدار 3.0.0

الإصدار 2.3.0

الإصدار 2.2.0

الإصدار 2.1.0

  • تم تحديث المكوّن الإضافي للتوافق مع واجهة برمجة التطبيقات الجديدة التي تضم مكافآت.
  • يتوافق مع الإصدار 5.1.0.2 من محوّل nend Android
  • يتوافق مع الإصدار 5.1.1.0 من محوّل nend iOS.

الإصدار 2.0.3

  • يتوافق مع الإصدار 5.0.2.1 من محوّل nend Android.
  • يتوافق مع الإصدار 5.0.2.0 من محوّل nend iOS.

الإصدار 2.0.2

  • يتوافق مع الإصدار 5.0.2.0 من محوّل nend Android
  • يتوافق مع الإصدار 5.0.2.0 من محوّل nend iOS.

الإصدار 2.0.1

  • يتوافق مع الإصدار 5.0.2.0 من محوّل nend Android
  • يتوافق مع الإصدار 5.0.1.0 من محوّل nend iOS.

الإصدار 2.0.0

  • يتوافق مع الإصدار 5.0.0.0 من محوّل nend Android
  • يتوافق مع الإصدار 5.0.0.0 من محوّل nend iOS.

الإصدار 1.0.2

  • يتوافق مع الإصدار 4.0.5.0 من محوّل nend Android.
  • يتوافق مع الإصدار 4.0.6.0 من محوّل nend iOS.

الإصدار 1.0.1

  • يتوافق مع الإصدار 4.0.4 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
  • يتوافق مع الإصدار 4.0.4 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS.

الإصدار 1.0.0

  • الإصدار الأول
  • يتوافق مع الإصدار 4.0.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
  • يتوافق مع الإصدار 4.0.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS.