टेस्टर से सुझाव पाना

इस गाइड में, Firebase App Distribution Android SDK का इस्तेमाल करके, ऐप्लिकेशन में सुझाव/राय देने या शिकायत करने की सुविधा चालू करने का तरीका बताया गया है. इससे टेस्टर, ऐप्लिकेशन में सीधे तौर पर सुझाव/राय दे सकते हैं या शिकायत कर सकते हैं. इसमें स्क्रीनशॉट भी शामिल हैं.

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

अगर आपने पहले से ही A/B टेस्टिंग नहीं बनाई है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें.

पहला चरण: App Distribution Tester API चालू करना

1. Google Cloud कंसोल खोलें और अपना Firebase प्रोजेक्ट चुनें.

2. Firebase App Testers API में जाकर, चालू करें पर क्लिक करें.

दूसरा चरण: अपने ऐप्लिकेशन में App Distribution जोड़ना

App Distribution Android SDK में दो लाइब्रेरी होती हैं:

• firebase-appdistribution-api: एपीआई-ओनली लाइब्रेरी, जिसे सभी बिल्ड वैरिएंट में शामिल किया जा सकता है.
• firebase-appdistribution: एसडीके टूल को पूरी तरह से लागू करना (ज़रूरी नहीं).

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

1. App Distribution Android SDK के लिए डिपेंडेंसी का एलान करें. इसके लिए, मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle) का इस्तेमाल करें.

2. Google Play पर उपलब्ध अपने ऐप्लिकेशन के बिल्ड में, SDK टूल के पूरे वर्शन को लागू करने की सुविधा को शामिल न करने के लिए, बिल्ड के उन वैरिएंट की पहचान करें जिन्हें App Distribution के ज़रिए डिस्ट्रिब्यूट किया जाएगा. इनमें बिल्ड टाइप या प्रॉडक्ट फ़्लेवर शामिल हैं.

3. अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर app/build.gradle) में App Distribution Android SDK के लिए डिपेंडेंसी का एलान करें. सिर्फ़ उन वैरिएंट में एसडीके को पूरी तरह से लागू करें जिन्हें सिर्फ़ रिलीज़ से पहले की टेस्टिंग के लिए बनाया गया है:

   Kotlin

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta20")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta20")
   }

   Java

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta20")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta20")
   }

क्या आपको Kotlin के लिए कोई लाइब्रेरी मॉड्यूल चाहिए? अक्टूबर 2023 में रिलीज़ हुए वर्शन से, Kotlin और Java, दोनों के डेवलपर, मुख्य लाइब्रेरी मॉड्यूल पर निर्भर हो सकते हैं. ज़्यादा जानकारी के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले सवाल देखें.

तीसरा चरण: ऐप्लिकेशन में फ़ीडबैक देने की सुविधा कॉन्फ़िगर करना

टेस्टर से सुझाव या राय पाने के लिए, इनमें से किसी ट्रिगर का इस्तेमाल करें, ताकि टेस्टर सुझाव या राय दे सकें:

• सूचना ट्रिगर करने की सुविधा: App Distribution Android SDK, एक बैकग्राउंड में जारी गतिविधि की सूचना दिखा सकता है. टेस्टर, ऐप्लिकेशन में कहीं से भी इस सूचना पर टैप कर सकता है. अगर आपको जल्दी से शुरू करना है और आपको यह तय नहीं करना है कि टेस्टर कैसे सुझाव/राय देंगे या शिकायत करेंगे, तो इस ट्रिगर का इस्तेमाल करें.

• कस्टम ट्रिगर: आपके पास अपना ट्रिगर मैकेनिज़्म उपलब्ध कराने का विकल्प होता है. जैसे, अपने ऐप्लिकेशन में किसी बटन या मेन्यू आइटम पर टैप करना या डिवाइस को हिलाना.

इनमें से किसी भी ट्रिगर का इस्तेमाल करने पर, जब टेस्टर सुझाव/राय देता है या शिकायत करता है, तो Android SDK ये कार्रवाइयां करता है:

1. ऐप्लिकेशन की मौजूदा गतिविधि का स्क्रीनशॉट कैप्चर करता है.

2. यह कुकी, यह पक्का करने के लिए जांच करती है कि टेस्टर ने एसडीके की टेस्टिंग की सुविधाएं चालू की हैं. अगर टेस्टिंग की सुविधाएं चालू नहीं हैं, तो Android SDK, टेस्टर को App Distribution में अपने Google खाते से साइन इन करने के लिए कहता है.

3. यह फ़ुल-स्क्रीन गतिविधि शुरू करता है. इससे टेस्टर, अपना सुझाव/राय लिख और सबमिट कर सकते हैं.

पहला विकल्प: सूचना ट्रिगर करने वाले इवेंट

showFeedbackNotification() का इस्तेमाल करके, टेस्टर के डिवाइस पर एक सूचना दिखाएं. यह सूचना, लगातार दिखती रहेगी. टेस्टर इस सूचना पर टैप करके, सुझाव/राय दे सकता है या शिकायत कर सकता है. सूचना को कॉन्फ़िगर करते समय, आपको कुछ टेक्स्ट देना होगा. यह टेक्स्ट, टेस्टर को सुझाव/राय देने या शिकायत सबमिट करने से पहले दिखेगा. साथ ही, आपको सूचना के लिए रुकावट का लेवल भी तय करना होगा. यह लेवल, सूचना चैनल की अहमियत के हिसाब से तय किया जाता है. अगर आपको टेस्टर को उनके सुझाव/राय या शिकायत के डेटा को इकट्ठा करने और प्रोसेस करने के बारे में सूचना देनी है, तो इस टेक्स्ट का इस्तेमाल करके सूचना दी जा सकती है.

showFeedbackNotification() का इस्तेमाल करने पर और ऐप्लिकेशन के बैकग्राउंड में जाने पर, सूचना छिप जाती है. अगर आपको सूचना को पूरी तरह से छिपाना है, तो cancelFeedbackNotification() का इस्तेमाल करें. हमारा सुझाव है कि आप showFeedbackNotification() को अपनी मुख्य गतिविधि के onCreate() में रखें.

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Firebase.appDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH)
    }
}

public class MainActivity extends AppCompatActivity {
    FirebaseAppDistribution firebaseAppDistribution =
        FirebaseAppDistribution.getInstance();
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        firebaseAppDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH);
    }
}

दूसरा विकल्प: कस्टम ट्रिगर

अपनी पसंद के तरीके से सुझाव/राय देने या शिकायत करने के लिए, startFeedback() तरीके का इस्तेमाल करें. उदाहरण के लिए, सुझाव/राय/शिकायत भेजने की सुविधा को ट्रिगर करने के लिए, अपने ऐप्लिकेशन के ऐक्शन मेन्यू में "सुझाव/राय/शिकायत भेजें" मेन्यू आइटम जोड़ा जा सकता है. इसके अलावा, टेस्टर को डिवाइस हिलाने या स्क्रीनशॉट लेने की सुविधा दी जा सकती है. सुझाव/राय देने या शिकायत करने की सुविधा चालू करने पर, ऐसा टेक्स्ट डालें जो टेस्टर को सुझाव/राय देने या शिकायत करने से पहले दिखे. अगर आपको अपने टेस्टर को उनके सुझाव/राय या शिकायत के डेटा को इकट्ठा करने और प्रोसेस करने के बारे में सूचना देनी है, तो इस टेक्स्ट का इस्तेमाल करके सूचना दी जा सकती है.

Firebase.appDistribution.startFeedback(R.string.feedbackMessage)

FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);

चौथा चरण: लागू किए गए बदलावों को बनाना और उनकी जांच करना

लोकल टेस्टिंग

ऐप्लिकेशन को डिस्ट्रिब्यूट किए बिना, लागू करने की प्रोसेस को टेस्ट करने के लिए, यह तरीका अपनाएं:

1. अपने लोकल डिवाइस पर डेवलपर मोड चालू करें:

   adb shell setprop debug.firebase.appdistro.devmode true

2. अपने ऐप्लिकेशन को प्री-रिलीज़ वर्शन के तौर पर बनाएं. इसमें पूरी App Distribution लाइब्रेरी शामिल होनी चाहिए. साथ ही, यह जांच करें कि तीसरा चरण: ऐप्लिकेशन में सुझाव/राय देने या शिकायत करने की सुविधा कॉन्फ़िगर करना में लागू किए गए तरीके का इस्तेमाल करके, सुझाव/राय देने या शिकायत करने की सुविधा को ट्रिगर किया जा सकता है. डेवलपर मोड में होने पर, सुझाव/राय या शिकायत सबमिट नहीं की जाती.

3. टेस्टिंग के बाद, अपने डिवाइस पर डेवलपर मोड बंद किया जा सकता है:

   adb shell setprop debug.firebase.appdistro.devmode false

शुरू से आखिर तक की टेस्टिंग

यह जांच करने के लिए कि आपका ऐप्लिकेशन सुझाव/राय/शिकायत भेज सकता है, अपने ऐप्लिकेशन को रिलीज़ से पहले के वर्शन के तौर पर बनाएं. इसमें पूरी App Distribution लाइब्रेरी शामिल होनी चाहिए. इसके बाद, इन चरणों का पालन करके, अपने ऐप्लिकेशन को लागू करने की जांच करें:

1. App Distribution पर ऐप्लिकेशन का नया वर्शन अपलोड करें.

2. ऐप्लिकेशन की रिलीज़ को उस खाते में डिस्ट्रिब्यूट करें जिसे ऐक्सेस करने की अनुमति आपके पास है.

3. App Distribution की वेबसाइट या Android टेस्टर ऐप्लिकेशन से ऐप्लिकेशन डाउनलोड करें.

4. तीसरा चरण: ऐप्लिकेशन में सुझाव/राय देने या शिकायत करने की सुविधा कॉन्फ़िगर करना में लागू किए गए तरीके का इस्तेमाल करके, सुझाव/राय दें या शिकायत करें.

5. पक्का करें कि आपने उसी खाते से साइन इन किया हो जिससे आपने ऐप्लिकेशन रिलीज़ को डिस्ट्रिब्यूट किया था. इसके बाद, सुझाव/राय दें या शिकायत करें.

6. Firebase कंसोल में, नई रिलीज़ के कार्ड में अपना सुझाव/राय या शिकायत देखें.

सामान्य समस्याओं को हल करने का तरीका जानने के लिए, एसडीके की मदद से टेस्टिंग की सुविधाएं चालू करना लेख पढ़ें. जैसे, टेस्टर को ऐप्लिकेशन में सुझाव/राय देने या शिकायत करने की सुविधा नहीं मिल रही है.

पांचवां चरण: टेस्टर के सुझाव/राय या शिकायतें मैनेज करना

टेस्टर को सुझाव/राय देने या शिकायत करने की सुविधा चालू करने के बाद, इन टूल का इस्तेमाल करके सुझाव/राय या शिकायत की समीक्षा की जा सकती है और उन पर कार्रवाई की जा सकती है:

• Firebase कंसोल

• नए सुझाव, शिकायत या राय के लिए ईमेल से सूचनाएं पाना

• तीसरे पक्ष के टूल

Firebase कंसोल में जाकर सुझाव/राय देखें और मिटाएं

Firebase Console में किसी रिलीज़ के नीचे मौजूद, टेस्टर के सुझाव, शिकायत या राय टैब खोलकर, उपयोगकर्ताओं के सुझाव, शिकायत या राय देखी जा सकती है. साथ ही, स्क्रीनशॉट के साथ-साथ इन्हें मिटाया भी जा सकता है. उपयोगकर्ता के सुझाव, शिकायत या राय को रिलीज़ के हिसाब से व्यवस्थित किया जाता है, ताकि यह पुष्टि की जा सके कि सुझाव, शिकायत या राय किस वर्शन पर लागू होती है.

उपयोगकर्ता के सुझाव/राय या शिकायत की समीक्षा करने के बाद, सुझाव/राय या शिकायत मिटाएं बटन पर क्लिक करके, उसे मिटाया जा सकता है. मिटाया गया सुझाव, राय या शिकायत आपकी रिलीज़ से हटा दी जाती है.

नए सुझाव/राय या शिकायत के लिए ईमेल सूचनाएं पाएं

टेस्टर से मिले नए सुझाव/राय के बारे में पहले से जानने के लिए, टेस्टर के सुझाव/राय सबमिट करने पर आपको ईमेल सूचनाएं मिल सकती हैं. ईमेल से मिलने वाली सूचना में, टेस्टर से मिला लिखित सुझाव/राय या शिकायत शामिल होती है. साथ ही, इसमें सबमिट किए गए स्क्रीनशॉट का लिंक भी होता है.

डिफ़ॉल्ट तरीके का इस्तेमाल करके, App Distribution की ईमेल सूचनाएं पाने के लिए, आपके पास firebase.projects.update की अनुमति होनी चाहिए. इन भूमिकाओं में, यह ज़रूरी अनुमति डिफ़ॉल्ट रूप से शामिल होती है: Firebase एडमिन या प्रोजेक्ट का मालिक या एडिटर.

डिफ़ॉल्ट रूप से, प्रोजेक्ट के हर उस सदस्य को ईमेल मिलेगा जिसके पास ईमेल सूचनाएं पाने की ज़रूरी अनुमतियां हैं. ऐसा तब होगा, जब नई शिकायत सबमिट की जाएगी. प्रोजेक्ट के सदस्य, इन सूचनाओं से अलग-अलग ऑप्ट आउट कर सकते हैं.

ईमेल से सूचनाएं पाने की सुविधा बंद करने के लिए, Firebase से सूचनाएं पाना लेख पढ़ें.

तीसरे पक्ष के टूल को नया सुझाव/राय भेजें या शिकायत करें

Cloud Functions for Firebase का इस्तेमाल करके, अपनी टीम के पसंदीदा सूचना चैनल पर App Distribution सूचनाएं भी भेजी जा सकती हैं. उदाहरण के लिए, एक ऐसा फ़ंक्शन लिखा जा सकता है जो ऐप्लिकेशन में मिले नए सुझाव, शिकायत या राय के लिए सूचना इवेंट को कैप्चर करता है. साथ ही, सूचना की जानकारी को तीसरे पक्ष की सेवा पर पोस्ट करता है. जैसे, Discord, Slack या Jira.

Cloud Functions for Firebase का इस्तेमाल करके, सूचना पाने की बेहतर सुविधाएं सेट अप करने के लिए, यह तरीका अपनाएं:

1. Cloud Functions for Firebase सेट अप करें. इसमें ये टास्क शामिल हैं:

   1. Node.js और npm डाउनलोड करें.

   2. Firebase सीएलआई को इंस्टॉल करें और उसमें साइन इन करें.

   3. Firebase सीएलआई का इस्तेमाल करके, Cloud Functions for Firebase को शुरू करें.

2. एक फ़ंक्शन लिखें और उसे डिप्लॉय करें. यह फ़ंक्शन, App Distribution से ऐप्लिकेशन में मौजूद सुझाव/राय देने या शिकायत करने की सुविधा से जुड़ी सूचना वाले इवेंट को कैप्चर करता है. साथ ही, इवेंट के पेलोड को मैनेज करता है. उदाहरण के लिए, सूचना की जानकारी को Discord पर मैसेज के तौर पर पोस्ट करता है.

Jira को नया सुझाव/राय भेजने का तरीका बताने वाले फ़ंक्शन का उदाहरण देखने के लिए, इस फ़ंक्शन के सैंपल पर जाएं.

कैप्चर किए जा सकने वाले सभी सूचना इवेंट के बारे में जानने के लिए, App Distribution सूचनाओं का रेफ़रंस दस्तावेज़ देखें.