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

لأغراض تصحيح الأخطاء وتسجيلها، تقدّم الإعلانات التي تم تحميلها بنجاح عنصر 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": "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"
  }
}

تشمل الطرق المتوفّرة في العنصر ResponseInfo ما يلي:

الطريقة	الوصف
getAdSourceResponses	تعرض هذه السمة قائمة AdSourceResponseInfo التي تحتوي على البيانات الوصفية لكل مصدر إعلان مضمّن في استجابة الإعلان. يمكن استخدامها لتصحيح أخطاء التوسّط المستند إلى العرض بدون انقطاع وتنفيذ عروض الأسعار. يتطابق ترتيب القائمة مع ترتيب تدفّق التوسّط لطلب عرض الإعلان هذا. راجِع معلومات استجابة مصدر الإعلان للحصول على مزيد من المعلومات.
getLoadedAdSourceResponse	تعرِض هذه السمة AdSourceResponseInfo المطابق لمصدر الإعلان الذي حمّل الإعلان.
getAdapterClassName	تعرِض هذه السمة اسم فئة وسيط التوسّط لمصدر الإعلان الذي حمّل الإعلان.
getResponseId	معرّف الاستجابة هو معرّف فريد لاستجابة الإعلان. يمكن استخدام هذا المعرّف لتحديد الإعلان وحظره في مركز مراجعة الإعلانات.
getResponseExtras	تعرض هذه السمة معلومات إضافية عن استجابة الإعلان. قد تعرض الخدمات الإضافية المفاتيح التالية: mediation_group_name: اسم مجموعة التوسّط mediation_ab_test_name: اسم اختبار A/B للتوسّط، إذا كان ذلك منطبقًا mediation_ab_test_variant: الصيغة المستخدَمة في اختبار أ/ب للتوسّط، إذا كان ذلك منطبقًا

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 mediationGroupName = extras.getString("mediation_group_name")
  val mediationABTestName = extras.getString("mediation_ab_test_name")
  val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
}

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 mediationGroupName = extras.getString("mediation_group_name");
  String mediationABTestName = extras.getString("mediation_ab_test_name");
  String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
}

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

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

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

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

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

الطريقة	الوصف
getAdError	تعرض هذه السمة الخطأ المرتبط بطلب مصدر الإعلان. تعرِض هذه السمة القيمة null إذا حمّل مصدر الإعلان إعلانًا بنجاح أو إذا لم تتم محاولة تحميل مصدر الإعلان.
getId	تعرض هذه السمة رقم تعريف مصدر الإعلان المرتبط باستجابة مصدر الإعلان هذه. بالنسبة إلى الحملات، يتم عرض 6060308706800320801 لنوع هدف الحملة الإعلانات المعتمدة على التوسّط، ويتم عرض 7068401028668408324 لأنواع الأهداف من حيث الظهور والنقر. اطّلِع على مصادر الإعلانات للاطّلاع على قائمة بمعرّفات مصادر الإعلانات المحتملة عندما يعرض مصدر إعلان الإعلان.
getInstanceId	تعرض هذه السمة رقم تعريف مثيل مصدر الإعلان المرتبط بردّ المحوّل هذا.
getInstanceName	تعرض هذه السمة اسم مثيل مصدر الإعلان المرتبط باستجابة المحوّل هذه.
getName	تعرض هذه الطريقة اسم مصدر الإعلان المرتبط باستجابة برنامج التكييف هذا. بالنسبة إلى الحملات، يتم عرض Mediated House Ads لنوع هدف الحملة الإعلانات المعتمدة على التوسّط، ويتم عرض Reservation Campaign لنوعَي الهدف الظهور والنقرات. راجِع مصادر الإعلانات للاطّلاع على قائمة بأسماء مصادر الإعلانات المحتملة عندما يعرض مصدر إعلان الإعلان.
getAdapterClassName	تعرض هذه السمة اسم فئة محوّل مصدر الإعلان الذي حمّل الإعلان.
getCredentials	تعرض هذه الطريقة بيانات اعتماد محوّل مصدر الإعلان المحدّدة في واجهة مستخدم AdMob.
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();
}