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

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

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

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

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

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

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

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

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

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

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

GADAdValue

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

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

בדיקת חשיפות ממכירה פומבית פתוחה

אחרי שמתרחש אירוע של הכנסות מפרסום ברמת החשיפה במקור מודעות מסוג Open Bidding דרך בקשת בדיקה, תקבלו רק את הערכים הבאים:

  • ‫GADAdValuePrecisionUnknown: מציין את סוג הדיוק.
  • ‫0: מציין את ערך המודעה.

בעבר, יכול להיות שסוג הדיוק היה מוצג כערך אחר מלבד GADAdValuePrecisionUnknown וערך המודעה היה גבוה מ-0.

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