הכנסות מפרסום ברמת החשיפה

כשמתרחשת חשיפה, מערכת Google Mobile Ads SDK מספקת נתוני הכנסות מפרסום שמשויכים לחשיפה הזו. אתם יכולים להשתמש בנתונים כדי לחשב את ערך חיי המשתמש, או להעביר את הנתונים למערכות רלוונטיות אחרות.

המדריך הזה נועד לעזור לכם להטמיע תיעוד של נתוני ערך חיי המשתמש (LTV) באפליקציה ל-iOS.

דרישות מוקדמות

טיפול באירועים בתשלום

פרוטוקול ה-delegate של כל פורמט מודעה כולל את השיטה didRecordPaidEventWithAdValue:. במהלך מחזור החיים של המודעה, Google Mobile Ads SDK עוקב אחרי אירועי חשיפה וקורא לשיטת הנציג הזו עם אובייקט GADAdValue שהתקבל.

בדוגמה הבאה מוסבר איך לטפל באירועים בתשלום במודעה מתגמלת:

Swift

func ad(_ ad: FullScreenPresentingAd, didRecordPaidEventWith adValue: 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.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

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

Objective-C

- (void)ad:(id<GADFullScreenPresentingAd>)ad didRecordPaidEventWithAdValue:(GADAdValue *)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;
}

מידע נוסף על מקור המודעות הזוכה זמין במאמר אחזור מידע על התגובה למודעה.

שיטות מומלצות להטמעה

  • צריך להגדיר את ה-delegate מיד אחרי שיוצרים את אובייקט המודעה או מקבלים גישה אליו, ובכל מקרה לפני שמציגים את המודעה. כך לא תפספסו אף קריאה חוזרת (callback) של אירוע בתשלום.
  • שולחים את פרטי האירוע בתשלום לשרת הניתוח המועדף מיד כשמתבצעת קריאה ל-delegate method של didRecordPaidEventWithAdValue:. כך אפשר לוודא שלא מפספסים בטעות קריאות חוזרות (callbacks) ומונעים פערים בנתונים.

GADAdValue

‫GADAdValue היא מחלקה שמייצגת את הערך הכספי שהתקבל ממודעה, כולל קוד המטבע של הערך ורמת הדיוק שלו, שמקודדים באופן הבא.

GADAdValuePrecision תיאור
GADAdValuePrecisionUnknown ערך מודעה לא ידוע. השגיאה הזו מוחזרת כשמופעל פינגבק של ערך חיי המשתמש, אבל אין מספיק נתונים זמינים.
GADAdValuePrecisionEstimated הערך המשוער של המודעה על סמך נתונים נצברים.
GADAdValuePrecisionPublisherProvided ערך מודעה שסופק על ידי בעל האפליקציה, כמו עלויות ידניות לאלף חשיפות בקבוצה לבחירת רשת (Mediation).
GADAdValuePrecisionPrecise הערך המדויק ששולם על המודעה הזו.

חשיפות לבדיקה מ-Open Bidding

אחרי שמתרחש אירוע של הכנסות מפרסום לפי חשיפות (iLAR) במקור מודעות ל-Open Bidding באמצעות בקשת בדיקה, אתם מקבלים רק את הערכים הבאים:

  • ‫GADAdValuePrecisionUnknown: מציין את רמת הדיוק.
  • ‫0: מציין את ערך המודעה.
יכול להיות שבעבר ראיתם שרמת הדיוק היא ערך שונה מ- GADAdValuePrecisionUnknown וערך המודעה גבוה מ-0.

במאמר הפעלת מכשירי בדיקה מוסבר איך שולחים בקשה להצגת מודעת בדיקה.