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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

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

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

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

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

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

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

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

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

การใช้งาน

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

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

กําหนดค่า RewardedAd

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

  1. เพิ่มส่วนหัวต่อไปนี้ลงในโค้ด C++ ของแอป 

     #include "firebase/gma/rewarded_ad.h"

  2. ประกาศและสร้างอินสแตนซ์ออบเจ็กต์ RewardedAd ใหม่ ดังนี้ 

     firebase::gma::RewardedAd* rewarded_ad;
 rewarded_ad = new firebase::gma::RewardedAd();

  3. เริ่มต้นอินสแตนซ์ 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);

  4. นอกจากนี้คุณยังเก็บสถานะการดําเนินการเริ่มต้นเป็นระยะได้โดยการเรียกใช้ 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 เสร็จสิ้น แม้ว่าเครือข่ายสื่อกลางจะไม่พร้อมใช้งาน แต่ C++ SDK สําหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google จะยังคงขอเครือข่ายนั้นจากโฆษณาอยู่ ดังนั้น หากเครือข่ายสื่อกลางเริ่มต้นเสร็จแล้วหลังจากหมดเวลาแล้ว เครือข่ายนั้นก็ยังคงส่งคําขอโฆษณาในอนาคตได้ในเซสชันดังกล่าว

คุณยังสํารวจสถานะการเริ่มต้นของอะแดปเตอร์ทั้งหมดในเซสชันของแอปได้โดยเรียกใช้ GetInitializationStatus()

ฉันจะดูได้อย่างไรว่าเครือข่ายสื่อกลางใดไม่พร้อมใช้งาน

AdapterStatus.description() อธิบายเหตุผลที่อะแดปเตอร์ไม่พร้อมแสดงคําขอโฆษณา ดูตัวอย่างซอร์สโค้ดของ แอป Quickstart ใน GitHub สําหรับตัวอย่างการบันทึกอะแดปเตอร์อะแดปเตอร์สื่อกลาง

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

ตัวอย่างใน GitHub

  • ดูซอร์สโค้ดของตัวอย่างแอป Quickstart ใน GitHub