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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

في الحالات التي يتم فيها تحميل الإعلان بنجاح، يحتوي عنصر الإعلان على السمة GADResponseInfo. على سبيل المثال، GADInterstitialAd.responseInfo يحصل على معلومات الاستجابة لإعلان بيني تم تحميله.

في الحالات التي يتعذّر فيها تحميل الإعلانات ولا يتوفّر سوى خطأ، يتوفّر GADResponseInfo باستخدام المفتاح GADErrorUserInfoKeyResponseInfo في قاموس userInfo الخاص بالخطأ.

Swift

fileprivate func loadInterstitial() {
  InterstitialAd.load(
    with: "ca-app-pub-3940256099942544/4411468910", request: request
  ) { (ad, error) in
    if let error = error {
      let responseInfo = (error as NSError).userInfo[GADErrorUserInfoKeyResponseInfo] as? ResponseInfo
      print("\(String(describing: responseInfo))")
      return
    }
    let responseInfo = ad?.responseInfo
    print("\(String(describing: responseInfo))")
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"ca-app-pub-3940256099942544/4411468910"
   request:request
   completionHandler:^(GADInterstitialAd *ad, NSError *error) {
    if (error) {
      GADResponseInfo *responseInfo = error.userInfo[GADErrorUserInfoKeyResponseInfo];
      NSLog(@"%@", responseInfo.description);
      return;
    }
    GADResponseInfo *responseInfo = ad.responseInfo;
    NSLog(@"%@", responseInfo.description);
  }];
}

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

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

  ** Response Info **
    Response ID: CLz5r-KMtfoCFQvv7QodfGAMHw
    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.357

  ** 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.357

تشمل المواقع على GADResponseInfo ما يلي:

الموقع	الوصف
adNetworkInfoArray	تعرض قائمة GADAdNetworkResponseInfo التي تحتوي على بيانات وصفية لكل محوّل مضمّن في استجابة الإعلان. ويمكن استخدامها لتصحيح أخطاء تنفيذ عروض الأسعار والتوسّط للعرض الإعلاني بدون انقطاع. يتطابق ترتيب القائمة مع ترتيب تدفق التوسط لطلب عرض الإعلان هذا. لمزيد من المعلومات، يُرجى الاطّلاع على معلومات استجابة المحوِّل.
loadedAdNetworkResponseInfo	يعرض GADAdNetworkResponseInfo المقابل للمحوّل الذي حمّل الإعلان.
adNetworkClassName	تعرض اسم فئة محوّل التوسّط لشبكة الإعلانات التي حمّلت الإعلان.
responseIdentifier	معرّف الاستجابة هو معرّف فريد لاستجابة الإعلان. يمكن استخدام هذا المعرّف لتحديد الإعلان وحظره في مركز مراجعة الإعلانات.
extrasDictionary	إصدار تجريبي: تتوفّر واجهة برمجة التطبيقات هذه كإصدار تجريبي. ويمكن أن تتغيّر القيم المعروضة بدون إصدار حزمة تطوير برامج (SDK). تعرض هذه الدالة معلومات إضافية عن استجابة الإعلان. قد تعرض الإضافات المفاتيح التالية: ‫mediation_group_name: اسم مجموعة التوسّط ‫mediation_ab_test_name: اسم اختبار A/B للتوسّط، إن توفّر mediation_ab_test_variant: الصيغة المستخدَمة في اختبار A/B للتوسّط، إن وُجدت

Swift

fileprivate func loadInterstitial() {
  InterstitialAd.load(
    with: "ca-app-pub-3940256099942544/4411468910", request: request
  ) { (ad, error) in
    let responseInfo = ad?.responseInfo

    let responseIdentifier = responseInfo?.responseIdentifier
    let adNetworkClassName = responseInfo?.adNetworkClassName
    let adNetworkInfoArray = responseInfo?.adNetworkInfoArray
    let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo
    let mediationGroupName = responseInfo?.extrasDictionary["mediation_group_name"]
    let mediationABTestName = responseInfo?.extrasDictionary["mediation_ab_test_name"]
    let mediationABTestVariant = responseInfo?.extrasDictionary["mediation_ab_test_variant"]
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"ca-app-pub-3940256099942544/4411468910"
   request:request
   completionHandler:^(GADInterstitialAd *ad, NSError *error) {
    GADResponseInfo *responseInfo = ad.responseInfo;

    NSString *responseIdentifier = responseInfo.responseIdentifier;
    NSString *adNetworkClassName = responseInfo.adNetworkClassName;
    NSArray *adNetworkInfoArray = responseInfo.adNetworkInfoArray;
    GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo = responseInfo.loadedAdNetworkResponseInfo;
    NSString *mediationGroupName = responseInfo.extrasDictionary[@"mediation_group_name"];
    NSString *mediationABTestName = responseInfo.extrasDictionary[@"mediation_ab_test_name"];
    NSString *mediationABTestVariant = responseInfo.extrasDictionary[@"mediation_ab_test_variant"];
  }];
}

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

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

في ما يلي نموذج لنتيجة GADAdNetworkResponseInfo:

    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.277

بالنسبة إلى كل شبكة إعلانية، يوفّر GADAdNetworkResponseInfo السمات التالية:

الموقع	الوصف
error	الخطأ المرتبط بالطلب المرسَل إلى الشبكة يتم عرض القيمة nil إذا حمّلت الشبكة إعلانًا بنجاح أو إذا لم تتم محاولة استخدام الشبكة.
adSourceId	رقم تعريف مصدر الإعلان المرتبط باستجابة المحوِّل هذا. بالنسبة إلى الحملات، يتم عرض 6060308706800320801 لنوع هدف الحملة "الإعلانات المعتمدة على التوسّط"، ويتم عرض 7068401028668408324 لنوعَي الهدف "مرات الظهور" و"النقرات". يمكنك الاطّلاع على مصادر الإعلانات للحصول على قائمة بأرقام تعريف مصادر الإعلانات المحتملة عندما تعرض شبكة إعلانات الإعلان.
adSourceInstanceId	رقم تعريف مثيل مصدر الإعلان المرتبط باستجابة المحوّل هذا.
adSourceInstanceName	اسم مثيل مصدر الإعلان المرتبط باستجابة المحوّل هذا.
adSourceName	مصدر الإعلان الذي يمثّل شبكة الإعلانات المحدّدة التي تعرض مرّة الظهور بالنسبة إلى الحملات، يتم عرض Mediated House Ads لنوع هدف الحملة "الإعلانات المعتمدة على التوسّط"، ويتم عرض Reservation Campaign لنوعَي الهدف "مرات الظهور" و"النقرات". يمكنك الاطّلاع على مصادر الإعلانات للحصول على قائمة بأسماء مصادر الإعلانات المحتملة عندما تعرض شبكة إعلانات الإعلان.
adNetworkClassName	اسم فئة محوّل شبكة الإعلانات الذي حمّل الإعلان.
adUnitMapping	إعدادات الشبكة التي تم ضبطها من واجهة مستخدم AdMob
latency	مقدار الوقت الذي استغرقته شبكة الإعلانات في تحميل إعلان تعرض هذه السمة القيمة 0 إذا لم تتم محاولة الاتصال بالشبكة.

Swift

fileprivate func loadInterstitial() {
  InterstitialAd.load(
    with: "ca-app-pub-3940256099942544/4411468910", request: request
  ) { (ad, error) in
    let responseInfo = ad?.responseInfo
    let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo

    let adNetworkError = loadedAdNetworkResponseInfo?.error
    let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
    let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
    let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
    let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
    let adNetworkClassName = loadedAdNetworkResponseInfo?.adNetworkClassName
    let adUnitMapping = loadedAdNetworkResponseInfo?.adUnitMapping
    let latency = loadedAdNetworkResponseInfo?.latency
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"ca-app-pub-3940256099942544/4411468910"
   request:request
   completionHandler:^(GADInterstitialAd *ad, NSError *error) {
    GADResponseInfo *responseInfo = ad.responseInfo;
    GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo = responseInfo.loadedAdNetworkResponseInfo;

    NSError *adNetworkError = loadedAdNetworkResponseInfo.error;
    NSString *adSourceId = loadedAdNetworkResponseInfo.adSourceID;
    NSString *adSourceInstanceId = loadedAdNetworkResponseInfo.adSourceInstanceID;
    NSString *adSourceInstanceName = loadedAdNetworkResponseInfo.adSourceInstanceName;
    NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
    NSString *adNetworkClassName = loadedAdNetworkResponseInfo.adNetworkClassName;
    NSDictionary *adUnitMapping = loadedAdNetworkResponseInfo.adUnitMapping;
    NSTimeInterval latency = loadedAdNetworkResponseInfo.latency;
  }];
}