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

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

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

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

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

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

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

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

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

  2. เรียกใช้การตรวจสอบเพื่อให้แน่ใจว่าผู้ทดสอบได้เปิดใช้ฟีเจอร์การทดสอบของ SDK หากไม่ได้เปิดใช้ฟีเจอร์การทดสอบ SDK ของ Android จะแจ้งให้ผู้ทดสอบลงชื่อเข้าใช้ 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 Console ความคิดเห็นของผู้ใช้จะจัดระเบียบตามรุ่นเพื่อให้คุณยืนยัน เวอร์ชันที่ความคิดเห็นนั้นเกี่ยวข้องได้

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

รับการแจ้งเตือนทางอีเมลเมื่อมีความคิดเห็นใหม่

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

หากต้องการรับการแจ้งเตือนทางอีเมลของ 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การแจ้งเตือน