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

คู่มือนี้อธิบายวิธีเปิดใช้การแสดงความคิดเห็นในแอปโดยใช้ 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 ให้ระบุตัวแปรบิลด์ ซึ่งรวมถึง ประเภทบิลด์ หรือ Product Flavor ที่คุณจะเผยแพร่ผ่าน 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-beta19")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta19")
   }

   Java

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta19")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta19")
   }

หากกำลังมองหาโมดูลไลบรารีเฉพาะ 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() ของกิจกรรมหลัก

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

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

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

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

คุณสามารถตรวจสอบและลบความคิดเห็นของผู้ใช้ รวมถึง ภาพหน้าจอได้โดยเปิดแท็บความคิดเห็นของผู้ทดสอบ ในรุ่นที่เฉพาะเจาะจงใน 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การแจ้งเตือน