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

เลือกแพลตฟอร์ม: Android (เบต้า) Android iOS Unity Flutter

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

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

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

Kotlin

override fun onAdLoaded(interstitialAd: InterstitialAd)) {
  val responseInfo = interstitialAd.responseInfo
  Log.d(TAG, responseInfo.toString())
}

override fun onAdFailedToLoad(adError: LoadAdError) {
  val responseInfo = adError.responseInfo
  Log.d(TAG, responseInfo.toString())
}

Java

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  ResponseInfo responseInfo = interstitialAd.getResponseInfo();
  Log.d(TAG, responseInfo.toString());
}

@Override
public void onAdFailedToLoad(LoadAdError loadAdError) {
  ResponseInfo responseInfo = loadAdError.getResponseInfo();
  Log.d(TAG, responseInfo.toString());
}

ข้อมูลการตอบกลับ

ต่อไปนี้เป็นเอาต์พุตตัวอย่างที่แสดงผลโดย ResponseInfo.toString() ซึ่งแสดงข้อมูลการแก้ไขข้อบกพร่องที่แสดงผลสำหรับโฆษณาที่โหลดแล้ว

{
  "Response ID": "NI3BZZDbGdyQtOUP4o21gAM",
  "Mediation Adapter Class Name": "com.google.ads.mediation.admob.AdMobAdapter",
  "Adapter Responses": [
    {
      "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
      "Latency": 3585,
      "Ad Source Name": "AdMob Network",
      "Ad Source ID": "",
      "Ad Source Instance Name": "AdMob (default)",
      "Ad Source Instance ID": "",
      "Credentials": {
        "pubid": "ca-pub-9939518381636264//21775744923/example/rewarded-interstitial/cak=no_cache&cadc=8e&caqid=NI3BZfDhGICQtOUP7ayS4Aw"
      },
      "Ad Error": "null"
    }
  ],
  "Loaded Adapter Response": {
    "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
    "Latency": 3585,
    "Ad Source Name": "AdMob Network",
    "Ad Source ID": "",
    "Ad Source Instance Name": "AdMob (default)",
    "Ad Source Instance ID": "",
    "Credentials": {
      "pubid": "ca-app-pub-3940256099942544\/9257395921\/cak=no_cache&cadc=8e&caqid=NI3BZfDhGICQtOUP7ayS4Aw"
    },
    "Ad Error": "null"
  },
  "Response Extras": {
    "creative_id": "138471856178",
    "line_item_id": "6707237225",
  }
}

เมธอดในออบเจ็กต์ ResponseInfo มีดังนี้

เมธอด	คำอธิบาย
getAdSourceResponses	แสดงรายการ AdSourceResponseInfo ที่มีข้อมูลเมตาสำหรับแหล่งที่มาของโฆษณาแต่ละแหล่งที่รวมอยู่ ในการตอบกลับของโฆษณา สามารถใช้เพื่อแก้ไขข้อบกพร่องของการแสดงโฆษณาสื่อกลางตามลำดับขั้น (Waterfall Mediation) และการดำเนินการเสนอราคา ลำดับของรายการจะตรงกับลำดับของสื่อกลาง ตามลำดับชั้นสำหรับคำขอโฆษณานี้ ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลการตอบกลับของแหล่งที่มาของโฆษณาสำหรับ ข้อมูลเพิ่มเติม
getLoadedAdSourceResponse	แสดง AdSourceResponseInfo ที่สอดคล้องกับแหล่งที่มาของโฆษณาที่โหลดโฆษณา
getAdapterClassName	แสดงชื่อคลาสของอะแดปเตอร์สื่อกลางของแหล่งที่มาของโฆษณาที่โหลดโฆษณา
getResponseId	ตัวระบุการตอบกลับเป็นตัวระบุที่ไม่ซ้ำกันสำหรับการตอบกลับของโฆษณา ตัวระบุนี้สามารถใช้เพื่อระบุและบล็อกโฆษณาใน ศูนย์ตรวจสอบโฆษณา (ARC)
getResponseExtras	แสดงข้อมูลเพิ่มเติมเกี่ยวกับการตอบกลับของโฆษณา ข้อมูลเพิ่มเติมอาจแสดงผล คีย์ต่อไปนี้: creative_id: รหัสครีเอทีฟโฆษณาของโฆษณาที่เลือก แสดงผล สำหรับโฆษณาแบบจองเท่านั้น line_item_id: รหัสสินค้าในรายการสั่งซื้อของโฆษณาที่เลือก แสดงผลสำหรับโฆษณาแบบจองเท่านั้น

Kotlin

override fun onAdLoaded(interstitialAd: InterstitialAd) {
  val responseInfo = interstitialAd.responseInfo

  val responseId = responseInfo.responseId
  val adapterClassName = responseInfo.adapterClassName
  val adSourceResponses = responseInfo.adSourceResponses
  val loadedAdSourceResponse = responseInfo.loadedAdSourceResponse
  val extras = responseInfo.responseExtras
  val creativeId = extras.getString("creative_id")
  val lineItemId = extras.getString("line_item_id")
}

Java

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  MyActivity.this.interstitialAd = interstitialAd;

  ResponseInfo responseInfo = interstitialAd.getResponseInfo();
  String responseId = responseInfo.getResponseId();
  String adapterClassName = responseInfo.getAdapterClassName();
  List<AdSourceResponseInfo> adSourceResponses = responseInfo.getAdSourceResponses();
  AdSourceResponseInfo loadedAdSourceResponse = responseInfo.getLoadedAdSourceResponse();
  Bundle extras = responseInfo.getResponseExtras();
  String creativeId = extras.getString("creative_id");
  String lineItemId = extras.getString("line_item_id");
}

ข้อมูลการตอบกลับของแหล่งที่มาของโฆษณา

AdSourceResponseInfo มีข้อมูลการตอบกลับสำหรับแหล่งที่มาของโฆษณาเดี่ยวแต่ละแหล่งในการตอบกลับของโฆษณา

เอาต์พุต AdSourceResponseInfo ตัวอย่างต่อไปนี้แสดงข้อมูลเมตาสำหรับโฆษณาที่โหลดแล้ว

{
  "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
  "Latency": 3585,
  "Ad Source Name": "AdMob Network",
  "Ad Source ID": "",
  "Ad Source Instance Name": "AdMob (default)",
  "Ad Source Instance ID": "",
  "Credentials": {
    "pubid": "ca-pub-9939518381636264//21775744923/example/rewarded-interstitial/cak=no_cache&cadc=8e&caqid=NI3BZfDhGICQtOUP7ayS4Aw"
  },
  "Ad Error": "null"
}

สำหรับแหล่งที่มาของโฆษณาแต่ละแหล่ง AdSourceResponseInfo จะมีเมธอดต่อไปนี้

เมธอด	คำอธิบาย
getAdError	รับข้อผิดพลาดที่เชื่อมโยงกับคำขอที่ส่งไปยังแหล่งที่มาของโฆษณา แสดงผล null หากแหล่งที่มาของโฆษณาโหลดโฆษณาได้สำเร็จหรือหากไม่ได้ลองใช้แหล่งที่มาของโฆษณา
getId	รับรหัสแหล่งที่มาของโฆษณาที่เชื่อมโยงกับการตอบกลับของแหล่งที่มาของโฆษณานี้
getInstanceId	รับรหัสอินสแตนซ์แหล่งที่มาของโฆษณาที่เชื่อมโยงกับการตอบกลับของอะแดปเตอร์นี้
getInstanceName	รับชื่ออินสแตนซ์แหล่งที่มาของโฆษณาที่เชื่อมโยงกับการตอบกลับของอะแดปเตอร์นี้
getName	รับชื่อแหล่งที่มาของโฆษณาที่เชื่อมโยงกับการตอบกลับของอะแดปเตอร์นี้
getAdapterClassName	รับชื่อคลาสของอะแดปเตอร์แหล่งที่มาของโฆษณาที่โหลดโฆษณา
getCredentials	รับข้อมูลเข้าสู่ระบบของอะแดปเตอร์แหล่งที่มาของโฆษณาที่ระบุไว้ใน UI ของ Ad Manager
getLatencyMillis	รับระยะเวลาที่อะแดปเตอร์แหล่งที่มาของโฆษณาใช้ในการโหลดโฆษณา แสดงผล 0 หากไม่ได้ลองใช้แหล่งที่มาของโฆษณา

Kotlin

override fun onAdLoaded(interstitialAd: InterstitialAds) {
  val loadedAdSourceResponseInfo = interstitialAd.responseInfo.loadedAdSourceResponse

  val adError = loadedAdSourceResponseInfo.adError
  val adSourceId = loadedAdSourceResponseInfo.id
  val adSourceInstanceId = loadedAdSourceResponseInfo.instanceId
  val adSourceInstanceName = loadedAdSourceResponseInfo.instanceName
  val adSourceName = loadedAdSourceResponseInfo.name
  val adapterClassName = loadedAdSourceResponseInfo.adapterClassName
  val credentials = loadedAdSourceResponseInfo.credentials
  val latencyMillis = loadedAdSourceResponseInfo.latencyMillis
}

Java

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  AdSourceResponseInfo loadedAdSourceResponseInfo =
      interstitialAd.getResponseInfo().getLoadedAdSourceResponse();

  AdError adError = loadedAdSourceResponseInfo.getAdError();
  String adSourceId = loadedAdSourceResponseInfo.getId();
  String adSourceInstanceId = loadedAdSourceResponseInfo.getInstanceId();
  String adSourceInstanceName = loadedAdSourceResponseInfo.getInstanceName();
  String adSourceName = loadedAdSourceResponseInfo.getName();
  String adapterClassName = loadedAdSourceResponseInfo.getAdapterClassName();
  Bundle credentials = loadedAdSourceResponseInfo.getCredentials();
  long latencyMillis = loadedAdSourceResponseInfo.getLatencyMillis();
}