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

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

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

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

• ודאו שהפעלתם את התכונה 'הכנסות מפרסום ברמת החשיפה' בממשק המשתמש של AdMob.

• מייבאים את Google Mobile Ads SDK מגרסה 9.10.0 ואילך.
• מבצעים את ההוראות שמופיעות במדריך לתחילת העבודה.

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

  • מודעות באנר
  • מודעות מעברון
  • מודעות מתגמלות
  • מודעת מעברון מתגמלת
  • מודעות מותאמות

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

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

Swift

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"]
        }
      }
    }
  }
}

Objective-C

@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"];
    };
  ]};
}

נקודה חשובה: מומלץ להשתמש ב-adSourceName() במקום ב-adNetworkClassName() כדי לזהות את מקור המודעות שטען את המודעה.

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

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

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

SDK של שותף
Adjust
AppsFlyer
Singular
Tenjin

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

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

GADAdValue

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

נקודת מפתח: הערך של GADAdValue.value הוא מספר עשרוני שמייצג את השווי של כל מודעה. לדוגמה, ערך של 0.005 מציין ששווי המודעה הוא 0.005 ש"ח.

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

נקודה חשובה: במקרה של תהליך בחירת הרשת (Mediation), AdMob מתבצע ניסיון לספק קודם GADAdValuePrecisionEstimated, וחוזרים ל-GADAdValuePrecisionPublisherProvided אם אין מספיק נתונים נצברים לדיווח על ערך משמעותי.