รวบรวมความคิดเห็นจากผู้ทดสอบ

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

ก่อนเริ่มต้น

เพิ่ม Firebase ลงในโปรเจ็กต์ Android หากยังไม่ได้เพิ่ม

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

  1. เปิดคอนโซล Google Cloud แล้วเลือกโปรเจ็กต์ Firebase

  2. คลิกเปิดใช้ในส่วน Firebase App Testers API

ขั้นตอนที่ 2: เพิ่ม App Distribution ลงในแอป

App Distribution Android SDK ประกอบด้วยไลบรารี 2 รายการ ได้แก่

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

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

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

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

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

    Kotlin 

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

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

    Java 

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

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

หากกำลังมองหาโมดูลไลบรารีเฉพาะของ Kotlin ตั้งแต่รุ่นเดือนตุลาคม 2023 เป็นต้นไป ทั้งนักพัฒนา Kotlin และ Java จะใช้โมดูลไลบรารีหลักได้ ดูรายละเอียดได้ที่คำถามที่พบบ่อยเกี่ยวกับโครงการนี้

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

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

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

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

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

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

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

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

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

ใช้ 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);
    }
}

ตัวเลือกที่ 2: ทริกเกอร์ที่กำหนดเอง

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

Kotlin 

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

Java 

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

ขั้นตอนที่ 4: สร้างและทดสอบการติดตั้งใช้งาน

การทดสอบในพื้นที่

หากต้องการทดสอบการติดตั้งใช้งานโดยไม่ต้องเผยแพร่แอปก่อน ให้ทำตามขั้นตอนต่อไปนี้

  1. วิธีเปิดใช้โหมดนักพัฒนาซอฟต์แวร์ในอุปกรณ์ของคุณ

    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. ดาวน์โหลดแอปผ่านเว็บหรือแอปทดสอบ Android ของ App Distribution

  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

หากต้องการตั้งค่าความสามารถในการแจ้งเตือนขั้นสูงโดยใช้ Cloud Functions for Firebase ให้ทำตามขั้นตอนต่อไปนี้

  1. ตั้งค่า Cloud Functions for Firebase ซึ่งรวมถึงงานต่อไปนี้

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

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

    3. เริ่มต้น Cloud Functions for Firebase โดยใช้ Firebase CLI

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

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

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