โฆษณาแบนเนอร์

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

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

สิ่งที่ต้องมีก่อน

ทดสอบโฆษณาทดสอบอยู่เสมอ

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

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

  • Android : ca-app-pub-3940256099942544/6300978111
  • iOS: ca-app-pub-3940256099942544/2934735716

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

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

การใช้งาน

กําหนดค่าAdView

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

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

     #include "firebase/gma/ad_view.h"
    
  2. ประกาศและเริ่มต้นออบเจ็กต์ AdView:

      firebase::gma::AdView* ad_view;
      ad_view = new firebase::gma::AdView();
    
  3. สร้าง AdSize และเริ่มต้นมุมมองโฆษณาโดยใช้มุมมองระดับบนสุด AdParent มุมมองระดับบนคือการอ้างอิง JNI jobject ไปยัง Android Activity หรือตัวชี้ไปยัง iOS UIView ที่แคสต์ไปยังประเภท AdParent ดังนี้

     // 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(my_ad_parent);
     firebase::Future result =
       ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);
    
  4. อย่างไรก็ตาม คุณจะตรวจสอบสถานะของการดําเนินการเริ่มต้นเป็นระยะได้ด้วยการเรียกใช้ InitializeLastResult() ในออบเจ็กต์ AdView เป็นระยะ วิธีนี้อาจมีประโยชน์ในการติดตาม กระบวนการเริ่มต้นใน Game Loop ทั่วโลก

      // Monitor the status of the future in your game loop:
      firebase::Future<void> result = ad_view->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.
      }
    
  5. ดูข้อมูลเพิ่มเติมเกี่ยวกับการทํางานกับ firebase::Future ได้ที่ใช้สัญญาซื้อขายล่วงหน้าเพื่อตรวจสอบสถานะการเรียกใช้เมธอดที่เสร็จสมบูรณ์

กําหนดตําแหน่งของโฆษณา

คุณตั้งค่าตําแหน่งของ AdView ได้ทุกเมื่อหลังจากเริ่มต้นแล้ว ดังนี้

firebase::Future<void> result = ad_view->SetPosition(firebase::gma::AdView::kPositionTop);

โหลดโฆษณา

คุณจะโหลดโฆษณาได้เมื่อ AdView เริ่มทํางานแล้ว

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result = ad_view->LoadAd(my_ad_request);

ออบเจ็กต์ AdRequest แสดงถึงคําขอโฆษณารายการเดียวและมีพร็อพเพอร์ตี้สําหรับข้อมูลอย่างเช่น การกําหนดเป้าหมาย

แสดงโฆษณา

และสุดท้าย แสดงโฆษณาบนหน้าจอโดยการโทรหา Show() ระบบอาจเรียกใช้เมธอดนี้ทันทีที่โฆษณาเริ่มทํางาน

firebase::Future<void> result = ad_view->Show();

เหตุการณ์โฆษณา

SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ C++ ของ Google มีคลาส AdListener ซึ่งคุณขยายและส่งไปยัง AdView::SetListener() ได้เพื่อรับแจ้งการเปลี่ยนแปลงสถานะการดูโฆษณา

คุณจะขยายเมธอดใน AdListener หรือไม่ก็ได้ คุณจึงต้องใช้เฉพาะเมธอดที่ต้องการเท่านั้น ด้านล่างนี้เป็นตัวอย่างการใช้งานคลาสที่ขยายคลาส AdListener คลาสทั้งหมด

class ExampleAdListener
    : public firebase::gma::AdListener {
 public:
  ExampleAdListener() {}
  void OnAdClicked() override {
    // This method is invoked when the user clicks the ad.
  }

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

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

  void OnAdOpened() override {
    // This method is invoked when an ad opens an overlay that covers the screen.
  }
};

ExampleAdListener* ad_listener = new ExampleAdListener();
ad_view->SetAdListener(ad_listener);

ตารางด้านล่างแสดงขนาดแบนเนอร์มาตรฐาน

ขนาดในจุด (WxH) คำอธิบาย ความพร้อมใช้งาน firebase::gma::ค่าคงที่ของ AdSize
320x50 แบนเนอร์ โทรศัพท์และแท็บเล็ต kBanner
320x100 แบนเนอร์ขนาดใหญ่ โทรศัพท์และแท็บเล็ต kLargeBanner
300x250 สี่เหลี่ยมผืนผ้ากลาง IAB โทรศัพท์และแท็บเล็ต kMediumRectangle
468x60 แบนเนอร์ขนาดเต็มของ IAB แท็บเล็ต kFullBanner
728x90 ลีดเดอร์บอร์ด IAB แท็บเล็ต kLeaderboard
ความกว้างที่ระบุ x ความสูงที่ปรับได้ แบนเนอร์แบบปรับขนาดได้ โทรศัพท์และแท็บเล็ต ไม่มี

ขนาดโฆษณาที่กําหนดเอง

หากต้องการกําหนดขนาดแบนเนอร์ที่กําหนดเอง ให้ตั้งขนาดที่ต้องการโดยใช้ตัวสร้าง firebase::gma::AdSize ที่มีพารามิเตอร์ความกว้างและความสูงดังที่แสดงด้านล่างนี้

firebase::gma::AdSize ad_size(/*width=*/320, /*height=*/50);

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

ตัวอย่างใน GitHub

เรื่องราวความสำเร็จ