ওয়েব মনিটাইজেশন আনলক করা: ইন-অ্যাপ পারচেজের জন্য ডিজিটাল গুডস এপিআই-এর একটি গভীর বিশ্লেষণ

বহু বছর ধরে, নেটিভ মোবাইল অ্যাপ্লিকেশনগুলো মনিটাইজেশনের ক্ষেত্রে একটি বিশেষ সুবিধা পেয়ে আসছে: অপারেটিং সিস্টেমের অ্যাপ স্টোরের সাথে সরাসরি সমন্বিত নির্বিঘ্ন, বিশ্বস্ত ইন-অ্যাপ পারচেজ (IAP) সিস্টেম। এই সুবিন্যস্ত প্রক্রিয়াটি মোবাইল অ্যাপ অর্থনীতির একটি মূল ভিত্তি। এদিকে, ওপেন ওয়েব তার অতুলনীয় বিস্তৃতি সত্ত্বেও, থার্ড-পার্টি পেমেন্ট গেটওয়ের একটি খণ্ডিত ব্যবস্থার সাথে লড়াই করে চলেছে, যা প্রায়শই কম সমন্বিত এবং কম বিশ্বস্ত ব্যবহারকারীর অভিজ্ঞতার দিকে পরিচালিত করে।

এখানেই আসে ডিজিটাল গুডস এপিআই। এই আধুনিক ওয়েব স্ট্যান্ডার্ডটি প্রগ্রেসিভ ওয়েব অ্যাপসের (PWAs) জন্য একটি যুগান্তকারী পরিবর্তন, যা ওয়েব এবং নেটিভ মনিটাইজেশনের মধ্যেকার ব্যবধান পূরণ করার লক্ষ্যে তৈরি। এটি ওয়েব অ্যাপ্লিকেশনগুলোকে ডিজিটাল ডিস্ট্রিবিউশন পরিষেবাগুলির—যেমন গুগল প্লে স্টোর বা মাইক্রোসফ্ট স্টোর—সাথে যোগাযোগ করার জন্য একটি প্রমিত উপায় সরবরাহ করে, যার মাধ্যমে ইন-অ্যাপ পণ্য এবং কেনাকাটা পরিচালনা করা যায়।

এই বিস্তারিত গাইডটি ডেভেলপার, প্রোডাক্ট ম্যানেজার এবং প্রযুক্তি নেতাদের জন্য, যারা তাদের ওয়েব অ্যাপ্লিকেশনগুলির জন্য একটি শক্তিশালী IAP কৌশল বুঝতে এবং প্রয়োগ করতে চান। আমরা এই এপিআই-এর মূল ধারণা থেকে শুরু করে ধাপে ধাপে বাস্তবায়ন পর্যন্ত অন্বেষণ করব, যেখানে বিশ্বব্যাপী দর্শকদের জন্য গুরুত্বপূর্ণ নিরাপত্তা অনুশীলন এবং বৈশ্বিক বিবেচনাগুলোও অন্তর্ভুক্ত থাকবে।

অধ্যায় ১: ডিজিটাল গুডস এপিআই বোঝা

ডিজিটাল গুডস এপিআই কী?

এর মূলে, ডিজিটাল গুডস এপিআই হলো একটি জাভাস্ক্রিপ্ট এপিআই যা আপনার ওয়েব অ্যাপ্লিকেশন এবং ব্যবহারকারীর পেমেন্ট প্রোভাইডারের মধ্যে একটি সেতু হিসাবে কাজ করে, বিশেষত যে প্ল্যাটফর্ম থেকে PWA ইনস্টল করা হয়েছে তার সাথে যুক্ত পেমেন্ট প্রোভাইডারের সাথে। উদাহরণস্বরূপ, যদি একজন ব্যবহারকারী গুগল প্লে স্টোর থেকে আপনার PWA ইনস্টল করে, তবে ডিজিটাল গুডস এপিআই গুগল প্লে বিলিং-এর সাথে যোগাযোগ করবে।

এর প্রাথমিক উদ্দেশ্য হল আপনার ওয়েব অভিজ্ঞতার মধ্যে সরাসরি ডিজিটাল আইটেম বিক্রি করার প্রক্রিয়াটিকে সহজ করা। এই আইটেমগুলির মধ্যে অন্তর্ভুক্ত থাকতে পারে:

• কনজিউমেবলস (Consumables): এককালীন কেনাকাটা যা ব্যবহার করা যায় এবং পুনরায় কেনা যায়, যেমন ইন-গেম কারেন্সি, অতিরিক্ত লাইফ বা বুস্ট।
• নন-কনজিউমেবলস (Non-consumables): স্থায়ী এককালীন কেনাকাটা, যেমন একটি প্রিমিয়াম ফিচার আনলক করা, বিজ্ঞাপন সরানো বা একটি লেভেল প্যাক কেনা।
• সাবস্ক্রিপশন (Subscriptions): কন্টেন্ট বা পরিষেবাগুলিতে অবিচ্ছিন্ন অ্যাক্সেসের জন্য পুনরাবৃত্তিমূলক পেমেন্ট, যেমন একটি মাসিক নিউজ সাবস্ক্রিপশন বা একটি প্রিমিয়াম সফটওয়্যার স্যুটে অ্যাক্সেস।

এই এপিআই ব্যবহারের মূল সুবিধাগুলির মধ্যে রয়েছে:

• সুবিন্যস্ত ব্যবহারকারীর অভিজ্ঞতা: ব্যবহারকারীরা পেমেন্টের তথ্য পুনরায় প্রবেশ না করেই তাদের বিদ্যমান, বিশ্বস্ত স্টোর অ্যাকাউন্ট ব্যবহার করে ডিজিটাল পণ্য কিনতে পারেন। এটি উল্লেখযোগ্যভাবে ঘর্ষণ কমায় এবং রূপান্তর হার বাড়াতে পারে।
• বিশ্বস্ত পেমেন্ট ফ্লো: সম্পূর্ণ পেমেন্ট প্রক্রিয়াটি অন্তর্নিহিত প্ল্যাটফর্ম (যেমন, গুগল প্লে) দ্বারা পরিচালিত হয়, যা এর নিরাপত্তা, পরিচিতি এবং সংরক্ষিত পেমেন্ট পদ্ধতিগুলোকে কাজে লাগায়।
• ডেভেলপমেন্ট ওভারহেড হ্রাস: বিভিন্ন অঞ্চল বা পছন্দের জন্য একাধিক পেমেন্ট প্রসেসর একীভূত করার পরিবর্তে, ডেভেলপাররা একটি একক, প্রমিত এপিআই ব্যবহার করতে পারে যা ব্রাউজার এবং অন্তর্নিহিত প্ল্যাটফর্ম পরিচালনা করে।

মূল ধারণা এবং পরিভাষা

এপিআই কার্যকরভাবে ব্যবহার করার জন্য, এর প্রধান উপাদানগুলি বোঝা অপরিহার্য:

• DigitalGoodsService: এটি এপিআই-এর প্রধান এন্ট্রি পয়েন্ট। পেমেন্ট প্রোভাইডারের সাথে ইন্টারঅ্যাক্ট করার জন্য আপনি এই পরিষেবার একটি ইনস্ট্যান্স পান।
• SKU (Stock Keeping Unit): আপনার বিক্রি করা প্রতিটি ডিজিটাল পণ্যের জন্য একটি অনন্য শনাক্তকারী। আপনি আপনার পেমেন্ট প্রোভাইডারের ডেভেলপার কনসোলে (যেমন, Google Play Console) এই SKU-গুলি সংজ্ঞায়িত করেন।
• `getDetails(skus)`: আপনার পণ্য সম্পর্কে বিস্তারিত তথ্য, যেমন শিরোনাম, বিবরণ এবং সবচেয়ে গুরুত্বপূর্ণভাবে, বর্তমান ব্যবহারকারীর জন্য স্থানীয় মূল্য এবং মুদ্রা আনার জন্য একটি মেথড।
• Purchase Token: একটি সম্পন্ন লেনদেনকে প্রতিনিধিত্বকারী একটি অনন্য, সুরক্ষিত স্ট্রিং। এই টোকেনটি ব্যাকএন্ড ভেরিফিকেশনের জন্য অত্যন্ত গুরুত্বপূর্ণ।
• `listPurchases()`: ব্যবহারকারীর সক্রিয়, নন-কনজিউমড কেনাকাটার একটি তালিকা পুনরুদ্ধার করে। যখন একজন ব্যবহারকারী একটি নতুন ডিভাইসে লগ ইন করে তখন প্রিমিয়াম ফিচারগুলোতে অ্যাক্সেস পুনরুদ্ধার করার জন্য এটি অপরিহার্য।
• `consume(purchaseToken)`: একটি এককালীন কনজিউমেবল পণ্যকে ব্যবহৃত হিসাবে চিহ্নিত করে। কনজিউম করার পরে, ব্যবহারকারী আইটেমটি পুনরায় কিনতে পারে। এটি ইন-গেম কারেন্সির মতো আইটেমগুলির জন্য গুরুত্বপূর্ণ।
• `acknowledge(purchaseToken)`: নিশ্চিত করে যে একটি নন-কনজিউমেবল বা সাবস্ক্রিপশন কেনাকাটা সফলভাবে প্রক্রিয়া করা হয়েছে এবং ব্যবহারকারীকে প্রদান করা হয়েছে। যদি একটি নির্দিষ্ট সময়সীমার মধ্যে (যেমন, গুগল প্লে-তে তিন দিন) একটি কেনাকাটা অ্যাকনলেজ করা না হয়, প্ল্যাটফর্মটি স্বয়ংক্রিয়ভাবে ব্যবহারকারীকে অর্থ ফেরত দিতে পারে।

এটি প্রচলিত ওয়েব পেমেন্ট থেকে কীভাবে আলাদা

ডিজিটাল গুডস এপিআই-কে অন্যান্য ওয়েব পেমেন্ট প্রযুক্তি থেকে আলাদা করা গুরুত্বপূর্ণ:

• vs. Payment Request API: পেমেন্ট রিকোয়েস্ট এপিআই একটি বিস্তৃত পরিসরের লেনদেনের জন্য ডিজাইন করা হয়েছে, যার মধ্যে ফিজিক্যাল পণ্য এবং পরিষেবা অন্তর্ভুক্ত। এটি চেকআউট *ফ্লো*-কে প্রমিত করে কিন্তু প্রকৃত পেমেন্ট পরিচালনা করার জন্য আপনাকে এখনও স্ট্রাইপ বা অ্যাডিয়েনের মতো একটি পেমেন্ট প্রসেসর একীভূত করতে হয়। ডিজিটাল গুডস এপিআই, এর বিপরীতে, বিশেষভাবে *ডিজিটাল আইটেম*-এর জন্য এবং এটি সরাসরি অ্যাপ স্টোরের *বিলিং সিস্টেম*-এর সাথে একীভূত হয়। প্রকৃতপক্ষে, ডিজিটাল গুডস এপিআই প্রায়শই একটি নির্দিষ্ট SKU-এর জন্য কেনাকাটার ফ্লো শুরু করতে হুডের নিচে পেমেন্ট রিকোয়েস্ট এপিআই ব্যবহার করে।
• vs. থার্ড-পার্টি SDKs (Stripe, PayPal, ইত্যাদি): এই পরিষেবাগুলি ওয়েবে সরাসরি গ্রাহকের কাছে পেমেন্টের জন্য চমৎকার। তবে, এগুলোর জন্য ব্যবহারকারীদের পেমেন্টের বিবরণ প্রবেশ করাতে হয় (বা একটি পৃথক অ্যাকাউন্টে লগ ইন করতে হয়) এবং প্ল্যাটফর্মের অ্যাপ স্টোর থেকে স্বাধীনভাবে কাজ করে। ডিজিটাল গুডস এপিআই ব্যবহারকারীর স্টোরের সাথে পূর্ব-বিদ্যমান বিলিং সম্পর্ককে কাজে লাগায়, যা একটি আরও সমন্বিত, 'নেটিভ-এর মতো' অভিজ্ঞতা তৈরি করে।

অধ্যায় ২: ইমপ্লিমেন্টেশনের যাত্রা: একটি ধাপে ধাপে নির্দেশিকা

আসুন একটি PWA-তে ডিজিটাল গুডস এপিআই একীভূত করার ব্যবহারিক পদক্ষেপগুলো পর্যায়ক্রমে দেখি। এই নির্দেশিকাটি ধরে নিচ্ছে যে আপনার একটি বেসিক PWA কাঠামো রয়েছে।

পূর্বশর্ত এবং সেটআপ

1. একটি কার্যকরী PWA: আপনার ওয়েব অ্যাপটি অবশ্যই ইনস্টলযোগ্য হতে হবে এবং PWA মানদণ্ড পূরণ করতে হবে, যার মধ্যে একটি সার্ভিস ওয়ার্কার এবং একটি ওয়েব অ্যাপ ম্যানিফেস্ট থাকা অন্তর্ভুক্ত।
2. ট্রাস্টেড ওয়েব অ্যাক্টিভিটি (TWA): গুগল প্লে-এর মতো একটি স্টোরে আপনার PWA প্রকাশ করতে, আপনাকে এটিকে একটি ট্রাস্টেড ওয়েব অ্যাক্টিভিটিতে র‍্যাপ করতে হবে। এর জন্য আপনার ডোমেনের মালিকানা প্রমাণ করার জন্য একটি ডিজিটাল অ্যাসেট লিঙ্কস ফাইল সেট আপ করতে হবে।
3. স্টোর অ্যাকাউন্ট এবং পণ্য কনফিগারেশন: আপনার অবশ্যই টার্গেট স্টোরের জন্য একটি ডেভেলপার অ্যাকাউন্ট (যেমন, গুগল প্লে কনসোল) থাকতে হবে এবং আপনার ডিজিটাল পণ্যগুলি (SKUs) কনফিগার করতে হবে, যার মধ্যে তাদের আইডি, প্রকার (কনজিউমেবল, নন-কনজিউমেবল, সাবস্ক্রিপশন), মূল্য এবং বিবরণ অন্তর্ভুক্ত।

ধাপ ১: ফিচার ডিটেকশন

সব ব্রাউজার বা প্ল্যাটফর্ম ডিজিটাল গুডস এপিআই সমর্থন করে না। আপনার প্রথম পদক্ষেপ সবসময় এটি ব্যবহার করার চেষ্টা করার আগে এর প্রাপ্যতা পরীক্ষা করা উচিত। এটি নিশ্চিত করে যে আপনার অ্যাপ্লিকেশনটি অসমর্থিত পরিবেশের জন্য একটি গ্রেসফুল ফলব্যাক সরবরাহ করে।

            if ('getDigitalGoodsService' in window) {
  // The Digital Goods API is available!
  console.log('Digital Goods API supported.');
  // Proceed with initialization.
} else {
  // The API is not available.
  console.log('Digital Goods API not supported.');
  // Hide IAP purchase buttons or show an alternative message.
}

            

              
                Copy
              
            
          

ধাপ ২: সার্ভিসের সাথে সংযোগ স্থাপন

একবার আপনি সমর্থন নিশ্চিত করলে, আপনাকে `DigitalGoodsService`-এর একটি রেফারেন্স পেতে হবে। এটি `window.getDigitalGoodsService()` কল করে করা হয়, সাথে পেমেন্ট প্রোভাইডারের শনাক্তকারী দিয়ে। গুগল প্লে বিলিং-এর জন্য, শনাক্তকারী হল `"https://play.google.com/billing"`।

            async function initializeDigitalGoods() {
  if (!('getDigitalGoodsService' in window)) {
    return null;
  }

  try {
    const service = await window.getDigitalGoodsService("https://play.google.com/billing");
    if (service === null) {
        console.log('No payment provider available.');
        return null;
    }
    return service;
  } catch (error) {
    console.error('Error connecting to Digital Goods Service:', error);
    return null;
  }
}

// Usage:
const digitalGoodsService = await initializeDigitalGoods();

            

              
                Copy
              
            
          

ধাপ ৩: পণ্যের বিবরণ আনা

একটি পারচেজ বাটন দেখানোর আগে, আপনাকে পণ্যের বিবরণ, বিশেষ করে এর স্থানীয় মূল্য প্রদর্শন করতে হবে। মূল্য হার্ডকোড করা একটি খারাপ অভ্যাস, কারণ এটি বিভিন্ন মুদ্রা, আঞ্চলিক মূল্য বা বিক্রয় কর বিবেচনা করে না। পেমেন্ট প্রোভাইডার থেকে সরাসরি এই তথ্য আনার জন্য `getDetails()` মেথড ব্যবহার করুন।

            async function loadProductDetails(service, skus) {
  if (!service) return;

  try {
    const details = await service.getDetails(skus); // skus is an array of strings, e.g., ['premium_upgrade', '100_coins']
    if (details.length === 0) {
        console.log('No products found for the given SKUs.');
        return;
    }

    for (const product of details) {
        console.log(`Product ID: ${product.itemId}`);
        console.log(`Title: ${product.title}`);
        console.log(`Price: ${product.price.value} ${product.price.currency}`);
        
        // Now, update your UI with this information
        const button = document.getElementById(`purchase-${product.itemId}`);
        button.querySelector('.price').textContent = `${product.price.value} ${product.price.currency}`;
    }
  } catch (error) {
    console.error('Failed to fetch product details:', error);
  }
}

// Usage:
const mySkus = ['remove_ads', 'pro_subscription_monthly'];
await loadProductDetails(digitalGoodsService, mySkus);

            

              
                Copy
              
            
          

ধাপ ৪: কেনাকাটা শুরু করা

পারচেজ ফ্লো স্ট্যান্ডার্ড পেমেন্ট রিকোয়েস্ট এপিআই ব্যবহার করে শুরু করা হয়। মূল পার্থক্য হল যে প্রচলিত পেমেন্ট পদ্ধতির পরিবর্তে, আপনি যে ডিজিটাল পণ্যটি বিক্রি করতে চান তার SKU পাস করেন।

            async function purchaseProduct(sku) {
  try {
    // Define the payment method with the SKU
    const paymentMethod = [{
        supportedMethods: "https://play.google.com/billing",
        data: {
            sku: sku,
        }
    }];

    // Standard Payment Request API details
    const paymentDetails = {
        total: {
            label: `Total`,
            amount: { currency: 'USD', value: '0' } // The price is determined by the SKU, this can be a placeholder
        }
    };

    // Create and show the payment request
    const request = new PaymentRequest(paymentMethod, paymentDetails);
    const paymentResponse = await request.show();

    // The purchase was successful on the client-side
    const { purchaseToken } = paymentResponse.details;
    console.log(`Purchase successful! Token: ${purchaseToken}`);
    
    // IMPORTANT: Now, verify this token on your backend
    await verifyPurchaseOnBackend(purchaseToken);

    // After backend verification, call consume() or acknowledge() if needed
    await paymentResponse.complete('success');

  } catch (error) {
    console.error('Purchase failed:', error);
    if (paymentResponse) {
        await paymentResponse.complete('fail');
    }
  }
}

// Usage when a user clicks a button:
document.getElementById('purchase-pro_subscription_monthly').addEventListener('click', () => {
    purchaseProduct('pro_subscription_monthly');
});

            

              
                Copy
              
            
          

ধাপ ৫: কেনাকাটা পরিচালনা (লেনদেনের পরে)

একটি সফল ক্লায়েন্ট-সাইড লেনদেন গল্পের অর্ধেক মাত্র। আপনাকে এখন এনটাইটেলমেন্ট প্রদান করতে এবং লেনদেনটি সঠিকভাবে রেকর্ড করা হয়েছে তা নিশ্চিত করতে কেনাকাটাটি পরিচালনা করতে হবে।

কেনাকাটা পুনরুদ্ধার করা: ব্যবহারকারীরা আশা করে যে তাদের কেনাকাটা তাদের সমস্ত ডিভাইসে উপলব্ধ থাকবে। যখন একজন ব্যবহারকারী আপনার অ্যাপ খোলে, তখন আপনার বিদ্যমান এনটাইটেলমেন্টগুলো পরীক্ষা করা উচিত।

            async function restorePurchases(service) {
  if (!service) return;

  try {
    const existingPurchases = await service.listPurchases();
    for (const purchase of existingPurchases) {
        console.log(`Restoring purchase for SKU: ${purchase.itemId}`);
        // Verify each purchase token on your backend to prevent fraud
        // and grant the user the corresponding feature.
        await verifyPurchaseOnBackend(purchase.purchaseToken);
    }
  } catch (error) {
    console.error('Failed to restore purchases:', error);
  }
}

// Call this on app load for a signed-in user
await restorePurchases(digitalGoodsService);

            

              
                Copy
              
            
          

কনজিউম এবং অ্যাকনলেজ করা: এটি একটি গুরুত্বপূর্ণ পদক্ষেপ যা পেমেন্ট প্রোভাইডারকে জানায় যে আপনি লেনদেনটি প্রক্রিয়া করেছেন। এটি করতে ব্যর্থ হলে স্বয়ংক্রিয়ভাবে অর্থ ফেরত দেওয়া হতে পারে।

• `consume()`: এককালীন পণ্যগুলির জন্য ব্যবহার করুন যা আবার কেনা যেতে পারে। একবার কনজিউম করা হলে, আইটেমটি `listPurchases()` ফলাফল থেকে সরানো হয় এবং ব্যবহারকারী এটি আবার কিনতে পারে।
• `acknowledge()`: নন-কনজিউমেবল এবং নতুন সাবস্ক্রিপশনের জন্য ব্যবহার করুন। এটি নিশ্চিত করে যে আপনি আইটেমটি সরবরাহ করেছেন। এটি প্রতি পারচেজ টোকেনের জন্য একটি এককালীন ক্রিয়া।

            // This should be called AFTER successful backend verification

async function handlePostPurchase(service, purchaseToken, isConsumable) {
    if (!service) return;

    try {
        if (isConsumable) {
            await service.consume(purchaseToken);
            console.log('Purchase consumed successfully.');
        } else {
            await service.acknowledge(purchaseToken, 'developer_payload_string_optional');
            console.log('Purchase acknowledged successfully.');
        }
    } catch (error) {
        console.error('Error handling post-purchase action:', error);
    }
}

            

              
                Copy
              
            
          

অধ্যায় ৩: ব্যাকএন্ড ইন্টিগ্রেশন এবং নিরাপত্তা সংক্রান্ত সেরা অনুশীলন

কেনাকাটার বৈধতা যাচাই করার জন্য শুধুমাত্র ক্লায়েন্ট-সাইড কোডের উপর নির্ভর করা একটি বড় নিরাপত্তা ঝুঁকি। একজন দূষিত ব্যবহারকারী সহজেই জাভাস্ক্রিপ্ট ম্যানিপুলেট করে পেমেন্ট না করেই নিজেকে প্রিমিয়াম ফিচার দিতে পারে। আপনার ব্যাকএন্ড সার্ভার অবশ্যই ব্যবহারকারীর এনটাইটেলমেন্টের জন্য সত্যের একমাত্র উৎস হতে হবে।

কেন ব্যাকএন্ড ভেরিফিকেশন অপরিহার্য

• জালিয়াতি প্রতিরোধ: এটি নিশ্চিত করে যে ক্লায়েন্ট থেকে প্রাপ্ত একটি পারচেজ টোকেন বৈধ এবং এটি একটি প্রকৃত লেনদেনের জন্য আসল পেমেন্ট প্রোভাইডার দ্বারা তৈরি করা হয়েছে।
• নির্ভরযোগ্য এনটাইটেলমেন্ট ম্যানেজমেন্ট: আপনার সার্ভার, ক্লায়েন্ট নয়, ব্যবহারকারীর কোন ফিচারগুলোতে অ্যাক্সেস আছে তা ট্র্যাক করার জন্য দায়ী হওয়া উচিত। এটি টেম্পারিং প্রতিরোধ করে এবং ডিভাইস জুড়ে ধারাবাহিকতা নিশ্চিত করে।
• রিফান্ড এবং চার্জব্যাক হ্যান্ডলিং: পেমেন্ট প্রোভাইডার এপিআই আপনার ব্যাকএন্ডকে রিফান্ডের মতো লাইফসাইকেল ইভেন্ট সম্পর্কে জানাতে পারে, যা আপনাকে সংশ্লিষ্ট ডিজিটাল পণ্যের অ্যাক্সেস প্রত্যাহার করার অনুমতি দেয়।

ভেরিফিকেশন ফ্লো

নীচের ডায়াগ্রামটি একটি সুরক্ষিত ভেরিফিকেশন প্রক্রিয়া চিত্রিত করে:

ক্লায়েন্ট অ্যাপ → (১. পারচেজ টোকেন পাঠায়) → আপনার ব্যাকএন্ড সার্ভার → (২. টোকেন ভেরিফাই করে) → পেমেন্ট প্রোভাইডার এপিআই (যেমন, গুগল প্লে ডেভেলপার এপিআই) → (৩. ভ্যালিডেশন ফলাফল ফেরত দেয়) → আপনার ব্যাকএন্ড সার্ভার → (৪. এনটাইটেলমেন্ট প্রদান করে এবং নিশ্চিত করে) → ক্লায়েন্ট অ্যাপ

1. ক্লায়েন্ট-সাইড অ্যাপ একটি কেনাকাটা সম্পন্ন করে এবং একটি `purchaseToken` পায়।
2. ক্লায়েন্ট এই `purchaseToken` টি আপনার সুরক্ষিত ব্যাকএন্ড সার্ভারে পাঠায়।
3. আপনার ব্যাকএন্ড সার্ভার পেমেন্ট প্রোভাইডারের ভ্যালিডেশন এন্ডপয়েন্টে (যেমন, গুগল প্লে ডেভেলপার এপিআই-এর `purchases.products.get` বা `purchases.subscriptions.get` এন্ডপয়েন্ট) টোকেনটি পাস করে একটি সার্ভার-টু-সার্ভার এপিআই কল করে।
4. পেমেন্ট প্রোভাইডার কেনাকাটার স্থিতি (যেমন, কেনা হয়েছে, পেন্ডিং, বাতিল) সহ প্রতিক্রিয়া জানায়।
5. যদি কেনাকাটাটি বৈধ হয়, আপনার ব্যাকএন্ড আপনার ডাটাবেসে ব্যবহারকারীর অ্যাকাউন্ট আপডেট করে এনটাইটেলমেন্ট প্রদান করে (যেমন, `user.isPremium = true` সেট করে)।
6. আপনার ব্যাকএন্ড ক্লায়েন্টকে একটি সফল বার্তা দিয়ে প্রতিক্রিয়া জানায়। শুধুমাত্র এখন ক্লায়েন্টের `consume()` বা `acknowledge()` কল করা এবং UI আপডেট করা উচিত।

সাবস্ক্রিপশন এবং রিয়েল-টাইম নোটিফিকেশন পরিচালনা

সাবস্ক্রিপশনের একটি জটিল জীবনচক্র থাকে (নবায়ন, বাতিলকরণ, গ্রেস পিরিয়ড, পজ)। `listPurchases()` পোলিংয়ের উপর নির্ভর করা অদক্ষ। সেরা অনুশীলন হল রিয়েল-টাইম ডেভেলপার নোটিফিকেশনস (RTDN) বা ওয়েবহুক ব্যবহার করা।

আপনি আপনার ব্যাকএন্ড সার্ভারে একটি এন্ডপয়েন্ট কনফিগার করেন যা পেমেন্ট প্রোভাইডার যখনই কোনো সাবস্ক্রিপশনের স্থিতি পরিবর্তন হয় তখন কল করবে। এটি আপনাকে সক্রিয়ভাবে এনটাইটেলমেন্ট পরিচালনা করতে দেয়, যেমন একটি সাবস্ক্রিপশন বাতিল হলে অ্যাক্সেস প্রত্যাহার করা বা একটি নবায়ন চেষ্টার সময় পেমেন্ট ব্যর্থতা পরিচালনা করা।

অধ্যায় ৪: অ্যাডভান্সড টপিক এবং বৈশ্বিক বিবেচনাসমূহ

একাধিক পেমেন্ট প্রোভাইডার সাপোর্ট করা

যদিও গুগল প্লে স্টোর একটি প্রধান প্রোভাইডার, ডিজিটাল গুডস এপিআই একটি স্ট্যান্ডার্ড যা মাইক্রোসফ্ট স্টোরের মতো অন্যদের সাথে কাজ করার জন্য ডিজাইন করা হয়েছে। একটি সত্যিকারের গ্লোবাল PWA তৈরি করতে, আপনার কোডটি প্রোভাইডার-অজ্ঞেয়বাদী (provider-agnostic) হিসাবে ডিজাইন করা উচিত।

            // A conceptual approach to support multiple stores
const SUPPORTED_PROVIDERS = [
    'https://play.google.com/billing',
    'https://apps.microsoft.com/store/billing'
];

async function getFirstSupportedService() {
    if (!('getDigitalGoodsService' in window)) return null;

    for (const providerId of SUPPORTED_PROVIDERS) {
        try {
            const service = await window.getDigitalGoodsService(providerId);
            if (service) {
                console.log(`Connected to: ${providerId}`);
                return service; // Return the first one that connects
            }
        } catch (error) {
            // Ignore errors for providers that are not available
            console.log(`Could not connect to ${providerId}`);
        }
    }
    return null;
}

            

              
                Copy
              
            
          

লোকালাইজেশন এবং ইন্টারন্যাশনালাইজেশন

ডিজিটাল গুডস এপিআই-এর একটি মূল শক্তি হল লোকালাইজেশনের জন্য এর বিল্ট-ইন সাপোর্ট। `getDetails()` মেথডটি স্বয়ংক্রিয়ভাবে পণ্যের শিরোনাম, বিবরণ এবং মূল্য ব্যবহারকারীর স্থানীয় মুদ্রা এবং ভাষায় ফেরত দেয়, যা আপনি স্টোরের কনসোলে কনফিগার করেছেন। সর্বদা এপিআই দ্বারা ফেরত দেওয়া মূল্য অবজেক্টটি ব্যবহার করুন আপনার UI-তে মূল্য প্রদর্শন করার জন্য। কখনও সেগুলিকে হার্ডকোড করবেন না বা প্রদর্শনের উদ্দেশ্যে নিজের মুদ্রা রূপান্তর করবেন না।

ব্যবহারকারীর অভিজ্ঞতা (UX) সংক্রান্ত সেরা অনুশীলন

• স্বচ্ছতা: সম্পূর্ণ মূল্য এবং, সাবস্ক্রিপশনের জন্য, বিলিং ফ্রিকোয়েন্সি (`/মাস`, `/বছর`) স্পষ্টভাবে প্রদর্শন করুন।
• সরলতা: পারচেজ বাটনগুলো نمایاں করুন এবং ফ্লো যতটা সম্ভব সহজ করুন। এপিআই পেমেন্ট শীটের ভারী কাজগুলো পরিচালনা করে।
• কেনাকাটা পুনরুদ্ধার: আপনার অ্যাপের সেটিংসে একটি সহজে অ্যাক্সেসযোগ্য "Restore Purchases" বাটন সরবরাহ করুন। এটি ব্যবহারকারীদের আস্থা দেয় যে তারা তাদের কেনাকাটা হারাবে না।
• প্রতিক্রিয়া: প্রতিটি পর্যায়ে ব্যবহারকারীকে স্পষ্ট প্রতিক্রিয়া প্রদান করুন: যখন কেনাকাটা প্রক্রিয়াধীন থাকে, যখন এটি সফল হয়, এবং বিশেষ করে যখন এটি ব্যর্থ হয়।

উপসংহার: ওয়েব মনিটাইজেশনের ভবিষ্যৎ

ডিজিটাল গুডস এপিআই নেটিভ অ্যাপস এবং প্রগ্রেসিভ ওয়েব অ্যাপসের মধ্যে খেলার মাঠকে সমান করার দিকে একটি উল্লেখযোগ্য পদক্ষেপের প্রতিনিধিত্ব করে। ইন-অ্যাপ পারচেজের জন্য একটি প্রমিত, সুরক্ষিত এবং ব্যবহারকারী-বান্ধব প্রক্রিয়া সরবরাহ করে, এটি ওয়েব ডেভেলপারদের সরাসরি ওপেন ওয়েবে টেকসই ব্যবসায়িক মডেল তৈরি করতে সক্ষম করে।

এই এপিআই গ্রহণ করে এবং শক্তিশালী ব্যাকএন্ড ভেরিফিকেশন সহ নিরাপত্তা সংক্রান্ত সেরা অনুশীলনগুলো অনুসরণ করে, আপনি নির্বিঘ্ন মনিটাইজেশন অভিজ্ঞতা তৈরি করতে পারেন যা ব্যবহারকারীদের আনন্দিত করে এবং রাজস্ব বৃদ্ধি করে। PWA-এর গ্রহণ বাড়ার সাথে সাথে এবং আরও ডিজিটাল স্টোরফ্রন্ট এই স্ট্যান্ডার্ডটিকে সমর্থন করার সাথে, ডিজিটাল গুডস এপিআই প্রতিটি আধুনিক ওয়েব ডেভেলপারের টুলকিটে একটি অপরিহার্য সরঞ্জাম হয়ে উঠতে চলেছে, যা বিশ্বব্যাপী দর্শকদের জন্য ওয়েব প্ল্যাটফর্মের বাণিজ্যিক সম্ভাবনাকে সত্যিকারের আনলক করবে।