इन-ऐप्लिकेशन खरीदारी मेज़र करना

इन-ऐप्लिकेशन खरीदारी (आईएपी), ऐसी सुविधाओं या डिजिटल कॉन्टेंट को कहते हैं जिन्हें Google Play या Apple App Store के ज़रिए मोबाइल ऐप्लिकेशन में बेचा जा सकता है. इसके लिए, आपके ऐप्लिकेशन को वित्तीय लेन-देन प्रोसेस करने की ज़रूरत नहीं होती. इन-ऐप्लिकेशन खरीदारी के उदाहरणों में, सदस्यता के हिसाब से कॉन्टेंट या गेम के खास आइटम शामिल हैं.

Analytics, इन-ऐप्लिकेशन खरीदारी की रिपोर्ट में आईएपी इवेंट दिखाता है.

Android ऐप्लिकेशन के लिए, Analytics SDK, Google Play के साथ इंटिग्रेट होता है. Apple प्लैटफ़ॉर्म के ऐप्लिकेशन के लिए, SDK टूल को Apple App Store के साथ इंटिग्रेट किया जाता है. इसके लिए, Apple के StoreKit 1 और StoreKit 2 एपीआई का इस्तेमाल किया जाता है.

ज़्यादातर मामलों में, Analytics SDK, IAP इवेंट को अपने-आप इकट्ठा करता है. इसके लिए, आपके ऐप्लिकेशन में एपीआई कॉल की ज़रूरत नहीं होती. iOS पर, अपने-आप इकट्ठा होने वाले IAP इवेंट के अलावा, WebView में IAP इवेंट को मैन्युअल तरीके से भी लॉग किया जा सकता है. इस गाइड में, अपने-आप ट्रैकिंग की सुविधा के लिए प्रोजेक्ट सेट अप करने का तरीका बताया गया है. साथ ही, इसमें कुछ खास मामलों के बारे में बताया गया है. इन मामलों में, सुविधा को लागू करने के लिए कुछ लाइनों के कोड की ज़रूरत होती है.

शुरू करने से पहले

Android ऐप्लिकेशन

  • पक्का करें कि आपका ऐप्लिकेशन Analytics SDK v17.3.0+ (या Firebase Android BoM v25.2.0+) का इस्तेमाल कर रहा हो.

  • अपने Firebase ऐप्लिकेशन को Google Play से लिंक करें.

Apple के प्लैटफ़ॉर्म ऐप्लिकेशन

  • पक्का करें कि आपके पास एसडीके का सबसे नया वर्शन हो:

    • इन-ऐप्लिकेशन खरीदारी को अपने-आप ट्रैक करने के लिए: पक्का करें कि आपका ऐप्लिकेशन, Analytics SDK के 6.20.0 या इसके बाद के वर्शन का इस्तेमाल कर रहा हो.

    • इन-ऐप्लिकेशन खरीदारी को मैन्युअल तरीके से ट्रैक करने के लिए: पक्का करें कि आपका ऐप्लिकेशन, Analytics SDK v12.5.0+ का इस्तेमाल कर रहा हो.

  • Apple के दस्तावेज़ को पढ़कर, पक्का करें कि आपको Apple StoreKit 1 और StoreKit 2 के इन-ऐप्लिकेशन खरीदारी वाले एपीआई के बारे में पता हो.

लागू करना

ज़्यादातर मामलों में, Analytics SDK टूल, IAP इवेंट को अपने-आप लॉग करता है. इसके लिए, अतिरिक्त कोड की ज़रूरत नहीं होती.

Android ऐप्लिकेशन में लागू करना

Android ऐप्लिकेशन के लिए, Google Play से लिंक करने के तुरंत बाद, IAP इवेंट मेज़र किए जा सकते हैं.

Apple प्लैटफ़ॉर्म के ऐप्लिकेशन में लागू करना

अगर iOS ऐप्लिकेशन के लिए StoreKit 1 का इस्तेमाल किया जा रहा है, तो Analytics SDK टूल, IAP इवेंट को अपने-आप लॉग करता है. अगर StoreKit 2 का इस्तेमाल किया जा रहा है, तो पुष्टि की गई इन-ऐप्लिकेशन खरीदारी की घटनाओं को लॉग किया जा सकता है. इसके लिए, यहां दिए गए कोड स्निपेट का इस्तेमाल करें.

इसके अलावा, अगर आपको App Store के बाहर की गई इन-ऐप्लिकेशन खरीदारी को ट्रैक करना है, तो WebView में IAP इवेंट को मैन्युअल तरीके से लॉग करें. ध्यान दें कि एसडीके, इन-ऐप्लिकेशन खरीदारी को अपने-आप लॉग करता रहेगा. हालांकि, यह मैन्युअल तरीके से लॉग किए गए इन-ऐप्लिकेशन खरीदारी के इवेंट को डुप्लीकेट नहीं करेगा. पक्का करें कि ऐप्लिकेशन में होने वाली खरीदारी को मैन्युअल तरीके से ट्रैक करते समय, Analytics SDK v12.5.0+ का इस्तेमाल किया जा रहा हो.

Swift

अगर StoreKit 1 का इस्तेमाल किया जा रहा है, तो Analytics SDK, IAP इवेंट को अपने-आप लॉग करता है.

अगर StoreKit 2 का इस्तेमाल किया जा रहा है, तो IAP इवेंट लॉग करने के लिए यहां दिया गया कोड इस्तेमाल करें.

import StoreKit
import FirebaseAnalytics

// A user tapped a button to purchase an item.
func userTappedPurchaseUpgradeButton() {
  let product = ...
  purchaseSomeProduct(product)
}

func purchaseSomeProduct(_ product: Product) {
  // Purchase a Product. This is mostly standard boilerplate StoreKit 2
  // code, except for the Analytics.logTransaction() call.
  let result = try await product.purchase()
  switch result {
  case .success(let verification):
      let transaction = try checkVerified(verification)

      // Call this Firebase API to log the in-app purchase event.
      Analytics.logTransaction(transaction)

      await transaction.finish()
  ...
}

Objective-C

अगर StoreKit 1 का इस्तेमाल किया जा रहा है, तो Analytics SDK, IAP इवेंट को अपने-आप लॉग करता है.

StoreKit 2 सिर्फ़ Swift के साथ काम करता है. इसलिए, Objective-C के साथ इसका इस्तेमाल नहीं किया जा सकता.