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

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

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

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

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

לכל פורמט מודעה יש אירוע 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&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, 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 מיד אחרי שיוצרים את אובייקט המודעה או מקבלים אליו גישה, ובכל מקרה לפני הצגת המודעה. כך תוכלו לוודא שלא תפספסו אף קריאה חוזרת.
  • שולחים את נתוני ההכנסות מפרסום ברמת החשיפה לשרת הניתוח המועדף באופן מיידי ב-handler של OnPaidEvent. כך תוכלו לוודא שלא תפספסו בטעות קריאות חוזרות ולא יהיו פערים בנתונים.

AdValue

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

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

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

בדיקת חשיפות ממכירה פומבית פתוחה

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

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

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

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