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

בחירת פלטפורמה: Android iOS Unity Android (Legacy)

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

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

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

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

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

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

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

לכל פורמט מודעה יש אירוע 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)

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

Partner SDK
Adjust
AppsFlyer
Singular
Tenjin

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

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

AdValue

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

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

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

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

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

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

• ‫Unknown: מציין את רמת הדיוק.

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

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

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