इंप्रेशन-लेवल पर विज्ञापन से मिलने वाला रेवेन्यू

प्लैटफ़ॉर्म चुनें: Android iOS Unity

जब कोई इंप्रेशन मिलता है, तब Google Mobile Ads SDK, पैसे देकर दिखाए जाने वाले इवेंट के हैंडलर को कॉल करता है. साथ ही, उससे जुड़ा रेवेन्यू डेटा भी भेजता है. इस हैंडलर को लागू करके, उपयोगकर्ता की लाइफ़टाइम वैल्यू का हिसाब लगाने के लिए डेटा का इस्तेमाल किया जा सकता है. इसके अलावा, डेटा को अन्य काम के सिस्टम में डाउनस्ट्रीम किया जा सकता है.

इस गाइड का मकसद, iOS ऐप्लिकेशन में एलटीवी डेटा कैप्चर करने की सुविधा लागू करने में आपकी मदद करना है.

ज़रूरी शर्तें

• पक्का करें कि आपने AdMob यूज़र इंटरफ़ेस में, इंप्रेशन-लेवल पर विज्ञापन से मिलने वाले रेवेन्यू की सुविधा चालू की हो.

• Google Mobile Ads SDK 9.10.0 या इसके बाद का वर्शन इंपोर्ट करें.
• शुरुआती निर्देश पढ़ें.

• इंप्रेशन-लेवल पर विज्ञापन से मिलने वाला रेवेन्यू पाने के लिए, आपको कम से कम एक विज्ञापन फ़ॉर्मैट लागू करना होगा:

  • बैनर
  • पेज पर अचानक दिखने वाला विज्ञापन
  • इनाम वाले विज्ञापन
  • इनाम वाला इंटरस्टीशियल विज्ञापन
  • नेटिव

सशुल्क इवेंट हैंडलर लागू करना

हर विज्ञापन फ़ॉर्मैट में paidEventHandler टाइप की GADPaidEventHandler प्रॉपर्टी होती है. विज्ञापन इवेंट के लाइफ़साइकल के दौरान, Google Mobile Ads SDK इंप्रेशन इवेंट को मॉनिटर करता है. साथ ही, कमाई की गई वैल्यू के साथ हैंडलर को शुरू करता है.

Swift

class ViewController: UIViewController, FullScreenContentDelegate {
  var rewardedAd: RewardedAd?
  func requestRewardedAd() {
    RewardedAd.load(
      with: "AD_UNIT_ID", request: Request()
    ) { (ad, error) in
      if let error = error {
        print("Rewarded ad failed to load with error: \(error.localizedDescription)")
        return
      }
      if let ad = ad {
        self.rewardedAd = ad
        self.rewardedAd?.paidEventHandler = { adValue in
          // TODO: Send the impression-level ad revenue information to your preferred analytics
          // server directly within this callback.

          // Extract the impression-level ad revenue data.
          let value = adValue.value
          let precision = adValue.precision
          let currencyCode = adValue.currencyCode

          // Get the ad unit ID.
          let adUnitId = ad.adUnitID

          let responseInfo = ad.responseInfo
          let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo
          let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
          let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
          let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
          let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
          let mediationGroupName = responseInfo?.extras["mediation_group_name"]
          let mediationABTestName = responseInfo?.extras["mediation_ab_test_name"]
          let mediationABTestVariant = responseInfo?.extras["mediation_ab_test_variant"]
        }
      }
    }
  }
}

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()
@property(nonatomic, strong) GADRewardedAd *rewardedAd;
@end

@implementation ViewController
- (void)requestRewardedAd {
  __weak ViewController *weakSelf = self;

  GADRequest *request = [GADRequest request];
  [GADRewardedAd
   loadWithAdUnitID:@"AD_UNIT_ID"
   request:request
   completionHandler:^(GADRewardedAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
      return;
    }
    self.rewardedAd = ad;
    self.rewardedAd.paidEventHandler = ^void(GADAdValue *_Nonnull value){
      ViewController *strongSelf = weakSelf;
      // TODO: Send the impression-level ad revenue information to your preferred analytics
      // server directly within this callback.

      // Extract the impression-level ad revenue data.
      NSDecimalNumber *value; = value.value;
      NSString *currencyCode = value.currencyCode;
      GADAdValuePrecision precision = value.precision;

      // Get the ad unit ID.
      NSString *adUnitId = strongSelf.rewardedAd.adUnitID;

      GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo =
          strongSelf.rewardedAd.responseInfo.loadedAdNetworkResponseInfo;
      NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
      NSString *adSourceID = loadedAdNetworkResponseInfo.adSourceID;
      NSString *adSourceInstanceName = loadedAdNetworkResponseInfo.adSourceInstanceName;
      NSString *adSourceInstanceID = loadedAdNetworkResponseInfo.adSourceInstanceID;
      NSDictionary<NSString *, id> *extras = strongSelf.rewardedAd.responseInfo.extrasDictionary;
      NSString *mediationGroupName = extras["mediation_group_name"];
      NSString *mediationABTestName = extras["mediation_ab_test_name"];
      NSString *mediationABTestVariant = extras["mediation_ab_test_variant"];
    };
  ]};
}

कस्टम इवेंट के विज्ञापन सोर्स के नाम की पहचान करना

कस्टम इवेंट विज्ञापन सोर्स के लिए, adSourceName प्रॉपर्टी से आपको विज्ञापन सोर्स का नाम Custom event मिलता है. अगर एक से ज़्यादा कस्टम इवेंट का इस्तेमाल किया जाता है, तो विज्ञापन सोर्स का नाम इतना सटीक नहीं होता कि अलग-अलग कस्टम इवेंट के बीच अंतर किया जा सके. किसी कस्टम इवेंट का पता लगाने के लिए, यह तरीका अपनाएं:

1. adNetworkClassName प्रॉपर्टी पाएं.
2. विज्ञापन सोर्स का कोई यूनीक नाम सेट करें.

यहां दिए गए उदाहरण में, कस्टम इवेंट के लिए विज्ञापन सोर्स का यूनीक नाम सेट किया गया है:

Swift

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}
ResponseInfoSnippets.swift

Objective-C

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}
ResponseInfoSnippets.m

विज्ञापन दिखाने के लिए चुने गए सोर्स के बारे में ज़्यादा जानने के लिए, विज्ञापन के जवाब के बारे में जानकारी पाना लेख पढ़ें.

ऐप्लिकेशन एट्रिब्यूशन पार्टनर (एएपी) के साथ इंटिग्रेट करना

विज्ञापन से मिलने वाले रेवेन्यू के डेटा को आंकड़ों के प्लैटफ़ॉर्म पर फ़ॉरवर्ड करने के बारे में पूरी जानकारी के लिए, पार्टनर की गाइड देखें:

Partner SDK
Adjust
AppsFlyer
Singular
Tenjin

लागू करने के सबसे सही तरीके

• विज्ञापन ऑब्जेक्ट बनाने या उसका ऐक्सेस पाने के तुरंत बाद हैंडलर सेट करें. साथ ही, विज्ञापन दिखाने से पहले हैंडलर सेट करना ज़रूरी है. इससे यह पक्का किया जाता है कि आपसे किसी भी ऐसे इवेंट के कॉलबैक न छूटें जिनके लिए पेमेंट किया गया है.
• paidEventHandler तरीके को कॉल किए जाने के समय, पैसे चुकाकर देखे जाने वाले इवेंट की जानकारी को अपने पसंदीदा Analytics सर्वर पर तुरंत भेजें. इससे यह पक्का होता है कि आपसे गलती से कोई भी कॉलबैक न छूटे. साथ ही, डेटा में अंतर आने से भी बचा जा सकता है.

GADAdValue

GADAdValue एक क्लास है, जो किसी विज्ञापन से मिली मॉनेटरी वैल्यू को दिखाती है. इसमें वैल्यू का मुद्रा कोड और उसके सटीक टाइप को इस तरह से कोड किया जाता है.

अहम जानकारी: GADAdValue.value की वैल्यू एक दशमलव संख्या होती है, जो हर विज्ञापन की वैल्यू को दिखाती है. उदाहरण के लिए, 0.005 वैल्यू का मतलब है कि इस विज्ञापन की अनुमानित वैल्यू 0.005 डॉलर है.

GADAdValuePrecision	ब्यौरा
GADAdValuePrecisionUnknown	विज्ञापन की ऐसी वैल्यू जिसकी जानकारी नहीं है. यह तब दिखता है, जब एलटीवी पिंगबैक की सुविधा चालू हो, लेकिन ज़रूरत के मुताबिक डेटा उपलब्ध न हो.
GADAdValuePrecisionEstimated	कुल डेटा से ली गई अनुमानित विज्ञापन वैल्यू.
GADAdValuePrecisionPublisherProvided	पब्लिशर की ओर से दी गई विज्ञापन वैल्यू, जैसे कि किसी मीडिएशन ग्रुप में मौजूद मैन्युअल सीपीएम.
GADAdValuePrecisionPrecise	इस विज्ञापन के लिए चुकाए गए पैसे.

अहम जानकारी: मीडिएशन के मामले में, AdMob सबसे पहले GADAdValuePrecisionEstimated देने की कोशिश करता है. अगर कोई काम की वैल्यू रिपोर्ट करने के लिए, एग्रीगेट किया गया ज़रूरी डेटा उपलब्ध नहीं होता है, तो वह GADAdValuePrecisionPublisherProvided पर वापस आ जाता है.

बिडिंग विज्ञापन स्रोतों से मिले इंप्रेशन को टेस्ट करना

टेस्ट के अनुरोध के ज़रिए, बिडिंग वाले विज्ञापन सोर्स के लिए इंप्रेशन-लेवल पर विज्ञापन से मिलने वाले रेवेन्यू का इवेंट होने के बाद, आपको सिर्फ़ ये वैल्यू मिलती हैं:

• GADAdValuePrecisionUnknown: यह सटीक होने के टाइप के बारे में बताता है.

• 0: इससे विज्ञापन की वैल्यू का पता चलता है.

पहले, आपको सटीक टाइप की वैल्यू, GADAdValuePrecisionUnknown के अलावा कोई और वैल्यू दिख सकती थी. साथ ही, विज्ञापन की वैल्यू 0 से ज़्यादा दिख सकती थी.

टेस्ट विज्ञापन अनुरोध भेजने के बारे में जानकारी के लिए, टेस्ट डिवाइस चालू करना लेख पढ़ें.