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

اختيار النظام الأساسي: 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 ما يلي:

الطريقة	الوصف
getAdapterResponses	تعرض هذه الطريقة قائمة AdapterResponseInfo التي تحتوي على البيانات الوصفية لكل وسيط مدرَج في ردّ الإعلان. يمكن استخدامها لتصحيح أخطاء التوسّط المستند إلى العرض بدون انقطاع وتنفيذ عروض الأسعار. يتطابق ترتيب القائمة مع ترتيب تدفّق التوسّط لطلب الإعلان هذا. راجِع معلومات ردّ وسيط الإعلانات للحصول على مزيد من المعلومات.
getLoadedAdapterResponseInfo	تعرِض هذه السمة AdapterResponseInfo المناظر للمحوّل الذي حمّل الإعلان.
getMediationAdapterClassName	تعرِض هذه السمة اسم فئة وسيط التوسّط لمصدر الإعلان الذي حمّل الإعلان.
getResponseId	معرّف الاستجابة هو معرّف فريد لاستجابة الإعلان. يمكن استخدام هذا المعرّف لتحديد الإعلان وحظره في مركز مراجعة الإعلانات.
getResponseExtras	تعرض هذه السمة معلومات إضافية عن استجابة الإعلان. قد تعرض الخدمات الإضافية المفاتيح التالية: creative_id: رقم تعريف تصميم الإعلان المحدّد يتم عرض هذه السمة للإعلانات المحجوزة فقط. line_item_id: رقم تعريف عنصر الإعلان المحدّد. يتم عرض هذه السمة للإعلانات المحجوزة فقط.

Kotlin

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

  val responseId = responseInfo.responseId
  val mediationAdapterClassName = responseInfo.mediationAdapterClassName
  val adapterResponses = responseInfo.adapterResponses
  val loadedAdapterResponseInfo = responseInfo.loadedAdapterResponseInfo
  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 mediationAdapterClassName = responseInfo.getMediationAdapterClassName();
  List<AdapterResponseInfo> adapterResponses = responseInfo.getAdapterResponses();
  AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.getLoadedAdapterResponseInfo();
  Bundle extras = responseInfo.getResponseExtras();
  String creativeId = extras.getString("creative_id");
  String lineItemId = extras.getString("line_item_id");
}

معلومات استجابة المحوّل

يحتوي AdapterResponseInfo على معلومات الردّ لمصدر إعلان فردي في استجابة الإعلان.

يعرض نموذج إخراج AdapterResponseInfo التالي البيانات الوصفية لإعلان تم تحميله:

{
  "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"
}

بالنسبة إلى كل مصدر إعلان، يوفّر AdapterResponseInfo الطرق التالية:

الطريقة	الوصف
getAdError	تعرض هذه السمة الخطأ المرتبط بطلب مصدر الإعلان. تعرِض هذه السمة القيمة null إذا حمّل مصدر الإعلان إعلانًا بنجاح أو إذا لم تتم محاولة تحميل مصدر الإعلان.
getAdSourceId	تعرض هذه الطريقة معرّف مصدر الإعلان المرتبط باستجابة المحوّل هذه.
getAdSourceInstanceId	تعرض هذه السمة رقم تعريف مثيل مصدر الإعلان المرتبط بردّ المحوّل هذا.
getAdSourceInstanceName	تعرض هذه الطريقة اسم مثيل مصدر الإعلان المرتبط باستجابة المحوّل هذه.
getAdSourceName	تعرض هذه الطريقة اسم مصدر الإعلان المرتبط باستجابة برنامج التكييف هذا.
getAdapterClassName	تعرض هذه السمة اسم فئة محوّل مصدر الإعلان الذي حمّل الإعلان.
getCredentials	تعرض هذه الطريقة بيانات اعتماد أداة ربط مصدر الإعلان المحدّدة في واجهة مستخدم "مدير الإعلانات".
getLatencyMillis	تعرض هذه السمة مقدار الوقت الذي استغرقه محوّل مصدر الإعلان في تحميل إعلان. تعرِض القيمة 0 إذا لم تتم محاولة استخدام مصدر الإعلان.

Kotlin

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

  val adError = loadedAdapterResponseInfo.adError
  val adSourceId = loadedAdapterResponseInfo.adSourceId
  val adSourceInstanceId = loadedAdapterResponseInfo.adSourceInstanceId
  val adSourceInstanceName = loadedAdapterResponseInfo.adSourceInstanceName
  val adSourceName = loadedAdapterResponseInfo.adSourceName
  val adapterClassName = loadedAdapterResponseInfo.adapterClassName
  val credentials = loadedAdapterResponseInfo.credentials
  val latencyMillis = loadedAdapterResponseInfo.latencyMillis
}

Java

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  AdapterResponseInfo loadedAdapterResponseInfo =
      interstitialAd.getResponseInfo().getLoadedAdapterResponseInfo();

  AdError adError = loadedAdapterResponseInfo.getAdError();
  String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
  String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();
  String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
  String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
  String adapterClassName = loadedAdapterResponseInfo.getAdapterClassName();
  Bundle credentials = loadedAdapterResponseInfo.getCredentials();
  long latencyMillis = loadedAdapterResponseInfo.getLatencyMillis();
}