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

इस गाइड में, Firebase App Distribution Android SDK टूल का इस्तेमाल करके, ऐप्लिकेशन में सुझाव/राय देने या शिकायत करने की सुविधा चालू करने का तरीका बताया गया है. इससे, टेस्टर सीधे ऐप्लिकेशन में सुझाव/राय दे सकते हैं या शिकायत कर सकते हैं. साथ ही, स्क्रीनशॉट भी सबमिट कर सकते हैं. हालांकि, इस 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. मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle) में, App Distribution Android SDK के लिए डिपेंडेंसी का एलान करें.

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-beta21")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta21")
   }

   Java

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

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

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

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

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

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

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

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

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

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

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

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

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

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);

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

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

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

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 console में, नई रिलीज़ के कार्ड में अपना सुझाव/राय देखें.

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

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

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

• Firebase console

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

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

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 चेतावनियों के लिए रेफ़रंस दस्तावेज़ देखें.