หน้านี้ได้รับการแปลโดย Cloud Translation API

โฆษณาที่มีการให้รางวัล

โฆษณาที่มีการให้รางวัลเปิดโอกาสให้ผู้ใช้โต้ตอบด้วยเพื่อแลกกับรางวัลในแอป คู่มือนี้แสดงวิธีผสานรวมโฆษณาที่มีการให้รางวัลในแอป Android และ iOS โดยใช้ SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google

อ่านเรื่องราวความสำเร็จของลูกค้า: กรณีศึกษา 1, กรณีศึกษา 2

สิ่งที่ต้องดำเนินการก่อน

ดำเนินการตามเริ่มต้นใช้งานให้เสร็จสิ้น
(Android เท่านั้น) มีความคุ้นเคยกับการใช้งานข้อมูลอ้างอิงของ JNI jobject (โปรดดูเคล็ดลับเกี่ยวกับ Android JNI)

ทดสอบด้วยโฆษณาทดสอบเสมอ

เมื่อสร้างและทดสอบแอป ตรวจสอบว่าคุณใช้โฆษณาทดสอบมากกว่าโฆษณาจริงเวอร์ชันที่ใช้งานจริง มิเช่นนั้น บัญชีจะถูกระงับ

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

Android : ca-app-pub-3940256099942544/5224354917
iOS: ca-app-pub-3940256099942544/1712485313

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของโฆษณาทดสอบของ SDK โฆษณาในอุปกรณ์เคลื่อนที่ได้ที่โฆษณาทดสอบ

การใช้งาน

ขั้นตอนหลักในการผสานรวมโฆษณาที่มีการให้รางวัลมีดังนี้

โหลดโฆษณา
ลงทะเบียนสำหรับการติดต่อกลับ
แสดงโฆษณาและจัดการกิจกรรมให้รางวัล

กำหนดค่า `RewardedAd`

โฆษณาที่มีการให้รางวัลจะแสดงในออบเจ็กต์ RewardedAd รายการ ดังนั้นขั้นตอนแรกในการผสานรวมโฆษณาที่มีการให้รางวัลเข้ากับแอปคือการสร้างและเริ่มต้นอินสแตนซ์ของ RewardedAd

เพิ่มส่วนหัวต่อไปนี้ในโค้ด C++ ของแอป
```
 #include "firebase/gma/rewarded_ad.h"
```
ประกาศและสร้างอินสแตนซ์ RewardedAd ออบเจ็กต์:
```
 firebase::gma::RewardedAd* rewarded_ad;
 rewarded_ad = new firebase::gma::RewardedAd();
```
เริ่มต้นอินสแตนซ์ RewardedAd โดยใช้มุมมองระดับบนสุดแคสต์ไปยังประเภท AdParent มุมมองระดับบนสุดคือการอ้างอิงจาก JNI jobject ไปยัง Android Activity หรือตัวชี้ไปยัง iOS UIView
```
// my_ad_parent is a jobject reference to an Android Activity or
// a pointer to an iOS UIView.
firebase::gma::AdParent ad_parent =
  static_cast<firebase::gma::AdParent>(my_ad_parent);
firebase::Future<void> result = rewarded_ad->Initialize(ad_parent);
```
คุณตรวจสอบสถานะการดำเนินการเริ่มต้นเป็นระยะๆ ได้โดยเรียกใช้ InitializeLastResult() ในออบเจ็กต์ RewardedAd เป็นทางเลือกในการเก็บอนาคตเป็นตัวแปร ซึ่งอาจมีประโยชน์ในการติดตามกระบวนการเริ่มต้นใน Game Loop ทั่วโลกของคุณ
```
// Monitor the status of the future in your game loop:
firebase::Future<void> result = rewarded_ad->InitializeLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  // Initialization completed.
  if(future.error() == firebase::gma::kAdErrorCodeNone) {
    // Initialization successful.
  } else {
    // An error has occurred.
  }
} else {
  // Initialization on-going.
}
```

ดูข้อมูลเพิ่มเติมเกี่ยวกับการทำงานร่วมกับ firebase::Future ได้ที่ใช้สัญญาซื้อขายล่วงหน้าเพื่อตรวจสอบสถานะความสำเร็จของการเรียกใช้เมธอด

โหลดโฆษณา

การโหลดโฆษณาจะทำได้โดยใช้เมธอด LoadAd() ในออบเจ็กต์ RewardedAd วิธีการโหลดกำหนดให้คุณต้องเริ่มต้นออบเจ็กต์ RewardedAd รวมถึงต้องมีรหัสหน่วยโฆษณาและออบเจ็กต์ AdRequest ระบบจะแสดงผล firebase::Future ซึ่งคุณใช้เพื่อตรวจสอบสถานะและผลลัพธ์ของการดำเนินการโหลดได้

โค้ดต่อไปนี้แสดงวิธีโหลดโฆษณาเมื่อเริ่มต้น RewardedAd สำเร็จแล้ว

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = rewarded_ad->LoadAd(rewarded_ad_unit_id, ad_request);

ลงทะเบียนสำหรับการติดต่อกลับ

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

โค้ดต่อไปนี้แสดงวิธีการขยายชั้นเรียนและกําหนดให้กับโฆษณา

  class ExampleFullScreenContentListener
      : public firebase::gma::FullScreenContentListener {

   public:
    ExampleFullScreenContentListener() {}

    void OnAdClicked() override {
      // This method is invoked when the user clicks the ad.
    }

    void OnAdDismissedFullScreenContent() override {
     // This method is invoked when the ad dismisses full screen content.
    }

    void OnAdFailedToShowFullScreenContent(const AdError& error) override {
      // This method is invoked when the ad failed to show full screen content.
      // Details about the error are contained within the AdError parameter.
    }

    void OnAdImpression() override {
      // This method is invoked when an impression is recorded for an ad.
    }

    void OnAdShowedFullScreenContent() override {
      // This method is invoked when the ad showed its full screen content.
    }
  };

  ExampleFullScreenContentListener* example_full_screen_content_listener =
    new ExampleFullScreenContentListener();
  rewarded_ad->SetFullScreenContentListener(example_full_screen_content_listener);

RewardedAd เป็นออบเจ็กต์แบบใช้ครั้งเดียว ซึ่งหมายความว่าเมื่อโฆษณาที่มีการให้รางวัลแสดง ไปแล้ว โฆษณานั้นก็จะแสดงอีกไม่ได้ แนวทางปฏิบัติแนะนำคือให้โหลดโฆษณาที่มีการให้รางวัลอื่นในเมธอด OnAdDismissedFullScreenContent() ของ FullScreenContentListener เพื่อให้โฆษณาที่มีการให้รางวัลรายการต่อไปเริ่มโหลดทันทีที่ปิดโฆษณาก่อนหน้า

แสดงโฆษณาและจัดการกิจกรรมให้รางวัล

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

เมื่อแสดงโฆษณา คุณต้องระบุออบเจ็กต์ UserEarnedReward เพื่อจัดการรางวัลให้ผู้ใช้

โค้ดต่อไปนี้แสดงวิธีแสดง RewardedAd

// A simple listener track UserEarnedReward events.
class ExampleUserEarnedRewardListener :
    public firebase::gma::UserEarnedRewardListener {
 public:
   ExampleUserEarnedRewardListener() { }

  void OnUserEarnedReward(const firebase::gma::AdReward& reward) override {
    // Reward the user!
  }
};

ExampleUserEarnedRewardListener* user_earned_reward_listener =
  new ExampleUserEarnedRewardListener();
firebase::Future<void> result = rewarded_ad->Show(user_earned_reward_listener);

คำถามที่พบบ่อย

การเรียกการเริ่มต้นมีการหมดเวลาหรือไม่: หลังจากผ่านไป 10 วินาที SDK C++ โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google จะดำเนินการกับ firebase::Future ที่ Initialize() ส่งคืนให้ แม้ว่าเครือข่ายสื่อกลางจะยังไม่เริ่มต้นก็ตาม
จะเกิดอะไรขึ้นหากเครือข่ายสื่อกลางบางเครือข่ายไม่พร้อมเมื่อฉันได้รับการเรียกกลับการเริ่มต้น: แนวทางปฏิบัติแนะนำคือให้โหลดโฆษณาหลังจากที่เริ่มต้น SDK เสร็จสมบูรณ์แล้ว แม้ว่าเครือข่ายสื่อกลางยังไม่พร้อม แต่ SDK โฆษณา C++ ของ Google Mobile จะยังคงขอโฆษณาจากเครือข่ายนั้น ดังนั้นหากเครือข่ายสื่อกลางเริ่มต้นทำงานเสร็จแล้วหลังจากหมดเวลา เครือข่ายดังกล่าวจะยังคงให้บริการคำขอโฆษณาในอนาคตในเซสชันนั้นได้; คุณยังสำรวจสถานะการเริ่มต้นของอะแดปเตอร์ทั้งหมดต่อในเซสชันของแอปได้โดยเรียกใช้ GetInitializationStatus()
ฉันจะทราบได้อย่างไรว่าเครือข่ายสื่อกลางบางเครือข่ายยังไม่พร้อมทำงาน: AdapterStatus.description() อธิบายสาเหตุที่อะแดปเตอร์ยังไม่พร้อมสำหรับคำขอโฆษณา ดูซอร์สโค้ดของตัวอย่างแอป Quickstart ใน GitHub เพื่อดูตัวอย่างการบันทึกสถานะอะแดปเตอร์สื่อกลาง

แหล่งข้อมูลเพิ่มเติม

ตัวอย่างใน GitHub

ดูซอร์สโค้ดของตัวอย่างแอปเริ่มต้นอย่างรวดเร็วใน GitHub