हमारे प्रॉडक्ट के बारे में चर्चा करने और सुझाव/राय देने के लिए, Google विज्ञापन और मेज़रमेंट कम्यूनिटी सर्वर में Ad Manager के आधिकारिक Discord चैनल से जुड़ें.

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

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

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

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

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

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

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

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

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

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

Swift

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 currencyCode = adValue.currencyCode
  let precision = adValue.precision

  print(
    "Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
  )
}ImpressionLevelAdRevenueSnippets.swift

Objective-C

rewardedAd.paidEventHandler = ^(GADAdValue *_Nonnull adValue) {
  // 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 = adValue.value;
  NSString *currencyCode = adValue.currencyCode;
  GADAdValuePrecision precision = adValue.precision;

  NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode,
        (long)precision);
};ImpressionLevelAdRevenueSnippets.m

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

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

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

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

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

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

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

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

GADAdValue

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

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

ओपन बिडिंग से मिले इंप्रेशन की जांच करना

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

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

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

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

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