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

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

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

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

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

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

• Google Analytics का इस्तेमाल शुरू करना में दिए गए निर्देशों के मुताबिक, अपना Firebase प्रोजेक्ट और ऐप्लिकेशन का कोडबेस सेट अप करें.

• अपने Firebase प्रोजेक्ट को Google Analytics 4 प्रॉपर्टी से लिंक करें.

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

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

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

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

लागू करना

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

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

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

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()
  ...
}