استرداد المعلومات المتعلقة باستجابة الإعلان

لأغراض تصحيح الأخطاء وتسجيلها، تقدّم الإعلانات التي تم تحميلها بنجاح عنصر 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 التي تحتوي على البيانات الوصفية لكل مصدر إعلان مضمّن في استجابة الإعلان. يمكن استخدامها لتصحيح أخطاء التوسّط المستند إلى العرض بدون انقطاع وتنفيذ عروض الأسعار. يتطابق ترتيب القائمة مع ترتيب تدفّق التوسّط لطلب عرض الإعلان هذا. راجِع معلومات استجابة مصدر الإعلان للحصول على مزيد من المعلومات.
getLoadedAdSourceResponse	تعرِض هذه السمة AdSourceResponseInfo المطابق لمصدر الإعلان الذي حمّل الإعلان.
getAdapterClassName	تعرِض هذه السمة اسم فئة وسيط التوسّط لمصدر الإعلان الذي حمّل الإعلان.
getResponseId	معرّف الاستجابة هو معرّف فريد لاستجابة الإعلان. يمكن استخدام هذا المعرّف لتحديد الإعلان وحظره في مركز مراجعة الإعلانات.
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	تعرض هذه الطريقة بيانات اعتماد أداة ربط مصدر الإعلان المحدّدة في واجهة مستخدم "مدير الإعلانات".
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();
}