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

پلتفرم مورد نظر: اندروید، iOS، یونیتی ، فلاتر

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

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

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

کاتلین 

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

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

جاوا 

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

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

اطلاعات پاسخ

در اینجا نمونه خروجی برگردانده شده توسط 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 شامل موارد زیر هستند:

روش توضیحات
getAdapterResponses فهرست AdapterResponseInfo را که شامل فراداده برای هر آداپتور موجود در پاسخ تبلیغ است، برمی‌گرداند. می‌تواند برای اشکال‌زدایی میانجی‌گری آبشاری و اجرای پیشنهاد قیمت استفاده شود. ترتیب لیست با ترتیب میانجی‌گری آبشاری برای این درخواست تبلیغ مطابقت دارد.

برای اطلاعات بیشتر به اطلاعات پاسخ آداپتور مراجعه کنید.

getLoadedAdapterResponseInfo AdapterResponseInfo مربوط به آداپتوری که تبلیغ را بارگذاری کرده است را برمی‌گرداند.
getMediationAdapterClassName نام کلاس آداپتور میانجیگری منبع تبلیغاتی که تبلیغ را بارگذاری کرده است، برمی‌گرداند.
getResponseId شناسه پاسخ، یک شناسه منحصر به فرد برای پاسخ تبلیغ است. از این شناسه می‌توان برای شناسایی و مسدود کردن تبلیغ در مرکز بررسی تبلیغات (ARC) استفاده کرد.
getResponseExtras اطلاعات اضافی در مورد پاسخ تبلیغ را برمی‌گرداند. موارد اضافی ممکن است کلیدهای زیر را برگردانند:
  • mediation_group_name : نام گروه میانجی
  • mediation_ab_test_name : نام تست A/B میانجیگری ، در صورت وجود
  • mediation_ab_test_variant : در صورت وجود، گونه‌ای که در تست A/B میانجی‌گری استفاده می‌شود

کاتلین 

override fun onAdLoaded() {
  val responseInfo = adView.responseInfo

  val responseId = responseInfo?.responseId
  val mediationAdapterClassName = responseInfo?.mediationAdapterClassName
  val adapterResponses = responseInfo?.adapterResponses
  val loadedAdapterResponseInfo = responseInfo?.loadedAdapterResponseInfo
  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")
}
ResponseInfoSnippets.kt

جاوا 

@Override
public void onAdLoaded() {
  ResponseInfo responseInfo = adView.getResponseInfo();

  String responseId = responseInfo.getResponseId();
  String mediationAdapterClassName = responseInfo.getMediationAdapterClassName();
  List<AdapterResponseInfo> adapterResponses = responseInfo.getAdapterResponses();
  AdapterResponseInfo loadedAdapterResponseInfo =
      responseInfo.getLoadedAdapterResponseInfo();
  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");
}
ResponseInfoSnippets.java

اطلاعات پاسخ آداپتور

AdapterResponseInfo حاوی اطلاعات پاسخ برای یک منبع تبلیغاتی خاص در یک پاسخ تبلیغاتی است.

نمونه خروجی AdapterResponseInfo زیر، متادیتای یک تبلیغ بارگذاری شده را نشان می‌دهد:

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

برای هر منبع تبلیغ، AdapterResponseInfo متدهای زیر را ارائه می‌دهد:

روش توضیحات
getAdError خطای مرتبط با درخواست به منبع تبلیغ را دریافت می‌کند. اگر منبع تبلیغ با موفقیت یک تبلیغ را بارگذاری کند یا اگر تلاشی برای بارگذاری منبع تبلیغ انجام نشده باشد، null را برمی‌گرداند.
getAdSourceId شناسه منبع تبلیغ مرتبط با این پاسخ آداپتور را دریافت می‌کند. برای کمپین‌ها، 6060308706800320801 برای نوع هدف کمپین تبلیغات واسطه‌ای و 7068401028668408324 برای انواع هدف نمایش و کلیک بازگردانده می‌شود. برای فهرست شناسه‌های منبع تبلیغ ممکن، زمانی که یک منبع تبلیغ، تبلیغ را ارائه می‌دهد، به منابع تبلیغ مراجعه کنید.
getAdSourceInstanceId شناسه نمونه منبع تبلیغ مرتبط با این پاسخ آداپتور را دریافت می‌کند.
getAdSourceInstanceName نام نمونه منبع تبلیغ مرتبط با این پاسخ آداپتور را دریافت می‌کند.
getAdSourceName نام منبع تبلیغاتی مرتبط با این پاسخ آداپتور را دریافت می‌کند. برای کمپین‌ها، Mediated House Ads برای نوع هدف کمپین تبلیغات واسطه‌ای و Reservation Campaign برای انواع هدف نمایش و کلیک بازگردانده می‌شود. برای فهرست نام‌های منبع تبلیغاتی ممکن، زمانی که یک منبع تبلیغاتی، تبلیغ را ارائه می‌دهد، به Ad sources مراجعه کنید.
getAdapterClassName نام کلاس آداپتور منبع تبلیغاتی که تبلیغ را بارگذاری کرده است، برمی‌گرداند.
getCredentials اعتبارنامه‌های آداپتور منبع تبلیغ مشخص‌شده در رابط کاربری AdMob را دریافت می‌کند.
getLatencyMillis مقدار زمانی که آداپتور منبع تبلیغ صرف بارگذاری یک تبلیغ کرده است را برمی‌گرداند. اگر منبع تبلیغ امتحان نشده باشد، مقدار 0 را برمی‌گرداند.

کاتلین 

override fun onAdLoaded() {
  val loadedAdapterResponseInfo = adView.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
}
ResponseInfoSnippets.kt

جاوا 

@Override
public void onAdLoaded() {
  AdapterResponseInfo loadedAdapterResponseInfo =
      adView.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();
}
ResponseInfoSnippets.java