أرباح الإعلانات على مستوى مرّات الظهور

عند تسجيل مرّة ظهور، يقدّم Google Mobile Ads SDK for React Native بيانات إيرادات الإعلانات المرتبطة بمرّة الظهور هذه. يمكنك استخدام هذه البيانات لاحتساب القيمة الدائمة (LTV) للمستخدم أو إعادة توجيه البيانات إلى منصات الإحصاءات أو شركاء تحديد المصدر التابعين لجهات خارجية.

يتناول هذا الدليل كيفية تسجيل بيانات إيرادات الإعلانات على مستوى مرّة الظهور في تطبيق React Native.

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

قبل المتابعة، عليك تنفيذ ما يلي:

يتيح كل شكل إعلان استخدام دالة ردّ نداء لحدث onAdPaid. خلال مراحل نشاط الإعلان، يراقب Google Mobile Ads SDK for React Native أحداث مرات الظهور ويستدعي المعالج باستخدام حمولة AdValue المكتسبة.

يسجّل المثال التالي متتبِّع أحداث مدفوعة في "إعلان مقابل مكافأة"، ويسجّل بيانات إيرادات الإعلانات المكتسَبة، ويعرض الإعلان:

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

ننصحك باتّباع الخطوات التالية:

  • بالنسبة إلى الإعلانات بملء الشاشة، اضبط المستمع على عنصر الإعلان بعد تحميل الإعلان وقبل عرضه. بالنسبة إلى "إعلانات البانر" و"الإعلانات المدمجة مع المحتوى"، مرِّر دالة الاستدعاء onAdPaid كسمة إلى المكوّن <BannerAdView /> أو <NativeAdView />. تضمن هذه العملية عدم تفويت أي عمليات استدعاء للأحداث المدفوعة.

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

مزيد من المعلومات حول دمج "شركاء إحالة التطبيقات"

لمعرفة تفاصيل حول إعادة توجيه بيانات إيرادات الإعلانات إلى منصات الإحصاءات، يُرجى الاطّلاع على أدلة شركاء قياس أداء التطبيقات (AAP) التالية:

التعرّف على عنصر AdValue

يمثّل عنصر AdValue القيمة النقدية المكتسبة من إعلان، بما في ذلك رمز العملة وتصنيف دقة القيمة. يعرض الجدول التالي سمات عنصر AdValue:

الموقع الوصف
amountMicros إيرادات الإعلانات بالوحدات الصغيرة، حيث يساوي 1000000 وحدة صغيرة وحدة عملة واحدة، مثل دولار أمريكي واحد أو يورو واحد.
currencyCode رمز العملة وفقًا لمعيار ISO 4217 لقيمة الإعلان، مثل USD أو EUR.
precision مستوى دقة قيمة الإعلان توضّح القائمة التالية كل مستوى من مستويات الدقة:
  • ‫UNKNOWN: قيمة إعلان غير معروفة يتم عرض هذه القيمة عند تفعيل إشارة قياس ظهور الإعلان للقيمة الدائمة بدون توفّر بيانات كافية.
  • ‫ESTIMATED: قيمة إعلان مقدّرة من بيانات مجمّعة.
  • ‫PUBLISHER_PROVIDED: قيمة إعلان يقدّمها الناشر، مثل التكلفة اليدوية لكل ألف ظهور في مجموعة توسّط.
  • ‫PRECISE: هي القيمة الدقيقة المدفوعة مقابل عرض الإعلان.

في ميزة "توسط AdMob"، تحاول AdMob تقديم قيمة ESTIMATED لمصادر الإعلانات التي تم تحسينها. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة تحسين مصادر الإعلانات للعرض بدون انقطاع في التوسّط. إذا لم يتم تحسين مصدر إعلان أو لم تتوفّر بيانات مجمّعة كافية لتقديم تقدير، تعرض Google Mobile Ads SDK for React Native تصنيف دقة القيمة PUBLISHER_PROVIDED.

اختبار مرّات الظهور من مصادر الإعلانات المستندة إلى عروض الأسعار

بعد تسجيل حدث مرتبط بإيرادات الإعلان على مستوى مرّة الظهور لمصدر إعلان مستند إلى عروض الأسعار من خلال طلب اختباري، ستتلقّى القيم التالية فقط:

  • ‫UNKNOWN: يشير إلى تصنيف دقة القيمة.
  • 0: يشير إلى قيمة الإعلان.

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