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

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

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

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

• ודאו שהפעלתם את התכונה 'הכנסות מפרסום ברמת החשיפה' בממשק המשתמש של AdMob.
• פלאגין Unity מגרסה 5.0.0 ואילך.
• משלימים את תהליך תחילת העבודה. צריך לייבא כבר את הפלאגין Unity של Google Mobile Ads.

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

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

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

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

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

RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

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

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

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

SDK של שותף
Adjust
AppsFlyer
Singular
Tenjin

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

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

AdValue

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

נקודת מפתח: הערך של AdValue הוא ערך מיקרו שמייצג את השווי של כל מודעה. לדוגמה, ערך של 5,000 מציין ששווי המודעה הוא 0.005$.

AdValue.PrecisionType	תיאור
Unknown	ערך מודעה לא ידוע. הערך הזה מוחזר כשפינג חוזר של ערך חיי המשתמש מופעל אבל אין מספיק נתונים זמינים.
Estimated	הערך המשוער של המודעה על סמך נתונים נצברים.
PublisherProvided	בעל האפליקציה סיפק ערך מודעה, למשל, עלות ידנית לאלף חשיפות בקבוצה לבחירת רשת (Mediation).
Precise	הערך המדויק של המודעה הזו.

במקרה של תהליך בחירת הרשת (Mediation), מערכת AdMob מנסה לספק ESTIMATEDערך למקורות של מודעות שעברו אופטימיזציה. למקורות מודעות שלא עברו אופטימיזציה, או במקרים שבהם אין מספיק נתונים נצברים כדי לדווח על הערכה משמעותית, מוחזר הערך PUBLISHER_PROVIDED.