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

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

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

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

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

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

• Google Mobile Ads SDK 9.10.0 या इसके बाद का वर्शन इंपोर्ट करें.
• सेट अप करें Google Mobile Ads SDK.

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

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

पैसे देकर दिखाए जाने वाले इवेंट हैंडलर लागू करना

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

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

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

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 नाम का विज्ञापन सोर्स मिलता है. अगर एक से ज़्यादा कस्टम इवेंट का इस्तेमाल किया जाता है, तो विज्ञापन सोर्स का नाम इतना सटीक नहीं होता कि एक से ज़्यादा कस्टम इवेंट के बीच अंतर किया जा सके. किसी खास कस्टम इवेंट का पता लगाने के लिए, यह तरीका अपनाएं:

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

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

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

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

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

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

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

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

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

GADAdValue

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

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

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

• GADAdValuePrecisionUnknown: यह सटीक वैल्यू का टाइप दिखाता है.

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

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

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