รวบรวมข้อเสนอแนะจากผู้ทดสอบ

คู่มือนี้จะอธิบายวิธีเปิดใช้ความคิดเห็นในแอปโดยใช้ Firebase App Distribution Android SDK ที่ไม่บังคับ เพื่อให้ผู้ทดสอบส่งความคิดเห็น (รวมถึงภาพหน้าจอ) ในแอปได้โดยตรง

ก่อนที่คุณจะเริ่ม

หากคุณยังไม่ได้ เพิ่ม Firebase ในโครงการ Android ของคุณ

ขั้นตอนที่ 1: เปิดใช้งาน App Distribution Tester API

  1. เปิด Google Cloud Console และเลือกโปรเจ็กต์ Firebase ของคุณ

  2. ใต้ Firebase App Tests API คลิก เปิดใช้งาน

ขั้นตอนที่ 2: เพิ่ม App Distribution ไปยังแอปของคุณ

App Distribution Android SDK ประกอบด้วยสองไลบรารี:

  • firebase-appdistribution-api : ไลบรารีเฉพาะ API ซึ่งคุณสามารถรวมไว้ใน เวอร์ชันบิวด์ ทั้งหมดได้
  • firebase-appdistribution : การใช้งาน SDK เต็มรูปแบบ (ไม่บังคับ)

ไลบรารีเฉพาะ API ช่วยให้โค้ดของคุณทำการเรียก SDK ได้ การเรียกจะไม่มีผลหากไม่มีการใช้งาน SDK แบบเต็ม

  1. ประกาศการพึ่งพาสำหรับ App Distribution Android SDK ในไฟล์ Gradle ของโมดูล (ระดับแอป) ของคุณ (โดยปกติคือ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle ).

  2. หากต้องการหลีกเลี่ยงการรวมฟังก์ชันการอัปเดตด้วยตนเองของการใช้งาน SDK เต็มรูปแบบในบิลด์ Google Play ของคุณ ให้ระบุเวอร์ชันของบิลด์ รวมถึง ประเภทบิลด์ หรือ รสชาติผลิตภัณฑ์ ที่คุณจะเผยแพร่ผ่าน App Distribution

  3. ประกาศการพึ่งพาสำหรับ App Distribution Android SDK ใน ไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ app/build.gradle ) เพิ่มการใช้งาน SDK เต็มรูปแบบให้กับตัวแปรที่มีไว้เพื่อการทดสอบก่อนเผยแพร่โดยเฉพาะเท่านั้น:

    Kotlin+KTX

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

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

    Java

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

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

ขั้นตอนที่ 3: กำหนดค่าความคิดเห็นในแอป

หากต้องการรวบรวมความคิดเห็นจากผู้ทดสอบ ให้ใช้ทริกเกอร์ต่อไปนี้เพื่อให้ผู้ทดสอบเริ่มต้นความคิดเห็นได้:

  • ทริกเกอร์การแจ้งเตือนในตัว : App Distribution Android SDK สามารถแสดงการแจ้งเตือนต่อเนื่องที่ผู้ทดสอบสามารถแตะได้จากทุกที่ในแอป ใช้ทริกเกอร์นี้หากคุณต้องการเริ่มต้นได้รวดเร็วยิ่งขึ้น และคุณไม่จำเป็นต้องปรับแต่งวิธีที่ผู้ทดสอบให้ข้อเสนอแนะ

  • ทริกเกอร์แบบกำหนดเอง : คุณสามารถจัดเตรียมกลไกทริกเกอร์ของคุณเองได้ เช่น การแตะปุ่มหรือรายการเมนูในแอปของคุณ หรือการเขย่าอุปกรณ์

เมื่อคุณใช้ทริกเกอร์อย่างใดอย่างหนึ่งเหล่านี้และผู้ทดสอบส่งความคิดเห็น Android SDK จะดำเนินการดังต่อไปนี้:

  1. จับภาพหน้าจอของกิจกรรมปัจจุบันของแอป

  2. ดำเนินการตรวจสอบเพื่อให้แน่ใจว่าผู้ทดสอบเปิดใช้ฟีเจอร์การทดสอบของ SDK หากไม่ได้เปิดใช้ฟีเจอร์การทดสอบ Android SDK จะแจ้งให้ผู้ทดสอบลงชื่อเข้าใช้ App Distribution ด้วยบัญชี Google ของตน

  3. เริ่มกิจกรรมแบบเต็มหน้าจอเพื่อให้ผู้ทดสอบเขียนและส่งความคิดเห็นได้

ตัวเลือกที่ 1: ทริกเกอร์การแจ้งเตือน

ใช้ showFeedbackNotification() เพื่อแสดงการแจ้งเตือนอย่างต่อเนื่องหรือ ต่อเนื่อง บนอุปกรณ์ของผู้ทดสอบว่าพวกเขาสามารถแตะเพื่อเริ่มข้อเสนอแนะได้ เมื่อคุณกำหนดค่าการแจ้งเตือน คุณจะต้องระบุข้อความที่จะแสดงต่อผู้ทดสอบก่อนที่จะส่งข้อเสนอแนะ และระดับการหยุดชะงักของการแจ้งเตือน (ซึ่งสอดคล้องกับ ความสำคัญ ของช่องทางการแจ้งเตือน ) หากคุณต้องการแจ้งผู้ทดสอบเกี่ยวกับการรวบรวมและการประมวลผลข้อมูลคำติชม คุณสามารถใช้ข้อความเพื่อแจ้งดังกล่าวได้

เมื่อคุณใช้ showFeedbackNotification() และเมื่อแอปไปที่พื้นหลัง การแจ้งเตือนจะถูกซ่อน หากคุณต้องการซ่อนการแจ้งเตือนอย่างชัดเจน ให้ใช้ cancelFeedbackNotification() เราขอแนะนำให้คุณใส่ showFeedbackNotification() ไว้ใน onCreate() ของกิจกรรมหลักของคุณ

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. เปิดใช้งานโหมด dev บนอุปกรณ์ท้องถิ่นของคุณ:

    adb shell setprop debug.firebase.appdistro.devmode true

  2. สร้างแอปของคุณเป็นเวอร์ชันก่อนเผยแพร่ที่มีไลบรารี App Distribution เต็มรูปแบบ และทดสอบว่าคุณสามารถกระตุ้นความคิดเห็นได้โดยใช้กลไกที่ใช้ใน ขั้นตอนที่ 3: กำหนดค่าความคิดเห็นในแอป ข้อเสนอแนะจะไม่ถูกส่งเมื่ออยู่ในโหมดการพัฒนา

  3. หลังการทดสอบ คุณสามารถปิดใช้งานโหมดนักพัฒนาซอฟต์แวร์บนอุปกรณ์ของคุณได้:

    adb shell setprop debug.firebase.appdistro.devmode false

การทดสอบแบบครบวงจร

หากต้องการทดสอบว่าแอปของคุณสามารถส่งความคิดเห็นได้หรือไม่ ให้สร้างแอปของคุณเป็นเวอร์ชันก่อนเผยแพร่ที่มีไลบรารี App Distribution เต็มรูปแบบ และทดสอบการใช้งานของคุณโดยทำตามขั้นตอนเหล่านี้

  1. อัปโหลดแอปออกใหม่ไปยัง App Distribution

  2. เผยแพร่แอปไปยังบัญชีที่คุณมีสิทธิ์เข้าถึง

  3. ดาวน์โหลดแอปผ่านเว็บของ App Distribution หรือแอปทดสอบ Android

  4. กระตุ้นความคิดเห็นโดยใช้กลไกที่ใช้ใน ขั้นตอนที่ 3: กำหนดค่าความคิดเห็นในแอป

  5. ตรวจสอบให้แน่ใจว่าคุณลงชื่อเข้าใช้ด้วยบัญชีเดียวกับที่คุณเผยแพร่แอปให้ และส่งข้อเสนอแนะ

  6. ดูความคิดเห็นของคุณในการ์ดรุ่นใหม่ใน คอนโซล Firebase

หากต้องการเรียนรู้วิธีแก้ไขปัญหาทั่วไป เช่น ผู้ทดสอบไม่สามารถเริ่มแสดงความคิดเห็นในแอปได้ โปรดดู ที่การเปิดใช้ฟีเจอร์การทดสอบด้วย SDK

ขั้นตอนที่ 5: จัดการความคิดเห็นของผู้ทดสอบ

หลังจากที่คุณเปิดให้ผู้ทดสอบส่งความคิดเห็นแล้ว คุณจะใช้เครื่องมือต่อไปนี้เพื่อตรวจสอบและดำเนินการกับความคิดเห็นนั้นได้:

ดูและลบความคิดเห็นในคอนโซล Firebase

คุณสามารถตรวจสอบและลบความคิดเห็นของผู้ใช้ รวมถึงภาพหน้าจอ ได้โดยเปิดแท็บ ความคิดเห็นของผู้ทดสอบ ใต้รุ่นเฉพาะในคอนโซล Firebase ความคิดเห็นของผู้ใช้จะจัดเรียงตามรุ่นเพื่อให้คุณยืนยันเวอร์ชันที่นำความคิดเห็นไปใช้ได้

หลังจากตรวจสอบความคิดเห็นของผู้ใช้แล้ว คุณสามารถลบความคิดเห็นนั้นได้โดยคลิกปุ่ม ลบความคิดเห็น ความคิดเห็นที่ถูกลบจะถูกลบออกจากรุ่นของคุณ

รับการแจ้งเตือนทางอีเมลสำหรับข้อเสนอแนะใหม่

หากต้องการเรียนรู้เชิงรุกเกี่ยวกับความคิดเห็นของผู้ทดสอบใหม่ คุณสามารถรับการแจ้งเตือนทางอีเมลเมื่อผู้ทดสอบส่งความคิดเห็น การแจ้งเตือนทางอีเมลประกอบด้วยความคิดเห็นที่เป็นลายลักษณ์อักษรที่ผู้ทดสอบของคุณให้ไว้ และลิงก์ไปยังภาพหน้าจอใดๆ ที่พวกเขาส่งมา

หากต้องการรับการแจ้งเตือนทางอีเมล App Distribution ผ่านกลไกเริ่มต้นนี้ คุณต้องมีสิทธิ์ firebase.projects.update บทบาทต่อไปนี้มีสิทธิ์ที่จำเป็นตามค่าเริ่มต้น: ผู้ดูแลระบบ Firebase หรือ เจ้าของโครงการหรือผู้แก้ไข

ตามค่าเริ่มต้น สมาชิกโครงการทุกคนที่มีสิทธิ์ที่จำเป็นในการรับการแจ้งเตือนทางอีเมลจะได้รับอีเมลเมื่อมีการส่งรายงานคำติชมใหม่ สมาชิกโครงการสามารถเลือกไม่รับการแจ้งเตือนเหล่านี้ได้เป็นรายบุคคล

หากต้องการปิดใช้งานการแจ้งเตือนทางอีเมล โปรดดู ที่รับการแจ้งเตือน Firebase

ส่งข้อเสนอแนะใหม่ไปยังเครื่องมือของบุคคลที่สาม

คุณยังสามารถส่งการแจ้งเตือน App Distribution ไปยังช่องทางการแจ้งเตือนที่ทีมของคุณต้องการโดยใช้ Cloud Functions for Firebase ตัวอย่างเช่น คุณสามารถเขียนฟังก์ชันที่รวบรวมเหตุการณ์การแจ้งเตือนสำหรับคำติชมใหม่ในแอป และโพสต์ข้อมูลการแจ้งเตือนไปยังบริการของบุคคลที่สาม เช่น Discord, Slack หรือ Jira

หากต้องการตั้งค่าความสามารถในการแจ้งเตือนขั้นสูงโดยใช้ฟังก์ชันคลาวด์สำหรับ Firebase ให้ทำตามขั้นตอนเหล่านี้:

  1. ตั้งค่า Cloud Functions สำหรับ Firebase ซึ่งประกอบด้วยงานต่อไปนี้:

    1. ดาวน์โหลด Node.js และ npm

    2. ติดตั้งและลงชื่อเข้าใช้ Firebase CLI

    3. เริ่มต้นฟังก์ชันคลาวด์สำหรับ Firebase โดยใช้ Firebase CLI

  2. เขียนและปรับใช้ฟังก์ชัน ที่รวบรวมเหตุการณ์การแจ้งเตือนข้อเสนอแนะในแอปจาก App Distribution และจัดการเพย์โหลดของเหตุการณ์ (เช่น โพสต์ข้อมูลการแจ้งเตือนในข้อความบน Discord)

หากต้องการดูฟังก์ชันตัวอย่างที่แสดงวิธีส่งความคิดเห็นใหม่ถึง Jira โปรดดู ตัวอย่างนี้

หากต้องการเรียนรู้เกี่ยวกับเหตุการณ์การแจ้งเตือนทั้งหมดที่คุณสามารถบันทึกได้ โปรดดูเอกสารอ้างอิงสำหรับ การแจ้งเตือน App Distribution