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

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

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

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

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

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

  • Banner
  • מודעות Interstitial
  • Rewarded
  • מודעות מעברון מתגמלות
  • מודעות מותאמות

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

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

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

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    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 הוא ערך מיקרו שמייצג את הערך של כל מודעה. לדוגמה, ערך של 5,000 מציין שהערך המשוער של המודעה הזו הוא 0.005$.

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

במקרה של תהליך בחירת רשת, מערכת AdMob מנסה לספק ערך Estimated למקורות מודעות שעברו אופטימיזציה. במקרים של מקורות מודעות שלא בוצעה להם אופטימיזציה, או במקרים שבהם אין מספיק נתונים נצברים כדי לדווח על הערכה משמעותית, המערכת מחזירה את הערך PublisherProvided.

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

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

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

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

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

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