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

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

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

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

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

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

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


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)

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

Partner SDK
Adjust
AppsFlyer
Singular
Tenjin

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

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

AdValue

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

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

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

בדיקת חשיפות מ-Open Bidding

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

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

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

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