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

בחירת פלטפורמה: Android iOS Unity Android (גרסה קודמת)

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

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

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

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

לכל פורמט מודעה יש אירוע OnPaidEvent. במהלך מחזור החיים של אירוע מודעה, Google Mobile Ads Unity Plugin עוקב אחרי אירועי חשיפה ומפעיל את ה-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)

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

ערכת SDK של שותף
Adjust
AppsFlyer
Singular
Tenjin

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

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

AdValue

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

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

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

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

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

  • ‫Unknown: מציין את רמת הדיוק.
  • ‫0: מציין את ערך המודעה.
בעבר, יכול להיות שראיתם שרמת הדיוק היא ערך שונה מ-Unknown וערך המודעה גבוה מ-0.

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