אחזור מידע על התגובה למודעה

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

במקרים שבהם מודעה נטענת בהצלחה, אובייקט המודעה כולל אמצעי תשלום אחד (GetResponseInfo()). לדוגמה, interstitialAd.GetResponseInfo(). מקבל את פרטי התגובה למודעת מעברון שנטענה.

במקרים שבהם מודעות לא נטענות ורק יש שגיאה, התגובה המידע זמין דרך LoadAdError.GetResponseInfo()

private void LoadInterstitialAd()
{
  AdRequest adRequest = new AdRequest();
  InterstitialAd.Load("AD_UNIT_ID", adRequest, (InterstitialAd insterstitialAd, LoadAdError error) =>
  {
    // If the operation failed with a reason.
    if (error != null)
    {
        ResponseInfo errorInfo = error.GetResponseInfo();
        Debug.LogError("Interstitial ad failed to load an ad with error : " + error);
        return;
    }

    ResponseInfo loadInfo = insterstitialAd.GetResponseInfo();
  });
}

פרטי התשובה

לפניכם פלט לדוגמה שהוחזר על ידי ResponseInfo.ToString(), שמראה נתוני ניפוי באגים שהוחזרו לגבי מודעה שנטענה:

Android

{
  "Response ID": "COOllLGxlPoCFdAx4Aod-Q4A0g",
  "Mediation Adapter Class Name": "com.google.ads.mediation.admob.AdMobAdapter",
  "Adapter Responses": [
    {
      "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
      "Latency": 328,
      "Ad Source Name": "Reservation campaign",
      "Ad Source ID": "7068401028668408324",
      "Ad Source Instance Name": "[DO NOT EDIT] Publisher Test Interstitial",
      "Ad Source Instance ID": "4665218928925097",
      "Credentials": {},
      "Ad Error": "null"
    }
  ],
  "Loaded Adapter Response": {
    "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
    "Latency": 328,
    "Ad Source Name": "Reservation campaign",
    "Ad Source ID": "7068401028668408324",
    "Ad Source Instance Name": "[DO NOT EDIT] Publisher Test Interstitial",
    "Ad Source Instance ID": "4665218928925097",
    "Credentials": {},
    "Ad Error": "null"
  },
  "Response Extras": {
    "mediation_group_name": "Campaign"
  }
}

iOS

 ** Response Info **
    Response ID: CIzs0ZO5kPoCFRqWAAAdJMINpQ
    Network: GADMAdapterGoogleAdMobAds

  ** Loaded Adapter Response **
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name: Reservation campaign
    Ad Source ID: 7068401028668408324
    Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
    Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
    AdUnitMapping:
    {
    }
    Error: (null)
    Latency: 0.391

  ** Extras Dictionary **
    {
        "mediation_group_name" = Campaign;
    }

  ** Mediation line items **
    Entry (1)
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name: Reservation campaign
    Ad Source ID:7068401028668408324
    Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
    Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
    AdUnitMapping:
    {
    }
    Error: (null)
    Latency: 0.391

ה-methods באובייקט ResponseInfo כוללות:

שיטה	תיאור
GetAdapterResponses	הפונקציה מחזירה את הרשימה של AdapterResponseInfo שמכילה מטא-נתונים לכל מתאם שכלול בתגובה להצגת מודעה. יכול לשמש לניפוי באגים רשימת הרשתות בתהליך בחירת הרשת והפעלת הבידינג. הסדר של הרשימה תואם הסדר של רשימת הרשתות בתהליך בחירת הרשת עבור הבקשה הזו להצגת מודעה. מידע נוסף זמין במאמר מידע על תגובת מתאם מידע.
GetLoadedAdapterResponseInfo	הפונקציה מחזירה את הערך AdapterResponseInfo שתואם למתאם שטען את המודעה.
GetMediationAdapterClassName	פונקציה זו מחזירה את שם המחלקה של מתאם תהליך בחירת הרשת של רשת המודעות שנטענה את המודעה.
GetResponseId	מזהה התגובה הוא מזהה ייחודי של התגובה לבקשת מודעה. הזה יכול לשמש לזיהוי ולחסימה של המודעה במרכז בקרת המודעות (ARC).
GetResponseExtras	בטא: ה-API הזה נמצא בגרסת בטא. הערכים המוחזרים יכולים להשתנות בלי גרסת SDK. הפונקציה מחזירה מידע נוסף על התגובה לבקשת המודעה. תוספות יכולות להחזיר המפתחות הבאים: mediation_group_name: שם הקבוצה לבחירת רשת (Mediation) mediation_ab_test_name: השם של בדיקת ה-A/B של תהליך בחירת הרשת, אם רלוונטי mediation_ab_test_variant: הווריאנט שבו נעשה שימוש בדיקת A/B של תהליך בחירת הרשת (Mediation), אם רלוונטי

לפניכם דוגמה לערכים של קריאה מ-ResponseInfo שנטען:

private void LoadInterstitialAd()
{
  AdRequest adRequest = new AdRequest();
  InterstitialAd.Load("AD_UNIT_ID", adRequest, (InterstitialAd insterstitialAd, LoadAdError error) =>
  {
    // If the operation failed with a reason.
    if (error != null)
    {
        Debug.LogError("Interstitial ad failed to load an ad with error : " + error);
        return;
    }

    ResponseInfo responseInfo = insterstitialAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();
    string mediationAdapterClassName = responseInfo.GetMediationAdapterClassName();
    List<AdapterResponseInfo> adapterResponses = responseInfo.GetAdapterResponses();
    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    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"]; 
  });
}

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

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

לפניכם פלט לדוגמה שהוחזר על ידי AdapterResponseInfo:

Android

{
  "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
  "Latency": 328,
  "Ad Source Name": "Reservation campaign",
  "Ad Source ID": "7068401028668408324",
  "Ad Source Instance Name": "[DO NOT EDIT] Publisher Test Interstitial",
  "Ad Source Instance ID": "4665218928925097",
  "Credentials": {},
  "Ad Error": "null"
}

iOS

  Network: GADMAdapterGoogleAdMobAds
  Ad Source Name: Reservation campaign
  Ad Source ID: 7068401028668408324
  Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
  Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
  AdUnitMapping:
  {
  }
  Error: (null)
  Latency: 0.391

לכל רשת מודעות, AdapterResponseInfo מספק את השיטות הבאות:

שיטה	תיאור
AdError	הפונקציה מקבלת לרשת את השגיאה המשויכת לבקשה. החזרות null אם הרשת טעונה בהצלחה מודעה, או אם לא נעשה ניסיון.
AdSourceId	הפונקציה מקבלת את המזהה של מקור המודעות שמשויך לתגובת המתאם הזו. לגבי קמפיינים, סכום של 6060308706800320801 מוחזר עבור מודעות בתהליך בחירת הרשת סוג היעד של הקמפיין, ו-7068401028668408324 מוחזר עבור חשיפה וקליקים סוגי יעדים. מידע נוסף זמין בקטע מקורות של מודעות. לרשימת המזהים האפשריים של מקורות המודעות כשרשת מודעות מציגה את המודעה.
AdSourceInstanceId	הפונקציה מקבלת את מזהה המופע של מקור המודעות שמשויך למתאם הזה. תשובה.
AdSourceInstanceName	הפונקציה מקבלת את שם המופע של מקור המודעות שמשויך למתאם הזה. תשובה.
AdSourceName	הפונקציה מקבלת את מקור המודעות שמייצג את רשת המודעות הספציפית שמציגה את חשיפה. לגבי קמפיינים, סכום של Mediated House Ads מוחזר עבור מודעות בתהליך בחירת הרשת סוג היעד של הקמפיין, ו-Reservation Campaign מוחזר עבור חשיפה וקליקים סוגי יעדים. מידע נוסף זמין בקטע מקורות של מודעות. לרשימה של שמות אפשריים של מקורות מודעות כשרשת מודעות מציגה את המודעה.
AdapterClassName	הפונקציה מקבלת שם מחלקה שמזהה את רשת המודעות.
AdUnitMapping	הפונקציה מקבלת את הגדרות הרשת שהוגדרו מממשק המשתמש של AdMob.
LatencyMillis	הפונקציה מחזירה את משך הזמן שרשת המודעות הקדישה לטעינת מודעה. הפונקציה מחזירה את הערך 0 אם לא נעשה ניסיון להשתמש ברשת.

לפניכם דוגמה לערכים של קריאה מ-AdapterResponseInfo שנטען:

private void LoadInterstitialAd()
{
  AdRequest adRequest = new AdRequest();
  InterstitialAd.Load("AD_UNIT_ID", adRequest, (InterstitialAd insterstitialAd, LoadAdError error) =>
  {
    // If the operation failed with a reason.
    if (error != null)
    {
        Debug.LogError("Interstitial ad failed to load an ad with error : " + error);
        return;
    }

    ResponseInfo responseInfo = insterstitialAd.GetResponseInfo();
    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.getLoadedAdapterResponseInfo();
    AdError adError = loadedAdapterResponseInfo.AdError;
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
  });
}