למטרות ניפוי באגים ורישום ביומן, מודעות שנטענות בהצלחה מספקות
אובייקט 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
השיטות באובייקט ResponseInfo
כוללות:
שיטה | תיאור |
---|---|
GetAdapterResponses |
הפונקציה מחזירה את הרשימה של AdapterResponseInfo שמכילה מטא-נתונים לכל מתאם שכלול בתגובה של המודעה. אפשר להשתמש בה כדי לנפות באגים בתהליך בחירת הרשת (Mediation) ובביצוע הבידינג ב-Waterfall. הסדר של הרשימה תואם
הסדר של רשימת הרשתות בתהליך בחירת הרשת עבור הבקשה הזו להצגת מודעה.
מידע נוסף זמין במאמר פרטי התגובה של המתאם. |
GetLoadedAdapterResponseInfo |
הפונקציה מחזירה את הערך AdapterResponseInfo שתואם למתאם
שטען את המודעה. |
GetMediationAdapterClassName |
פונקציה זו מחזירה את שם המחלקה של מתאם תהליך בחירת הרשת של רשת המודעות שנטענה את המודעה. |
GetResponseId |
מזהה התגובה הוא מזהה ייחודי של התגובה לבקשת מודעה. הזה יכול לשמש לזיהוי ולחסימה של המודעה במרכז בקרת המודעות (ARC). |
GetResponseExtras |
הפונקציה מחזירה מידע נוסף על התגובה לבקשת המודעה. התוספות יכולות להחזיר את המפתחות הבאים:
|
דוגמה לקריאת ערכים מ-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
מכיל מטא-נתונים לכל מתאם שכלול בתגובה למודעה, שאפשר להשתמש בהם כדי לנפות באגים בתהליך בחירת הרשת ב-Waterfall ובביצוע הבידינג. הסדר ברשימה תואם לסדר של רשימת הרשתות בתהליך בחירת הרשת
לבקשה להצגת מודעה.
זוהי דוגמה לפלט שחוזרת הפונקציה 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;
});
}