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

اختيار النظام الأساسي: Android (إصدار تجريبي) Android iOS Unity

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

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

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

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

• الإصدار Google Mobile Ads SDK 9.10.0 أو إصدار أحدث
• أكمِل دليل البدء.

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

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

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

يحتوي كل شكل إعلان على السمة 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)."
  )
}
ImpressionLevelAdRevenueSnippets.swift

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

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

بالنسبة إلى مصادر الإعلانات للأحداث المخصّصة، يمنحك السمة 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
}
ResponseInfoSnippets.swift

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

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

الدمج مع شركاء قياس أداء التطبيقات (AAP)

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

Partner SDK
Adjust
AppsFlyer
Singular
Tenjin

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

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

GADAdValue

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

نقطة أساسية: قيمة GADAdValue.value هي عدد عشري يمثّل قيمة كل إعلان. على سبيل المثال، تعني القيمة 0.005 أنّ قيمة هذا الإعلان تبلغ 0.005 دولار أمريكي.

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

نقطة أساسية: في حالة التوسّط، تحاول AdMob تقديم GADAdValuePrecisionEstimated أولاً، ثم تعود إلى GADAdValuePrecisionPublisherProvided إذا لم تتوفّر بيانات مجمّعة كافية لتسجيل قيمة مفيدة.

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

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

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

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

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

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