اطلاعات مربوط به پاسخ آگهی را بازیابی کنید

برای اشکال‌زدایی و ثبت وقایع، تبلیغاتی که با موفقیت بارگذاری می‌شوند، یک شیء ResponseInfo ارائه می‌دهند. این شیء علاوه بر اطلاعاتی در مورد تبلیغی که بارگذاری شده است، شامل اطلاعاتی در مورد آبشار میانجیگری مورد استفاده برای بارگذاری تبلیغ نیز می‌شود.

برای مواردی که یک تبلیغ با موفقیت بارگذاری می‌شود، شیء تبلیغ دارای یک متد getResponseInfo() است. برای مثال، InterstitialAd.getResponseInfo() اطلاعات پاسخ را برای یک تبلیغ بینابینی بارگذاری شده دریافت می‌کند.

برای مواردی که تبلیغات بارگذاری نمی‌شوند و فقط یک خطا موجود است، اطلاعات پاسخ از طریق LoadAdError.getResponseInfo() قابل دسترسی است.

کاتلین

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())
}

جاوا

@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	شناسه پاسخ، یک شناسه منحصر به فرد برای پاسخ تبلیغ است. از این شناسه می‌توان برای شناسایی و مسدود کردن تبلیغ در مرکز بررسی تبلیغات (ARC) استفاده کرد.
getResponseExtras	اطلاعات اضافی در مورد پاسخ تبلیغ را برمی‌گرداند. موارد اضافی ممکن است کلیدهای زیر را برگردانند: mediation_group_name : نام گروه میانجی mediation_ab_test_name : نام تست A/B میانجیگری ، در صورت وجود mediation_ab_test_variant : در صورت وجود، گونه‌ای که در تست A/B میانجی‌گری استفاده می‌شود

کاتلین

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

جاوا

@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 برای انواع هدف نمایش و کلیک بازگردانده می‌شود. برای فهرست نام‌های منبع تبلیغاتی ممکن، زمانی که یک منبع تبلیغاتی، تبلیغ را ارائه می‌دهد، به Ad sources مراجعه کنید.
getAdapterClassName	نام کلاس آداپتور منبع تبلیغاتی که تبلیغ را بارگذاری کرده است، برمی‌گرداند.
getCredentials	اعتبارنامه‌های آداپتور منبع تبلیغ مشخص‌شده در رابط کاربری AdMob را دریافت می‌کند.
getLatencyMillis	مقدار زمانی که آداپتور منبع تبلیغ صرف بارگذاری یک تبلیغ کرده است را برمی‌گرداند. اگر منبع تبلیغ امتحان نشده باشد، مقدار 0 را برمی‌گرداند.

کاتلین

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
}

جاوا

@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();
}