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

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

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

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

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

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

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

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

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

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

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

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

लागू करना

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

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

इसके अलावा, अगर आपको App Store के बाहर की गई इन-ऐप्लिकेशन खरीदारी को ट्रैक करना है, तो WebView में, आईएपी इवेंट को मैन्युअल तरीके से लॉग किया जा सकता है. ध्यान दें कि SDK, इन-ऐप्लिकेशन खरीदारी को अपने-आप लॉग करता रहेगा. साथ ही, मैन्युअल तरीके से लॉग किए गए इन-ऐप्लिकेशन खरीदारी वाले इवेंट को डुप्लीकेट नहीं करेगा. इन-ऐप्लिकेशन खरीदारी को मैन्युअल तरीके से ट्रैक करते समय, पक्का करें कि Analytics SDK के वर्शन 12.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()
  ...
}