เพิ่มฟีเจอร์เฉพาะผลิตภัณฑ์ที่ได้รับรางวัล

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

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

เอกสารนี้อธิบายวิธีใช้ฟังก์ชันเฉพาะสำหรับโฆษณาที่มีการให้รางวัล Google อีกด้วย ส่วนแผนภาพเวิร์กโฟลว์ของหน้านี้ จะแสดงให้เห็นขั้นตอนดังกล่าว

ระบุผลิตภัณฑ์ที่เป็นรางวัลของแอป

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

ก่อนที่คุณจะเสนอผลิตภัณฑ์ที่เป็นรางวัลให้แก่ผู้ใช้ได้ คุณจะต้องได้รับ SkuDetails สำหรับ ผลิตภัณฑ์ โดยโทร querySkuDetailsAsync() โดยมี SkuType.INAPP เป็นประเภทผลิตภัณฑ์

ประกาศโฆษณาที่เหมาะสมกับวัย

เพื่อช่วยอำนวยความสะดวกในการปฏิบัติตามภาระหน้าที่ตามกฎหมายที่เกี่ยวข้องกับเด็กและ ผู้ใช้ที่อายุต่ำกว่าที่กำหนดไว้ รวมถึง Children's Online Privacy Protection Act (COPPA) และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) แอปของคุณควรประกาศว่าโฆษณาใดควรได้รับการปฏิบัติว่ามีเด็กเป็นกลุ่มเป้าหมายในสหรัฐอเมริกา รัฐ และโฆษณาใดมุ่งไปยังผู้ใช้ที่อายุต่ำกว่าอายุที่ให้ความยินยอมได้ ประเทศ AdMob ศูนย์ช่วยเหลือจะอธิบายกรณีที่คุณควรติดแท็กคำขอโฆษณาสำหรับการดูแลให้เหมาะสมกับเด็ก ของการรักษาและกรณีที่ควร แท็กพวกเขาสำหรับผู้ที่อายุต่ำกว่าอายุที่ยินยอม รวมถึง ของการดำเนินการดังกล่าว

เมื่อคุณสร้างไคลเอ็นต์สำหรับการเรียกเก็บเงินของแอป ให้พิจารณาว่าโฆษณาที่มีการให้รางวัล ควรถือเป็นคำขอที่มีเด็กเป็นกลุ่มเป้าหมาย หรือควรกำหนดเป็นคำขอที่มีเด็กเป็นกลุ่มเป้าหมาย สำหรับผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ คำขอโฆษณาควรมีสิ่งเหล่านี้ มีข้อจำกัดให้เรียกใช้ setChildDirected() และ setUnderAgeOfConsent() โดยส่งค่าที่เหมาะสมลงในแต่ละวิธี

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

Kotlin

val billingClient = BillingClient.newBuilder(context)
        .setListener(this)
        .setChildDirected(ChildDirected.CHILD_DIRECTED)
        .setUnderAgeOfConsent(UnderAgeOfConsent.UNDER_AGE_OF_CONSENT)
        .build()

Java

BillingClient billingClient =
    BillingClient.newBuilder(context)
        .setListener(this)
        .setChildDirected(ChildDirected.CHILD_DIRECTED)
        .setUnderAgeOfConsent(UnderAgeOfConsent.UNDER_AGE_OF_CONSENT)
        .build();

หมายเหตุ: หลังจากที่คุณสร้างลูกค้าการเรียกเก็บเงินแล้ว คุณจะไม่สามารถเปลี่ยนแปลงค่าสำหรับ childDirected และ underAgeOfConsent หากต้องการใช้ค่าที่แตกต่างกัน เช่น เมื่อผู้ใช้เปลี่ยนบัญชีเกม ยกเลิกการเชื่อมต่อการเรียกเก็บเงินปัจจุบันของคุณ ไคลเอ็นต์ ให้สร้างอินสแตนซ์ใหม่ของไคลเอ็นต์ และเชื่อมต่ออินสแตนซ์ใหม่นั้นกับ Google Play Billing Library

โหลดโฆษณาวิดีโอ

ก่อนแสดงตัวเลือกให้ผู้ใช้ดูโฆษณาวิดีโอเพื่อรับ คุณต้องโหลดวิดีโอเป็นผลิตภัณฑ์ที่ได้รับเป็นรางวัล ในการดำเนินการนี้ ให้สร้าง RewardLoadParams ที่เชื่อมโยงออบเจ็กต์กับออบเจ็กต์ SkuDetails ที่ แสดงถึงผลิตภัณฑ์ที่ได้รับเป็นรางวัล จากนั้น โทรหาหมายเลขของลูกค้า loadRewardedSku() ส่งในออบเจ็กต์ RewardLoadParams และ RewardResponseListener ออบเจ็กต์

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

ผู้ฟัง RewardResponseListener จะได้รับการแจ้งเตือนเมื่อวิดีโอเล่นจบ กำลังโหลด ผู้ฟังจะได้รับแจ้งด้วยหากวิดีโอไม่พร้อมใช้งานหรือหากวิดีโออื่น เช่น เซิร์ฟเวอร์หมดเวลา

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

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

• เมื่อตัดสินใจว่าจะโหลดวิดีโอเมื่อใด โปรดเลือกความสมดุลระหว่างแบนด์วิดท์ การใช้งานและการตอบสนองของแอปที่เหมาะกับ Use Case ของคุณที่สุด

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

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

Kotlin

if (skuDetails.isRewarded()) {
    val params = RewardLoadParams.Builder()
            .setSkuDetails(skuDetails)
            .build()
    mBillingClient.loadRewardedSku(params.build(),
            object : RewardResponseListener {
        override fun onRewardResponse(@BillingResponse responseCode : Int) {
            if (responseCode == BillingResponse.OK) {
                // Enable the reward product, or make
                // any necessary updates to the UI.
            }
        }
    })
}

Java

if (skuDetails.isRewarded()) {
    RewardLoadParams.Builder params = RewardLoadParams.newBuilder();
    params.setSkuDetails(skuDetails);
    mBillingClient.loadRewardedSku(params.build(),
        new RewardResponseListener() {
            @Override
            public void onRewardResponse(int responseCode) {
                if (responseCode == BillingResponse.OK) {
                      // Enable the reward product, or make
                      // any necessary updates to the UI.
                  }
            }
        });
}

มอบการซื้อที่มีการให้รางวัลให้กับผู้ใช้

หาก Google Play Billing Library โหลดวิดีโอที่เชื่อมโยงสำเร็จ ผลิตภัณฑ์ที่เป็นรางวัล กล่าวคือ หากRewardResponseListenerได้รับ responseCode จาก BillingResponse.OK - คุณ ก็สามารถเปิดขั้นตอนการเรียกเก็บเงินได้

ข้อควรระวัง: อย่าเริ่มขั้นตอนการเรียกเก็บเงินหาก responseCode ไม่เริ่มต้น BillingResponse.OK ซึ่งเกิดขึ้นหากโฆษณาวิดีโอไม่พร้อมใช้งาน ด้วยวิธีนี้ โดยไม่ต้องแสดงกล่องโต้ตอบข้อผิดพลาดเพิ่มเติม ซึ่งทำให้ผู้ใช้ได้รับประสบการณ์ที่ดี

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

ทำการซื้อ

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

ทดสอบผลิตภัณฑ์ที่เป็นรางวัล

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

การทดสอบอีกวิธีคือให้คุณใช้ผลิตภัณฑ์ android.test.reward ID ผลิตภัณฑ์เฉพาะนี้เป็นชื่อที่สงวนไว้ใน Google Play Billing ดังนั้น คุณไม่ต้องเพิ่มลงในรายการไอเทมที่ซื้อในแอปใน Play Console

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

แต่เมื่อทดสอบเสร็จแล้ว อย่าลืมเปลี่ยน android.test.reward ด้วยรหัสผลิตภัณฑ์สำหรับการได้รับรางวัลจริง ก่อนทำให้แอปเวอร์ชันที่ใช้งานจริงใช้งานได้แก่ผู้ใช้ปลายทาง

แผนภาพเวิร์กโฟลว์ของผลิตภัณฑ์ที่ได้รับรางวัล

แผนภาพลำดับต่อไปนี้จะแสดงวิธีที่ผู้ใช้ แอป และ Google Play Billing Library จะทำงานร่วมกันเพื่อแสดงโฆษณาวิดีโอและให้สิทธิ์ สิทธิ์ของผู้ใช้ในการเข้าถึงผลิตภัณฑ์ที่ได้รับรางวัล:

วันที่

รูปที่ 1 ขั้นตอนในการซื้อผลิตภัณฑ์ที่ได้รับรางวัลให้เสร็จสมบูรณ์ ด้วย Google Play Billing