เตรียมพร้อม

หมายเหตุ: ก่อนอ่านหัวข้อนี้ โปรดอ่าน เอกสารประกอบในศูนย์ช่วยเหลือของ Play Console ซึ่งอธิบายแนวคิดที่สำคัญเกี่ยวกับการซื้อ รวมถึง วิธีสร้างและกำหนดค่าผลิตภัณฑ์เพื่อขาย

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

สร้างบัญชีนักพัฒนาแอป Google Play

หากต้องการเผยแพร่แอปและเกมใน Google Play ให้ใช้ Google Play Console นอกจากนี้ คุณยังใช้ Google Play Console เพื่อจัดการผลิตภัณฑ์และการตั้งค่าที่เกี่ยวข้องกับการเรียกเก็บเงินได้ด้วย

หากต้องการเข้าถึง Google Play Console คุณต้องสร้างบัญชีนักพัฒนาแอป Google Play

หากต้องการขายแอปที่ต้องซื้อและการซื้อในแอปใน Google Play คุณต้องตั้งค่าโปรไฟล์ในศูนย์การชำระเงินของ Google และลิงก์โปรไฟล์ดังกล่าวกับบัญชีนักพัฒนาแอป Google Play ดูวิธีลิงก์โปรไฟล์กับบัญชี หรือวิธีตรวจสอบว่าคุณมีบัญชีและโปรไฟล์ที่ลิงก์อยู่แล้วหรือไม่ได้ที่ลิงก์บัญชีนักพัฒนาแอป Google Play กับโปรไฟล์การชำระเงิน

เปิดใช้ฟีเจอร์ที่เกี่ยวข้องกับการเรียกเก็บเงินใน Google Play Console

เมื่อตั้งค่าบัญชีนักพัฒนาแอปแล้ว คุณต้องเผยแพร่แอปเวอร์ชันที่มี Google Play Billing Library ขั้นตอนนี้จำเป็น ในการเปิดใช้ฟีเจอร์ที่เกี่ยวข้องกับการเรียกเก็บเงินใน Google Play Console เช่น การกำหนดค่าผลิตภัณฑ์ที่คุณต้องการขาย

เพิ่มการอ้างอิงไลบรารี

หากต้องการผสานรวมระบบการเรียกเก็บเงินของ Google Play ให้เพิ่มทรัพยากร Dependency ไปยัง Google Play Billing Library ในแอปก่อน ไลบรารีนี้จะให้สิทธิ์เข้าถึง Android API ที่เชื่อมต่อคุณกับ Google Play จากนั้น คุณจะเข้าถึงข้อมูลการซื้อ สอบถามข้อมูลอัปเดตเกี่ยวกับการซื้อ แจ้งให้ผู้ใช้ทำการซื้อใหม่ และอื่นๆ ได้

Google Play Billing Library พร้อมให้บริการจากที่เก็บ Maven ของ Google เพิ่มทรัพยากร Dependency ลงในไฟล์ build.gradle ของแอปตามที่แสดง

Groovy

dependencies {
    def billing_version = "8.3.0"

    implementation "com.android.billingclient:billing:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "8.3.0"

    implementation("com.android.billingclient:billing:$billing_version")
}

หากใช้ Kotlin โมดูล KTX ของ Play Billing Library จะมีส่วนขยาย Kotlin และการรองรับ Coroutine ที่ช่วยให้คุณเขียน Kotlin ที่เป็นสำนวนเมื่อใช้ระบบการเรียกเก็บเงินของ Google Play ได้ หากต้องการรวมส่วนขยายเหล่านี้ไว้ในโปรเจ็กต์ ให้เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในไฟล์ build.gradle ของแอปตามที่แสดง

Groovy

dependencies {
    def billing_version = "8.3.0"

    implementation "com.android.billingclient:billing-ktx:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "8.3.0"

    implementation("com.android.billingclient:billing-ktx:$billing_version")
}

ตัวอย่างโค้ด Kotlin ที่พบในหน้านี้ใช้ประโยชน์จาก KTX เมื่อเป็นไปได้

อัปโหลดแอป

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

หมายเหตุ: การซื้อที่ทำในแอปที่เผยแพร่ไปยังแทร็กทดสอบภายในหรือในขั้นตอนฉบับร่างจะขึ้นอยู่กับวงเงินใช้จ่าย

สร้างและกำหนดค่าผลิตภัณฑ์

หลังจากเปิดใช้ฟีเจอร์ Google Play Billing สำหรับแอปแล้ว คุณจะต้อง กำหนดค่าผลิตภัณฑ์ที่จะขาย

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

Google Play Console มีอินเทอร์เฟซเว็บที่คุณใช้เพื่อ จัดการผลิตภัณฑ์ได้

• ดูวิธีสร้างและกำหนดค่าผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวได้ที่ สร้างไอเทมที่มีการจัดการ โปรดทราบว่า Google Play Console จะเรียกผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวว่าผลิตภัณฑ์ที่มีการจัดการ

• ดูวิธีสร้างและกำหนดค่าการสมัครใช้บริการได้ที่สร้างการสมัครใช้บริการ

คุณยังจัดการผลิตภัณฑ์ได้โดยใช้แหล่งข้อมูล REST ของ inappproducts สำหรับไอเทมที่ซื้อในแอปและแหล่งข้อมูล REST ของ monetization.subscriptions สำหรับผลิตภัณฑ์ที่ต้องสมัครใช้บริการใน Google Play Developer API ซึ่งเป็นอีกทางเลือกหนึ่งแทนอินเทอร์เฟซเว็บ

กำหนดค่า Google Play Developer API

Google Play Developer API เป็น API แบบเซิร์ฟเวอร์ถึงเซิร์ฟเวอร์ที่ช่วยเสริม Google Play Billing Library ใน Android API นี้มีฟังก์ชันการทำงาน ที่ไม่มีใน Google Play Billing Library เช่น การยืนยันการซื้ออย่างปลอดภัย และการคืนเงินให้ผู้ใช้

ในขั้นตอนการผสานรวมระบบการเรียกเก็บเงินของ Google Play เข้ากับแอป คุณต้อง กำหนดค่าการเข้าถึง Google Play Developer API ผ่าน Google Play Console ดูวิธีการได้ที่การเริ่มต้นใช้งาน Google Play Developer API

เมื่อกำหนดค่าการเข้าถึง Google Play Developer API แล้ว โปรดตรวจสอบว่าคุณได้ให้สิทธิ์ดูข้อมูลทางการเงิน ซึ่งจำเป็นต่อการเข้าถึงฟังก์ชันที่เกี่ยวข้องกับการเรียกเก็บเงิน ดูข้อมูลเกี่ยวกับแนวทางปฏิบัติแนะนำ พร้อมข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าสิทธิ์ได้ที่ เพิ่มผู้ใช้บัญชีนักพัฒนาแอปและจัดการสิทธิ์

กำหนดค่าการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป

การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป (RTDN) เป็นกลไกในการรับการแจ้งเตือนจาก Google ทุกครั้งที่มีการเปลี่ยนแปลงสิทธิ์ของผู้ใช้ภายในแอปของคุณ RTDN ใช้ประโยชน์จาก Google Cloud Pub/Sub ซึ่งช่วยให้คุณรับข้อมูลที่ส่งไปยัง URL ที่คุณตั้งค่าไว้ หรือข้อมูลที่สำรวจโดยใช้ไลบรารีของไคลเอ็นต์ การแจ้งเตือนเหล่านี้ช่วยให้คุณตอบสนองต่อการเปลี่ยนแปลงสถานะการสมัครใช้บริการได้ทันที โดยไม่ต้องสำรวจ Google Play Developer API โปรดทราบว่าการใช้ Google Play Developer API อย่างไม่มีประสิทธิภาพอาจทำให้เกิดการจำกัดโควต้า API

หมายเหตุ: คุณต้องเรียกใช้ Google Play Developer API หลังจากที่ได้รับการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปเพื่อดูสถานะทั้งหมดและอัปเดตสถานะแบ็กเอนด์ของคุณเอง การแจ้งเตือนเหล่านี้จะบอกคุณเพียงว่าสถานะการซื้อมีการเปลี่ยนแปลง ข้อมูลเหล่านี้ไม่ได้ให้ข้อมูลทั้งหมดเกี่ยวกับการซื้อ

Cloud Pub/Sub คือบริการรับส่งข้อความแบบเรียลไทม์ที่มีการจัดการครบวงจร ซึ่งคุณใช้เพื่อส่งและรับข้อความ ระหว่างแอปพลิเคชันอิสระได้ Google Play ใช้ Cloud Pub/Sub เพื่อเผยแพร่การแจ้งเตือนแบบพุชในหัวข้อที่คุณสมัครใช้บริการ

หากต้องการรับการแจ้งเตือน คุณต้องสร้างเซิร์ฟเวอร์แบ็กเอนด์เพื่อ ใช้ข้อความที่ส่งไปยังหัวข้อของคุณ จากนั้นเซิร์ฟเวอร์จะใช้ข้อความเหล่านี้ได้โดยการตอบกลับคำขอ HTTPS ไปยังปลายทางที่ลงทะเบียนไว้ หรือโดยใช้ไลบรารีของไคลเอ็นต์ Cloud Pub/Sub โดยไลบรารีเหล่านี้พร้อมให้บริการในหลายภาษา ดูข้อมูลเพิ่มเติมได้ที่ส่วนสร้างการสมัครใช้บริการ Pub/Sub ในหัวข้อนี้

กำหนดราคาและโควต้า

โปรดดูรายละเอียดเกี่ยวกับการกำหนดราคาและโควต้าที่การกำหนดราคาและโควต้า

ประมาณปริมาณการใช้อินเทอร์เน็ต

ส่วนข้อมูลของการแจ้งเตือนการสมัครใช้บริการมีขนาดประมาณ 1 KB ต่อคำขอ การเผยแพร่และการดึงข้อมูลแต่ละครั้งต้องใช้คำขอแยกกัน หรือข้อมูลประมาณ 2 KB ต่อการแจ้งเตือน จำนวน การแจ้งเตือนต่อเดือนจะขึ้นอยู่กับรอบการเรียกเก็บเงินและพฤติกรรมของผู้ใช้ คุณควรได้รับการแจ้งเตือนอย่างน้อย 1 รายการสำหรับผู้ใช้แต่ละรายในรอบการเรียกเก็บเงิน

ตั้งค่า Cloud Pub/Sub

หากต้องการเปิดใช้การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป คุณต้องตั้งค่า Cloud Pub/Sub โดยใช้โปรเจ็กต์ Google Cloud Platform (GCP) ของคุณเองก่อน จากนั้น เปิดใช้การแจ้งเตือนสำหรับแอป

หากต้องการใช้ Cloud Pub/Sub คุณต้องมีโปรเจ็กต์ GCP ที่เปิดใช้ Cloud Pub/Sub API หากคุณไม่คุ้นเคยกับ GCP และ Cloud Pub/Sub โปรดดูคู่มือเริ่มใช้งานฉบับย่อ

หมายเหตุ: คุณต้องกำหนดค่าการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปสำหรับแอป Android แต่ละแอปแยกกัน ซึ่งหมายความว่าคุณสามารถเลือกใช้โปรเจ็กต์ GCP เดียวกันกับที่ใช้เพื่อเข้าถึง Google Play Developer API หรือจะสร้างโปรเจ็กต์ GCP ใหม่สำหรับแต่ละแอปก็ได้ หากมีหลายแอป คุณต้องใช้คอนโซล Google Cloud โปรเจ็กต์เดียวกันสำหรับ Google Play Developer API แต่จะใช้คอนโซล Google Cloud โปรเจ็กต์ที่แตกต่างกันสำหรับแต่ละแอปก็ได้

สร้างหัวข้อ

หากต้องการเริ่มรับการแจ้งเตือน คุณต้องสร้างหัวข้อ ที่ Google Play ควรเผยแพร่การแจ้งเตือน หากต้องการสร้างหัวข้อ ให้ทำตามวิธีการในสร้างหัวข้อ

สร้างการสมัครใช้บริการ Pub/Sub

หากต้องการรับข้อความที่เผยแพร่ไปยังหัวข้อ คุณต้องสร้างการสมัครใช้บริการ Pub/Sub สำหรับหัวข้อนั้น หากต้องการสร้างการสมัครใช้บริการ Pub/Sub ให้ทำดังนี้

1. อ่านคำแนะนำสำหรับผู้สมัครใช้บริการ Cloud Pub/Sub เพื่อพิจารณาว่าจะกำหนดค่าการสมัครใช้บริการเป็นการสมัครใช้บริการแบบพุชหรือการสมัครใช้บริการแบบดึง
   • การสมัครใช้บริการแบบพุชช่วยให้ Cloud Pub/Sub ส่งการแจ้งเตือนไปยังแบ็กเอนด์ที่ปลอดภัยของคุณได้โดยการออกคำขอ HTTPS
   • การสมัครใช้บริการแบบดึงกำหนดให้เซิร์ฟเวอร์แบ็กเอนด์ที่ปลอดภัยของคุณเริ่มคำขอไปยังเซิร์ฟเวอร์ Cloud Pub/Sub เพื่อดึงข้อมูลข้อความ
2. ทำตามวิธีการใน เพิ่มการสมัครใช้บริการ เพื่อสร้างการสมัครใช้บริการ

หมายเหตุ: การสมัครใช้บริการแบบดึงมักใช้กันโดยทั่วไปเพื่อเพิ่มประสิทธิภาพการใช้ทรัพยากร เมื่อมีการประมวลผลข้อความจำนวนมาก ซึ่งโดยทั่วไปจะไม่มีผลกับ RTDN หากไม่แน่ใจว่าจะเริ่มต้นด้วยการพุชหรือดึง เราขอแนะนำให้ใช้การพุชเนื่องจากโดยทั่วไปแล้วจะใช้งานได้ง่ายกว่า ดู การนำส่งแบบพุชหรือแบบดึง เพื่อช่วยตัดสินใจว่าการสมัครใช้บริการแบบพุชหรือแบบดึงเหมาะกับแอปของคุณมากที่สุด

ให้สิทธิ์ในการเผยแพร่ในหัวข้อของคุณ

Cloud Pub/Sub กำหนดให้คุณต้องให้สิทธิ์ Google Play ในการเผยแพร่การแจ้งเตือนไปยังหัวข้อของคุณ

1. เปิด คอนโซล Google Cloud
2. เลือกโปรเจ็กต์ แล้วคลิก Pub/Sub ในการนำทางด้านซ้าย

3. ค้นหาหัวข้อที่ต้องการ แล้วเปิดรายละเอียดสิทธิ์

   

   รูปที่ 1 การเข้าถึงการกำหนดค่าสำหรับหัวข้อสิทธิ์

4. เพิ่มบัญชีบริการ [e-mail] และ มอบบทบาทผู้เผยแพร่ Pub/Sub ให้กับบัญชี

   

   รูปที่ 2 เพิ่มบัญชีบริการของ Google Play เป็น ผู้เผยแพร่ Pub/Sub

5. คลิกบันทึกเพื่อตั้งค่าหัวข้อให้เสร็จสมบูรณ์

   

   รูปที่ 3 หัวข้อที่กำหนดค่า

เปิดใช้การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปสำหรับแอปของคุณ

หากต้องการเปิดใช้การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปสำหรับแอป ให้ทำดังนี้

1. เปิด Google Play Console
2. เลือกแอป
3. ไปที่สร้างรายได้ > การตั้งค่าการสร้างรายได้

4. เลื่อนไปที่ส่วนการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปที่ด้านบน ของหน้า

   

   รูปที่ 4 ส่วนการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป

5. เลือกเปิดใช้การแจ้งเตือนแบบเรียลไทม์

6. ในช่องชื่อหัวข้อ ให้ป้อนชื่อหัวข้อ Cloud Pub/Sub แบบเต็มที่คุณกำหนดค่าไว้ก่อนหน้านี้ ชื่อหัวข้อควรอยู่ในรูปแบบ projects/{project_id}/topics/{topic_name} โดย project_id คือ ตัวระบุที่ไม่ซ้ำกันสำหรับโปรเจ็กต์ และ topic_name คือชื่อของ หัวข้อที่สร้างไว้ก่อนหน้านี้

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

   สำหรับการสมัครใช้บริการแบบดึง ให้ไปที่การสมัครใช้บริการใน Cloud Console แล้วคลิกดูข้อความ จากนั้นดึงข้อความ คุณควรรับทราบข้อความที่ดึงมาเพื่อหลีกเลี่ยงการนำส่งซ้ำโดย Cloud Pub/Sub สำหรับการสมัครใช้บริการพุช ให้ตรวจสอบว่าข้อความทดสอบส่งไปยังปลายทางพุชหรือไม่ รหัสการตอบกลับที่สำเร็จ จะถือเป็นการรับทราบข้อความ

   หากเผยแพร่ไม่สำเร็จ ระบบจะแสดงข้อผิดพลาด ตรวจสอบว่าชื่อหัวข้อถูกต้องและ[e-mail]บัญชีบริการมีสิทธิ์เข้าถึงผู้เผยแพร่ Pub/Sub ในหัวข้อ

8. เลือกประเภทการแจ้งเตือนที่ต้องการรับ

   • รับการแจ้งเตือนสำหรับการสมัครใช้บริการและการซื้อที่เป็นโมฆะทั้งหมด - รับการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปที่เกี่ยวข้องกับการสมัครใช้บริการและการซื้อที่เป็นโมฆะ คุณจะไม่ได้รับการแจ้งเตือนสำหรับการซื้อผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว
   • รับการแจ้งเตือนทั้งหมดสำหรับการสมัครใช้บริการและผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว - รับการแจ้งเตือนสำหรับเหตุการณ์การสมัครใช้บริการและการซื้อที่เป็นโมฆะทั้งหมด นอกจากนี้ คุณยังจะได้รับเหตุการณ์การซื้อผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว เช่น ONE_TIME_PRODUCT_PURCHASED และ ONE_TIME_PRODUCT_CANCELED ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์การซื้อเหล่านี้ได้ที่วงจรการซื้อครั้งเดียว

9. คลิกบันทึกการเปลี่ยนแปลง

การยืนยันการกำหนดค่า

หากต้องการรับการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป คุณควรสร้างเซิร์ฟเวอร์แบ็กเอนด์ที่ปลอดภัย เพื่อใช้ข้อความที่ส่งไปยังหัวข้อ Cloud Pub/Sub

คุณทดสอบการกำหนดค่าได้โดยใช้ปุ่มส่งข้อความทดสอบใน Google Play Console ตามที่อธิบายไว้ในส่วนก่อนหน้า หากยังไม่ได้ กำหนดค่าเซิร์ฟเวอร์แบ็กเอนด์เพื่อใช้การแจ้งเตือน คุณสามารถใช้ เครื่องมือบรรทัดคำสั่ง gcloud เพื่อยืนยันการกำหนดค่าได้ ดูวิธีการ ประมวลผลข้อความโดยใช้ gcloud ได้ที่ ดึงข้อความจากการสมัครใช้บริการ

ขั้นตอนถัดไป

• ผสานรวมไลบรารีเข้ากับแอป