Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

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

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

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

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

पैसे चुकाकर देखे जाने वाले इवेंट मैनेज करना

हर विज्ञापन फ़ॉर्मैट के डेलिगेट प्रोटोकॉल में, didRecordPaidEventWithAdValue: मेथड शामिल होता है. विज्ञापन की लाइफ़साइकल के दौरान, Google Mobile Ads SDK इंप्रेशन इवेंट को मॉनिटर करता है. साथ ही, मिले हुए GADAdValue ऑब्जेक्ट के साथ इस डेलिगेट तरीके को कॉल करता है.

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

Swift

func ad(_ ad: FullScreenPresentingAd, didRecordPaidEventWith adValue: 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.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

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

Objective-C

- (void)ad:(id<GADFullScreenPresentingAd>)ad didRecordPaidEventWithAdValue:(GADAdValue *)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);
}

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

कस्टम इवेंट वाले विज्ञापन सोर्स के लिए, 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

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

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

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

GADAdValue

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

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

ओपन बिडिंग से मिले टेस्ट इंप्रेशन

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

GADAdValuePrecisionUnknown: इससे पता चलता है कि डेटा कितना सटीक है.

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

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

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