परीक्षकों से प्रतिक्रिया लीजिए

यह मार्गदर्शिका बताती है कि वैकल्पिक फायरबेस ऐप वितरण एंड्रॉइड एसडीके का उपयोग करके इन-ऐप फीडबैक कैसे सक्षम किया जाए, ताकि आपके परीक्षक सीधे ऐप में फीडबैक (स्क्रीनशॉट सहित) सबमिट कर सकें।

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

यदि आपने पहले से नहीं किया है, तो अपने एंड्रॉइड प्रोजेक्ट में फायरबेस जोड़ें

चरण 1: ऐप वितरण परीक्षक एपीआई सक्षम करें

  1. Google क्लाउड कंसोल खोलें और अपना फायरबेस प्रोजेक्ट चुनें।

  2. फायरबेस ऐप टेस्टर्स एपीआई के तहत, सक्षम करें पर क्लिक करें।

चरण 2: अपने ऐप में ऐप वितरण जोड़ें

ऐप वितरण एंड्रॉइड एसडीके में दो लाइब्रेरी शामिल हैं:

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

एपीआई-केवल लाइब्रेरी आपके कोड को एसडीके पर कॉल करने देती है। यदि पूर्ण एसडीके कार्यान्वयन मौजूद नहीं है तो कॉल का कोई प्रभाव नहीं पड़ता है।

  1. अपने मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल में ऐप वितरण एंड्रॉइड एसडीके के लिए निर्भरता की घोषणा करें (आमतौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle ).

  2. अपने Google Play बिल्ड में पूर्ण SDK कार्यान्वयन की स्व-अद्यतन कार्यक्षमता को शामिल करने से बचने के लिए, बिल्ड प्रकारों की पहचान करें, जिसमें बिल्ड प्रकार या उत्पाद स्वाद शामिल हैं जिन्हें आप ऐप वितरण के माध्यम से वितरित करेंगे।

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

    Kotlin+KTX

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

    Java

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

चरण 3: इन-ऐप फीडबैक कॉन्फ़िगर करें

अपने परीक्षकों से फीडबैक एकत्र करने के लिए, परीक्षकों को फीडबैक शुरू करने में सक्षम बनाने के लिए निम्नलिखित ट्रिगर्स में से एक का उपयोग करें:

  • अंतर्निहित अधिसूचना ट्रिगर : ऐप वितरण एंड्रॉइड एसडीके एक चालू अधिसूचना प्रदर्शित कर सकता है जिसे परीक्षक ऐप में कहीं से भी टैप कर सकता है। यदि आप अधिक तेज़ी से आरंभ करना चाहते हैं तो इस ट्रिगर का उपयोग करें और आपको अपने परीक्षकों द्वारा फीडबैक देने के तरीके को अनुकूलित करने की आवश्यकता नहीं है।

  • कस्टम ट्रिगर : आप अपना स्वयं का ट्रिगर तंत्र प्रदान कर सकते हैं, जैसे अपने ऐप में एक बटन या मेनू आइटम को टैप करना या डिवाइस को हिलाना।

जब आप इनमें से किसी भी ट्रिगर का उपयोग करते हैं और परीक्षक फीडबैक सबमिट करता है, तो एंड्रॉइड एसडीके निम्नलिखित क्रियाएं करता है:

  1. ऐप की वर्तमान गतिविधि का स्क्रीनशॉट कैप्चर करता है।

  2. यह सुनिश्चित करने के लिए जांच चलाता है कि परीक्षक ने एसडीके की परीक्षण सुविधाओं को सक्षम किया है। यदि परीक्षण सुविधाएं सक्षम नहीं हैं, तो एंड्रॉइड एसडीके परीक्षक को अपने Google खाते से ऐप वितरण में साइन इन करने के लिए संकेत देता है।

  3. एक पूर्ण-स्क्रीन गतिविधि प्रारंभ करता है जो परीक्षक को अपनी प्रतिक्रिया लिखने और सबमिट करने देता है।

विकल्प 1: अधिसूचना ट्रिगर

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

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

Kotlin+KTX

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

Java

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

विकल्प 2: कस्टम ट्रिगर

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

Kotlin+KTX

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

Java

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

चरण 4: अपना कार्यान्वयन बनाएं और परीक्षण करें

स्थानीय परीक्षण

पहले ऐप को वितरित किए बिना अपने कार्यान्वयन का परीक्षण करने के लिए, इन चरणों का पालन करें:

  1. अपने स्थानीय डिवाइस पर डेव मोड सक्षम करें:

    adb shell setprop debug.firebase.appdistro.devmode true
    
  2. अपने ऐप को एक प्री-रिलीज़ संस्करण के रूप में बनाएं जिसमें पूर्ण ऐप वितरण लाइब्रेरी शामिल हो, और परीक्षण करें कि आप चरण 3 में कार्यान्वित तंत्र का उपयोग करके फीडबैक ट्रिगर कर सकते हैं: इन-ऐप फीडबैक कॉन्फ़िगर करें । डेव मोड में होने पर फीडबैक सबमिट नहीं किया जाता है।

  3. परीक्षण के बाद, आप अपने डिवाइस पर डेव मोड को अक्षम कर सकते हैं:

    adb shell setprop debug.firebase.appdistro.devmode false
    

एंड-टू-एंड परीक्षण

यह जांचने के लिए कि आपका ऐप फीडबैक भेज सकता है, अपने ऐप को प्री-रिलीज़ संस्करण के रूप में बनाएं जिसमें पूर्ण ऐप वितरण लाइब्रेरी शामिल हों, और इन चरणों का पालन करके अपने कार्यान्वयन का परीक्षण करें:

  1. ऐप वितरण पर एक नया ऐप रिलीज़ अपलोड करें।

  2. ऐप रिलीज़ को उस खाते में वितरित करें जिसकी आपको एक्सेस करने की अनुमति है।

  3. ऐप डिस्ट्रीब्यूशन के वेब या एंड्रॉइड टेस्टर ऐप के माध्यम से ऐप डाउनलोड करें।

  4. चरण 3 में कार्यान्वित तंत्र का उपयोग करके फीडबैक ट्रिगर करें: इन-ऐप फीडबैक कॉन्फ़िगर करें

  5. सुनिश्चित करें कि आप उसी खाते से साइन इन हैं जिससे आपने ऐप रिलीज़ वितरित किया था, और फीडबैक सबमिट करें।

  6. फायरबेस कंसोल में नए रिलीज़ के कार्ड में अपना फीडबैक देखें।

सामान्य समस्याओं को हल करने का तरीका जानने के लिए, जैसे कि परीक्षक ऐप में फीडबैक शुरू करने में असमर्थ हैं, एसडीके के साथ परीक्षण सुविधाओं को सक्षम करना देखें।

चरण 5: परीक्षक प्रतिक्रिया प्रबंधित करें

अपने परीक्षकों को फीडबैक भेजने में सक्षम करने के बाद, आप उस फीडबैक की समीक्षा करने और उस पर कार्रवाई करने के लिए निम्नलिखित टूल का उपयोग कर सकते हैं:

फायरबेस कंसोल में फीडबैक देखें और हटाएं

आप फायरबेस कंसोल में एक विशिष्ट रिलीज के तहत टेस्टर फीडबैक टैब खोलकर स्क्रीनशॉट सहित उपयोगकर्ता फीडबैक की समीक्षा कर सकते हैं और हटा सकते हैं। उपयोगकर्ता फीडबैक को रिलीज़ द्वारा व्यवस्थित किया जाता है ताकि आप उस संस्करण की पुष्टि कर सकें जिस पर फीडबैक लागू होता है।

उपयोगकर्ता फीडबैक की समीक्षा करने के बाद, आप फीडबैक हटाएं बटन पर क्लिक करके उस फीडबैक को हटा सकते हैं। हटाई गई प्रतिक्रिया आपकी रिलीज़ से हटा दी गई है।

नई प्रतिक्रिया के लिए ईमेल अलर्ट प्राप्त करें

नए परीक्षक फीडबैक के बारे में सक्रिय रूप से जानने के लिए, जब कोई परीक्षक फीडबैक सबमिट करता है तो आप ईमेल अलर्ट प्राप्त कर सकते हैं। ईमेल अलर्ट में आपके परीक्षक द्वारा प्रदान की गई लिखित प्रतिक्रिया और उनके द्वारा सबमिट किए गए किसी भी स्क्रीनशॉट का लिंक शामिल होता है।

इस डिफ़ॉल्ट तंत्र के माध्यम से ऐप वितरण ईमेल अलर्ट प्राप्त करने के लिए, आपके पास firebase.projects.update अनुमति होनी चाहिए। निम्नलिखित भूमिकाओं में डिफ़ॉल्ट रूप से यह आवश्यक अनुमति शामिल है: फायरबेस एडमिन या प्रोजेक्ट स्वामी या संपादक

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

ईमेल अलर्ट अक्षम करने के लिए, फायरबेस अलर्ट प्राप्त करें देखें।

तृतीय-पक्ष टूल को नई प्रतिक्रिया भेजें

आप फायरबेस के लिए क्लाउड फ़ंक्शंस का उपयोग करके अपनी टीम के पसंदीदा अधिसूचना चैनल पर ऐप वितरण अलर्ट भी भेज सकते हैं। उदाहरण के लिए, आप एक फ़ंक्शन लिख सकते हैं जो नए इन-ऐप फीडबैक के लिए अलर्ट ईवेंट कैप्चर करता है और अलर्ट जानकारी को डिस्कॉर्ड, स्लैक या जीरा जैसी तृतीय-पक्ष सेवा पर पोस्ट करता है।

फायरबेस के लिए क्लाउड फ़ंक्शंस का उपयोग करके उन्नत अलर्टिंग क्षमताएं स्थापित करने के लिए, इन चरणों का पालन करें:

  1. फायरबेस के लिए क्लाउड फ़ंक्शंस सेट करें , जिसमें निम्नलिखित कार्य शामिल हैं:

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

    2. इंस्टॉल करें और फायरबेस सीएलआई में साइन इन करें।

    3. फायरबेस सीएलआई का उपयोग करके फायरबेस के लिए क्लाउड फ़ंक्शंस प्रारंभ करें।

  2. एक फ़ंक्शन लिखें और तैनात करें जो ऐप डिस्ट्रीब्यूशन से इन-ऐप फीडबैक अलर्ट इवेंट को कैप्चर करता है और इवेंट पेलोड को संभालता है (उदाहरण के लिए, डिस्कॉर्ड पर एक संदेश में अलर्ट जानकारी पोस्ट करता है)।

एक उदाहरण फ़ंक्शन देखने के लिए जो आपको दिखाता है कि जिरा को नई प्रतिक्रिया कैसे भेजें, इस नमूने को देखें।

उन सभी अलर्ट घटनाओं के बारे में जानने के लिए जिन्हें आप कैप्चर कर सकते हैं, ऐप वितरण अलर्ट के लिए संदर्भ दस्तावेज़ देखें।