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

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

عند حدوث ظهور، يستدعي "Google Mobile Ads SDK" معالج الأحداث المدفوعة مع بيانات الإيرادات المرتبطة به. من خلال تنفيذ هذا المعالج، يمكنك استخدام البيانات لاحتساب القيمة الدائمة للمستخدم أو إعادة توجيه البيانات إلى أنظمة أخرى ذات صلة.

يهدف هذا الدليل إلى مساعدتك في تسجيل بيانات القيمة الدائمة في تطبيق iOS.

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

تنفيذ معالج الأحداث المدفوعة

يحتوي كل شكل إعلان على سمة paidEventHandler من النوع GADPaidEventHandler. أثناء مراحل نشاط حدث الإعلان، يراقب Google Mobile Ads SDK أحداث مرات الظهور ويستدعي المعالج بقيمة مكتسبة.

يتناول المثال التالي الأحداث المدفوعة في "إعلان مقابل مكافأة":

Swift

rewardedAd?.paidEventHandler = { adValue in
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

  print(
    "Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
  )
}

Objective-C

rewardedAd.paidEventHandler = ^(GADAdValue *_Nonnull adValue) {
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  NSDecimalNumber *value = adValue.value;
  NSString *currencyCode = adValue.currencyCode;
  GADAdValuePrecision precision = adValue.precision;

  NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode,
        (long)precision);
};

تحديد اسم مصدر إعلان حدث مخصّص

بالنسبة إلى مصادر الإعلانات للأحداث المخصّصة، يمنحك العنصر adSourceName اسم مصدر الإعلان Custom event. إذا كنت تستخدم أحداثًا مخصّصة متعددة، لن يكون اسم مصدر الإعلان دقيقًا بما يكفي للتمييز بين الأحداث المخصّصة المتعددة. للعثور على حدث مخصّص معيّن، اتّبِع الخطوات التالية:

  1. احصل على السمة adNetworkClassName.
  2. اضبط اسمًا فريدًا لمصدر الإعلان.

يضبط المثال التالي اسمًا فريدًا لمصدر الإعلان لحدث مخصّص:

Swift

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

Objective-C

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

لمزيد من المعلومات عن مصدر الإعلان الفائز، يُرجى الاطّلاع على مقالة استرداد معلومات عن استجابة الإعلان.

أفضل الممارسات المتعلقة بالتنفيذ

  • اضبط المعالج فور إنشاء عنصر الإعلان أو الحصول على إذن الوصول إليه، وقبل عرض الإعلان بالتأكيد. يضمن ذلك عدم تفويت أي عمليات استدعاء لأحداث مدفوعة.
  • أرسِل معلومات الحدث المدفوع إلى خادم الإحصاءات المفضّل لديك فورًا عند استدعاء طريقة paidEventHandler. يضمن ذلك عدم إسقاط أي عمليات ردّ آلي عن طريق الخطأ وتجنُّب أي تفاوت في البيانات.

GADAdValue

‫GADAdValue هي فئة تمثّل القيمة المالية المكتسبة من إعلان، بما في ذلك رمز عملة القيمة وتصنيف دقة القيمة المرمّز على النحو التالي.

GADAdValuePrecision الوصف
GADAdValuePrecisionUnknown قيمة إعلان غير معروفة يتم عرض هذه الحالة عند تفعيل إشارة قياس ظهور الإعلان للقيمة الدائمة، ولكن لا تتوفّر بيانات كافية.
GADAdValuePrecisionEstimated هي قيمة إعلان مقدّرة من بيانات مجمّعة.
GADAdValuePrecisionPublisherProvided قيمة الإعلان المقدّمة من الناشر، مثل التكلفة اليدوية لكل ألف ظهور في مجموعة توسّط
GADAdValuePrecisionPrecise هي القيمة الدقيقة المدفوعة مقابل هذا الإعلان.

مرّات الظهور الاختبارية من "عرض الأسعار المفتوح"

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

  • ‫GADAdValuePrecisionUnknown: يشير إلى تصنيف دقة القيمة.
  • 0: يشير إلى قيمة الإعلان.
في السابق، ربما ظهر لك تصنيف دقة القيمة كقيمة أخرى غير GADAdValuePrecisionUnknown وقيمة إعلان أكبر من 0.

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