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

คู่มือนี้จะอธิบายวิธีเปิดใช้ความคิดเห็นในแอปโดยใช้ Firebase App DistributionAndroid 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+KTX 

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

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

    Java 

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

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

ขั้นตอนที่ 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. เปิดใช้โหมดนักพัฒนาซอฟต์แวร์ในอุปกรณ์เครื่องอื่น

    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 โดยใช้ CLI ของ Firebase

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

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

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