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

इस गाइड में, 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 बिल्ड में, एसडीके के पूरे वर्शन को लागू करने की सुविधा शामिल न करने के लिए, बिल्ड के उन वैरिएंट की पहचान करें जिन्हें App Distribution के ज़रिए डिस्ट्रिब्यूट किया जाएगा. इनमें बिल्ड टाइप या प्रॉडक्ट फ़्लेवर शामिल हैं.

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

    Kotlin 

    dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta15")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta16")
}

    Java 

    dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta16")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta16")
}

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

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

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

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

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

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

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

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

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

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

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

Kotlin 

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

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

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

Kotlin 

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

Java 

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 Console में किसी रिलीज़ के नीचे मौजूद टेस्टर का सुझाव/राय टैब खोलकर, उपयोगकर्ता के सुझाव/राय की समीक्षा की जा सकती है और उन्हें मिटाया जा सकता है. इसमें स्क्रीनशॉट भी शामिल हैं. उपयोगकर्ता के सुझाव, शिकायत या राय को रिलीज़ के हिसाब से व्यवस्थित किया जाता है, ताकि यह पुष्टि की जा सके कि सुझाव, शिकायत या राय किस वर्शन पर लागू होती है.

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

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

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

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

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

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

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

App Distribution का इस्तेमाल करके, अपनी टीम के पसंदीदा सूचना चैनल पर App Distribution सूचनाएं भी भेजी जा सकती हैं.Cloud Functions for Firebase उदाहरण के लिए, एक ऐसा फ़ंक्शन लिखा जा सकता है जो ऐप्लिकेशन में नए सुझाव, शिकायत या राय के लिए सूचना वाले इवेंट को कैप्चर करता है. साथ ही, सूचना की जानकारी को 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 सूचनाओं का रेफ़रंस दस्तावेज़ देखें.