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

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

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

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

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

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

SwiftObjective-C
class ViewController: UIViewController, GADFullScreenContentDelegate {
  var rewardedAd: GADRewardedAd?
  func requestRewardedAd() {
    GADRewardedAd.load(
      withAdUnitID: "AD_UNIT_ID", request: GADRequest()
    ) { (ad, error) in
      if let error = error {
        print("Rewarded ad failed to load with error: \(error.localizedDescription)")
        return
      }
      if let ad = ad {
        self.rewardedAd = ad
        self.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 precision = adValue.precision
          let currencyCode = adValue.currencyCode

          // Get the ad unit ID.
          let adUnitId = ad.adUnitID

          let responseInfo = ad.responseInfo
          let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo
          let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
          let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
          let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
          let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
          let mediationGroupName = responseInfo?.extrasDictionary["mediation_group_name"]
          let mediationABTestName = responseInfo?.extrasDictionary["mediation_ab_test_name"]
          let mediationABTestVariant = responseInfo?.extrasDictionary["mediation_ab_test_variant"]
        }
      }
    }
  }
}

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()
@property(nonatomic, strong) GADRewardedAd *rewardedAd;
@end

@implementation ViewController
- (void)requestRewardedAd {
  __weak ViewController *weakSelf = self;

  GADRequest *request = [GADRequest request];
  [GADRewardedAd
   loadWithAdUnitID:@"AD_UNIT_ID"
   request:request
   completionHandler:^(GADRewardedAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
      return;
    }
    self.rewardedAd = ad;
    self.rewardedAd.paidEventHandler = ^void(GADAdValue *_Nonnull value){
      ViewController *strongSelf = weakSelf;
      // 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; = value.value;
      NSString *currencyCode = value.currencyCode;
      GADAdValuePrecision precision = value.precision;

      // Get the ad unit ID.
      NSString *adUnitId = strongSelf.rewardedAd.adUnitID;

      GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo =
          strongSelf.rewardedAd.responseInfo.loadedAdNetworkResponseInfo;
      NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
      NSString *adSourceID = loadedAdNetworkResponseInfo.adSourceID;
      NSString *adSourceInstanceName = loadedAdNetworkResponseInfo.adSourceInstanceName;
      NSString *adSourceInstanceID = loadedAdNetworkResponseInfo.adSourceInstanceID;
      NSDictionary<NSString *, id> *extras = strongSelf.rewardedAd.responseInfo.extrasDictionary;
      NSString *mediationGroupName = extras["mediation_group_name"];
      NSString *mediationABTestName = extras["mediation_ab_test_name"];
      NSString *mediationABTestVariant = extras["mediation_ab_test_variant"];
    };
  ]};
}

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

שילוב עם שותפי דוחות שיוך לקמפיינים של אפליקציה (AAP)

פרטים מלאים על העברת נתוני הכנסות מפרסום לפלטפורמות ניתוח נתונים זמינים במדריך של השותף:

Partner SDK
Adjust
AppsFlyer
Singular
Tenjin

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

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

GADAdValue

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

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

בדיקת חשיפות ממקורות של מודעות לבידינג

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

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

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

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