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

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

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

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

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

• تأكَّد من تفعيل ميزة "إيرادات الإعلان على مستوى مرّة الظهور feature" في واجهة مستخدم AdMob.

• استورِد Google Mobile Ads SDK 9.10.0 أو إصدارًا أحدث.
• إعداد Google Mobile Ads SDK

• قبل أن تتمكّن من تلقّي أيّ إيرادات إعلانات على مستوى مرّة الظهور، عليك تنفيذ شكل إعلان واحد على الأقلّ:

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

تنفيذ معالج حدث "الإعلان المدفوع"

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

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

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)."
  )
}
ImpressionLevelAdRevenueSnippets.swift

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);
};
ImpressionLevelAdRevenueSnippets.m

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

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

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

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

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
}
ResponseInfoSnippets.swift

- (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;
}
ResponseInfoSnippets.m

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

الدمج مع شركاء إحالة التطبيقات (AAP)

لمعرفة التفاصيل الكاملة حول إعادة توجيه بيانات إيرادات الإعلانات إلى منصّات الإحصاءات، يُرجى الرجوع إلى دليل الشريك:

أفضل ممارسات التنفيذ

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

GADAdValue

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

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

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

• GADAdValuePrecisionUnknown: يشير إلى نوع الدقة.

• 0: يشير إلى قيمة الإعلان.

في السابق، ربما كنت ترى نوع الدقة كقيمة أخرى غير GADAdValuePrecisionUnknown وقيمة إعلان أكبر من 0.

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