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

لأغراض تصحيح الأخطاء والتسجيل، توفّر الإعلانات التي تم تحميلها بنجاح عنصر ResponseInfo. يحتوي هذا العنصر على معلومات عن الإعلان الذي حمَّله، بالإضافة إلى معلومات عن تدفق التوسّط المستخدَم في تحميل الإعلان.

بالنسبة إلى الحالات التي يتمّ فيها تحميل الإعلان بنجاح، يحتوي عنصر الإعلان على طريقة GetResponseInfo(). على سبيل المثال، يحصل InterstitialAd.GetResponseInfo() على معلومات الاستجابة لإعلان بيني تم تحميله.

بالنسبة إلى الحالات التي يتعذّر فيها تحميل الإعلانات ولا يظهر سوى خطأ فقط، تتوفّر معلومات الاستجابة من خلال AdFailedToLoadEventArgs.LoadAdError.GetResponseInfo().

InterstitialAd ad;

private void RequestInterstitial()
{
    ad = new InterstitialAd("AD_UNIT_ID");
    this.interstitial.OnAdLoaded += OnAdLoaded;
    this.interstitial.OnAdFailedToLoad += HandleOnAdFailedToLoad;
    AdRequest request = new AdRequest.Builder().Build();
    this.interstitial.LoadAd(request);
}

private void OnAdLoaded(object sender, EventArgs args)
{
    ResponseInfo info = ad.GetResponseInfo();
}

private void OnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    ResponseInfo info = args.LoadAdError.GetResponseInfo();
}

معلومات الردّ

في ما يلي نموذج ناتج عن عرض "ResponseInfo.ToString()" يوضّح بيانات تصحيح الأخطاء المعروضة لإعلان تم تحميله:

Android

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

iOS

 ** Response Info **
    Response ID: CIzs0ZO5kPoCFRqWAAAdJMINpQ
    Network: GADMAdapterGoogleAdMobAds

  ** Loaded Adapter Response **
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name: Reservation campaign
    Ad Source ID: 7068401028668408324
    Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
    Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
    AdUnitMapping:
    {
    }
    Error: (null)
    Latency: 0.391

  ** Extras Dictionary **
    {
        "mediation_group_name" = Campaign;
    }

  ** Mediation line items **
    Entry (1)
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name: Reservation campaign
    Ad Source ID:7068401028668408324
    Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
    Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
    AdUnitMapping:
    {
    }
    Error: (null)
    Latency: 0.391

تتضمّن الطرق المتعلّقة بالكائن ResponseInfo ما يلي:

الطريقة	الوصف
GetAdapterResponses	عرض قائمة AdapterResponseInfo التي تحتوي على البيانات الوصفية لكل محوّل مضمَّن في استجابة الإعلان. ويمكن استخدامها لتصحيح أخطاء توسّط العرض الإعلاني بدون انقطاع وتنفيذ عروض الأسعار. يتطابق ترتيب القائمة مع ترتيب تدفق التوسّط لطلب الإعلان هذا. يمكنك الاطّلاع على معلومات استجابة المحوِّل لمزيد من المعلومات.
GetLoadedAdapterResponseInfo	تعرض AdapterResponseInfo المقابل للمحوّل الذي حمَّل الإعلان.
GetMediationAdapterClassName	يتم عرض اسم فئة محوّل التوسّط لشبكة الإعلانات التي حمّلت الإعلان.
GetResponseId	معرّف الاستجابة هو معرّف فريد لاستجابة الإعلان. ويمكن استخدام هذا المعرّف لتحديد الإعلان وحظره في مركز مراجعة الإعلانات (ARC).
GetResponseExtras	إصدار تجريبي: تتوفّر واجهة برمجة التطبيقات هذه كإصدار تجريبي. ويمكن أن تتغيّر القيم المعروضة بدون إصدار حزمة تطوير البرامج (SDK). عرض معلومات إضافية عن استجابة الإعلان. ويمكن أن تعرض الإعدادات الإضافية المفاتيح التالية: mediation_group_name: اسم مجموعة التوسط mediation_ab_test_name: اسم اختبار أ/ب للتوسّط، إذا كان ذلك منطبقًا mediation_ab_test_variant: الصيغة المستخدمة في اختبار أ/ب للتوسّط، إذا كان ذلك منطبقًا

في ما يلي نموذج لقيم قراءة من ResponseInfo تم تحميله:

private void OnAdLoaded(object sender, EventArgs args)
{
  ResponseInfo info = ad.GetResponseInfo();

  string responseId = responseInfo.GetResponseId();
  string mediationAdapterClassName = responseInfo.GetMediationAdapterClassName();
  List<AdapterResponseInfo> adapterResponses = responseInfo.GetAdapterResponses();
  AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
  Dictionary<string, string> extras = responseInfo.GetResponseExtras();
  string mediationGroupName = extras["mediation_group_name"];
  string mediationABTestName = extras["mediation_ab_test_name"];
  string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

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

يحتوي AdapterResponseInfo على بيانات وصفية لكل محوِّل مضمّن في استجابة الإعلان، والتي يمكن استخدامها لتصحيح أخطاء توسط العرض الإعلاني بدون انقطاع وتنفيذ عروض الأسعار. يتطابق ترتيب القائمة مع ترتيب تدفق التوسط لطلب الإعلان.

في ما يلي نموذج للمخرجات من خلال "AdapterResponseInfo":

Android

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

iOS

  Network: GADMAdapterGoogleAdMobAds
  Ad Source Name: Reservation campaign
  Ad Source ID: 7068401028668408324
  Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
  Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
  AdUnitMapping:
  {
  }
  Error: (null)
  Latency: 0.391

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

الطريقة	الوصف
AdError	يحصل على الخطأ المرتبط بالطلب إلى الشبكة. عرض null إذا كانت الشبكة قد حمَّلت إعلانًا بنجاح أو إذا لم تتم محاولة استخدام الشبكة.
AdSourceId	للحصول على رقم تعريف مصدر الإعلان المرتبط باستجابة المحوّل هذه. بالنسبة إلى الحملات، يتم عرض 6060308706800320801 لنوع هدف الحملة من الإعلانات التي تعتمد على التوسّط، بينما يتم عرض 7068401028668408324 لأنواع أهداف مرّات الظهور والنقرات. راجِع مصادر الإعلانات للحصول على قائمة بأرقام تعريف مصادر الإعلانات المحتملة عندما تعرِض شبكة إعلانات عليها.
AdSourceInstanceId	للحصول على رقم تعريف مثيل مصدر الإعلان المرتبط باستجابة المحوّل هذه.
AdSourceInstanceName	للحصول على اسم مثيل مصدر الإعلان المرتبط باستجابة المحوّل هذه.
AdSourceName	الحصول على مصدر الإعلان الذي يمثّل شبكة المواقع الإعلانية المحدّدة التي تعرِض مرة الظهور. بالنسبة إلى الحملات، يتم عرض Mediated House Ads لنوع هدف الحملة من الإعلانات التي تعتمد على التوسّط، بينما يتم عرض Reservation Campaign لأنواع أهداف مرّات الظهور والنقرات. اطّلِع على مصادر الإعلانات للحصول على قائمة بأسماء مصادر الإعلانات المحتملة عندما تعرض شبكة إعلانات الإعلان.
AdapterClassName	تحصل على اسم فئة يحدِّد شبكة الإعلانات.
AdUnitMapping	للحصول على مجموعة إعدادات الشبكة من واجهة مستخدم Admob
LatencyMillis	الحصول على مقدار الوقت الذي استغرقته شبكة الإعلانات في تحميل الإعلان تعرض القيمة 0 إذا لم تتم محاولة الاتصال بالشبكة.

في ما يلي نموذج لقيم قراءة من AdapterResponseInfo تم تحميله:

private void OnAdLoaded(object sender, EventArgs args)
{
  ResponseInfo responseInfo = ad.GetResponseInfo();
  AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.getLoadedAdapterResponseInfo();

  AdError adError = loadedAdapterResponseInfo.AdError;
  string adSourceId = loadedAdapterResponseInfo.AdSourceId;
  string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
  string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
  string adSourceName = loadedAdapterResponseInfo.AdSourceName;
  string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
  Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;
  long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
}