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

בחירת פלטפורמה: Android (בטא) Android iOS Unity

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

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

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

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

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

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

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

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

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

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

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

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. מגדירים שם ייחודי למקור המודעות.

בדוגמה הבאה מוגדר שם ייחודי של מקור מודעות לאירוע מותאם אישית:

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

- (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)

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

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

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

GADAdValue

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

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

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

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

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

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

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