ดึงข้อมูลเกี่ยวกับการตอบกลับของโฆษณา

โฆษณาที่โหลดสำเร็จจะมีออบเจ็กต์ ResponseInfo เพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่องและการบันทึก ออบเจ็กต์นี้มีข้อมูลเกี่ยวกับโฆษณาที่โหลด นอกเหนือจากข้อมูลเกี่ยวกับ Waterfall ของสื่อกลางที่ใช้โหลดโฆษณา

ในกรณีที่โฆษณาโหลดสำเร็จ ออบเจ็กต์โฆษณาจะมีเมธอด GetResponseInfo() เช่น InterstitialAd.GetResponseInfo() จะได้รับข้อมูลการตอบกลับสำหรับโฆษณาคั่นระหว่างหน้าที่โหลด

สำหรับกรณีที่โฆษณาโหลดไม่สำเร็จและมีข้อผิดพลาดเพียงอย่างเดียว คุณสามารถดูข้อมูลการตอบกลับได้ผ่านทาง AdFailedToLoadEventArgs.LoadAdError.GetResponseInfo()

InterstitialAd ad;

private void RequestInterstitial()
{
    ad = new InterstitialAd("AD_UNIT_ID");
    this.interstitial.OnAdLoaded += OnAdLoaded;
    this.interstitial.OnAdFailedToLoad += HandleOnAdFailedToLoad;
    AdRequest request = new AdRequest.Builder().Build();
    this.interstitial.LoadAd(request);
}

private void OnAdLoaded(object sender, EventArgs args)
{
    ResponseInfo info = ad.GetResponseInfo();
}

private void OnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    ResponseInfo info = args.LoadAdError.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 ที่มีข้อมูลเมตาสำหรับอะแดปเตอร์แต่ละตัวที่รวมอยู่ในการตอบกลับโฆษณา ใช้เพื่อแก้ไขข้อบกพร่องของสื่อกลาง Waterfall และการดำเนินการเสนอราคาได้ ลำดับของรายการตรงกับลำดับการแสดงโฆษณาสื่อกลางตามลำดับขั้นสำหรับคำขอโฆษณานี้ ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลการตอบกลับอะแดปเตอร์
GetLoadedAdapterResponseInfo	แสดง AdapterResponseInfo ที่สอดคล้องกับอะแดปเตอร์ที่โหลดโฆษณา
GetMediationAdapterClassName	แสดงชื่อคลาสอะแดปเตอร์สื่อกลางของเครือข่ายโฆษณาที่โหลดโฆษณา
GetResponseId	ตัวระบุการตอบกลับเป็นตัวระบุที่ไม่ซ้ำกันสําหรับการตอบกลับโฆษณา คุณใช้ตัวระบุนี้เพื่อระบุและบล็อกโฆษณาในศูนย์ตรวจสอบโฆษณา (ARC) ได้
GetResponseExtras	เบต้า: API นี้อยู่ในเวอร์ชันเบต้า ค่าที่ส่งคืนอาจเปลี่ยนแปลงได้โดยไม่ต้องมีรุ่น SDK แสดงข้อมูลเพิ่มเติมเกี่ยวกับการตอบกลับของโฆษณา ส่วนเสริมอาจส่งคืนคีย์ต่อไปนี้ mediation_group_name: ชื่อกลุ่มสื่อกลาง mediation_ab_test_name: ชื่อของการทดสอบ A/B สำหรับสื่อกลาง (หากมี) mediation_ab_test_variant: ตัวแปรที่ใช้ในการทดสอบ A/B สำหรับสื่อกลาง (หากมี)

ต่อไปนี้คือตัวอย่างค่าการอ่านจาก ResponseInfo ที่โหลด

private void OnAdLoaded(object sender, EventArgs args)
{
  ResponseInfo info = ad.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 Mediation) และการดำเนินการเสนอราคาได้ ลำดับรายการตรงกับลำดับการแสดงโฆษณาสื่อกลางตามลำดับขั้นของคำขอโฆษณา

ต่อไปนี้เป็นตัวอย่างเอาต์พุตที่ 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	รับชุดการกำหนดค่าเครือข่ายจาก UI ของ AdMob
LatencyMillis	รับระยะเวลาที่เครือข่ายโฆษณาใช้ในการโหลดโฆษณา แสดงผล 0 หากยังไม่ได้พยายามดำเนินการเครือข่าย

ต่อไปนี้คือตัวอย่างค่าการอ่านจาก AdapterResponseInfo ที่โหลด

private void OnAdLoaded(object sender, EventArgs args)
{
  ResponseInfo responseInfo = ad.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;
}