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

כשמתרחשת חשיפה, מערכת Google Mobile Ads SDK for React Native מספקת נתוני הכנסות מפרסום שמשויכים לחשיפה הזו. אתם יכולים להשתמש בנתונים האלה כדי לחשב את ערך חיי המשתמש (LTV), או להעביר את הנתונים לפלטפורמות של ניתוח נתונים או לשותפי שיוך (Attribution) של צד שלישי.

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

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

לפני שממשיכים, צריך לבצע את הפעולות הבאות:

כל פורמט מודעה תומך בקריאה חוזרת (callback) לאירוע onAdPaid. במהלך מחזור החיים של המודעה, Google Mobile Ads SDK for React Native עוקב אחרי אירועי חשיפה ומפעיל את ה-handler עם מטען ייעודי (payload) של AdValue שנצבר.

בדוגמה הבאה, רכיב event listener בתשלום נרשם במודעה מתגמלת, מתעד ביומן את נתוני ההכנסות מפרסום ומציג את המודעה:

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

מומלץ לבצע את הפעולות הבאות:

  • במודעות במסך מלא, מגדירים את המאזין באובייקט המודעה אחרי שטוענים את המודעה ולפני שמציגים אותה. במודעות באנר ובמודעות מותאמות, מעבירים את הקריאה החוזרת (callback) של onAdPaid כמאפיין לרכיב <BannerAdView /> או <NativeAdView />. התהליך הזה מבטיח שלא תפספסו קריאות חוזרות (callbacks) של אירועים בתשלום.

  • שולחים את המידע על ההכנסות מפרסום לפי חשיפות לשרת הניתוח המועדף כש-Google Mobile Ads SDK for React Native מפעיל את הקריאה החוזרת (callback) של onAdPaid. התהליך הזה מבטיח שלא תפספסו קריאות חוזרות (callbacks) ושומר על עקביות הנתונים.

מידע על שילוב AAP

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

הסבר על האובייקט AdValue

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

נכס תיאור
amountMicros ההכנסות מפרסום במיקרו-יחידות, כאשר 1000000 מיקרו-יחידות שוות ליחידת מטבע אחת, כמו 1.00 דולר ארה"ב או 1.00 אירו.
currencyCode קוד המטבע לפי תקן ISO 4217 של ערך המודעה, לדוגמה, USD או EUR.
precision רמת הדיוק של ערך המודעה. ברשימה הבאה מפורטות רמות הדיוק:
  • UNKNOWN: ערך מודעה לא ידוע. הערך הזה מוחזר כשדיווח החזרה (pingback) של ערך חיי המשתמש מופעל בלי מספיק נתונים.
  • ‫ESTIMATED: הערך המשוער של המודעה על סמך נתונים נצברים.
  • PUBLISHER_PROVIDED: ערך מודעה שסופק על ידי בעל האפליקציה, כמו עלויות ידניות לאלף חשיפות בקבוצה לבחירת רשת.
  • ‫PRECISE: הערך המדויק ששולם על מודעה.

בתהליך בחירת הרשת (Mediation) ב-AdMob, המערכת מנסה לספק ערך ESTIMATED למקורות מודעות שעברו אופטימיזציה. מידע נוסף זמין במאמר אופטימיזציה של מקורות המודעות ב-Waterfall בתהליך בחירת הרשת (Mediation). אם מקור מודעות לא עבר אופטימיזציה, או שאין מספיק נתונים נצברים כדי ליצור אומדן, Google Mobile Ads SDK for React Native מחזירה את רמת הדיוק PUBLISHER_PROVIDED.

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

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

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

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