বিজ্ঞাপন প্রতিক্রিয়া সম্পর্কে তথ্য পুনরুদ্ধার করুন

ডিবাগিং এবং লগিংয়ের উদ্দেশ্যে, সফলভাবে লোড হওয়া অ্যাডগুলো একটি GADResponseInfo অবজেক্ট প্রদান করে। এই অবজেক্টটিতে লোড করা অ্যাডটি সম্পর্কিত তথ্যের পাশাপাশি, অ্যাডটি লোড করতে ব্যবহৃত মিডিয়েশন ওয়াটারফল সম্পর্কিত তথ্যও থাকে।

যেসব ক্ষেত্রে কোনো বিজ্ঞাপন সফলভাবে লোড হয়, সেই বিজ্ঞাপন অবজেক্টটিতে একটি GADResponseInfo প্রপার্টি থাকে। উদাহরণস্বরূপ, GADInterstitialAd.responseInfo একটি লোড হওয়া ইন্টারস্টিশিয়াল বিজ্ঞাপনের রেসপন্স ইনফো প্রদান করে।

যেসব ক্ষেত্রে বিজ্ঞাপন লোড হতে ব্যর্থ হয় এবং শুধুমাত্র একটি ত্রুটি বার্তা পাওয়া যায়, সেসব ক্ষেত্রে ত্রুটির userInfo ডিকশনারিতে থাকা GADErrorUserInfoKeyResponseInfo কী-টি ব্যবহার করে GADResponseInfo টি পাওয়া যায়।

সুইফট

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

উদ্দেশ্য-সি

- (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 রেসপন্স আইডেন্টিফায়ার হলো বিজ্ঞাপনের প্রতিক্রিয়ার জন্য একটি অনন্য শনাক্তকারী। এই আইডেন্টিফায়ারটি অ্যাডস রিভিউ সেন্টার (ARC)- এ বিজ্ঞাপনটি শনাক্ত করতে এবং ব্লক করতে ব্যবহার করা যেতে পারে।
extrasDictionary বিজ্ঞাপনের প্রতিক্রিয়া সম্পর্কে অতিরিক্ত তথ্য ফেরত দেয়। অতিরিক্ত তথ্য হিসেবে নিম্নলিখিত কী-গুলো ফেরত আসতে পারে:
  • mediation_group_name : মধ্যস্থতা গোষ্ঠীর নাম
  • mediation_ab_test_name : মেডিয়েশন এ/বি টেস্টের নাম, যদি প্রযোজ্য হয়।
  • mediation_ab_test_variant : মেডিয়েশন A/B টেস্টে ব্যবহৃত ভ্যারিয়েন্ট, যদি প্রযোজ্য হয়।

সুইফট

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

উদ্দেশ্য-সি

- (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 UI থেকে নেটওয়ার্ক কনফিগারেশন সেট করা হয়।
latency একটি বিজ্ঞাপন লোড করতে বিজ্ঞাপন নেটওয়ার্কের ব্যয়িত সময়। নেটওয়ার্কটিতে চেষ্টা করা না হলে 0 রিটার্ন করে।

সুইফট

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

উদ্দেশ্য-সি

- (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;
  }];
}