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

इस गाइड में, 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. यह जांच करता है कि टेस्टर ने एसडीके की टेस्टिंग सुविधाएं चालू की हैं या नहीं. अगर टेस्टिंग की सुविधाएं चालू नहीं हैं, तो 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 कंसोल

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

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

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