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

اختيار النظام الأساسي: Android‏ جديد Android‏ iOS‏ Unity‏

عند حدوث مرّة ظهور، يستدعي 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.

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