इस पेज का अनुवाद Cloud Translation API से किया गया है.

इंप्रेशन लेवल पर विज्ञापन से होने वाली आय

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

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

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

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

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

पैसे चुकाकर इस्तेमाल किया जाने वाला इवेंट हैंडलर लागू करना

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

Swift

class ViewController: UIViewController, GADFullScreenContentDelegate {
  var rewardedAd: GADRewardedAd?
  func requestRewardedAd() {
    GADRewardedAd.load(
      withAdUnitID: "AD_UNIT_ID", request: GADRequest()
    ) { (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?.extrasDictionary["mediation_group_name"]
          let mediationABTestName = responseInfo?.extrasDictionary["mediation_ab_test_name"]
          let mediationABTestVariant = responseInfo?.extrasDictionary["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&lt;NSString *, id&gt; *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"];
    };
  ]};
}

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

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

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

पार्टनर का SDK टूल
अडजस्ट करें
AppsFlyer
Singular
Tenjin

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

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

GADAdValue

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

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

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

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

GADAdValuePrecisionUnknown: सटीक जानकारी देता है.

0: विज्ञापन की वैल्यू दिखाता है.

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

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