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

คู่มือนี้จะอธิบายวิธีเปิดใช้ความคิดเห็นในแอปโดยใช้ตัวเลือก 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 สำหรับ Android SDK ของ App Distribution ใน ไฟล์ Gradle เวอร์ชัน module (ระดับแอป) (ปกติ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle).

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

  3. ประกาศทรัพยากร Dependency สำหรับ Android SDK ของ App Distribution ใน ไฟล์ 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-beta13")

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

    Java 

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

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

ขั้นตอนที่ 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. ดาวน์โหลดแอปผ่านเว็บของ 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

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

  1. ตั้งค่า Cloud Functions สำหรับ Firebase ซึ่งมีงานต่อไปนี้

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

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

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

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

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

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