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

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

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

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

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

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

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

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

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

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

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

การใช้งาน

กำหนดค่า `AdView`

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

เพิ่มส่วนหัวต่อไปนี้ในโค้ด C++ ของแอป
```
 #include "firebase/gma/ad_view.h"
```
ประกาศและสร้างอินสแตนซ์ของออบเจ็กต์ AdView
```
  firebase::gma::AdView* ad_view;
  ad_view = new firebase::gma::AdView();
```
สร้าง AdSize และเริ่มต้นมุมมองโฆษณาโดยใช้มุมมองระดับบนสุดของ AdParent มุมมองหลักเป็นการอ้างอิง JNI jobject ไปยัง Android Activity หรือตัวชี้ไปยังการแคสต์ UIView ของ iOS ไปยังประเภท 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);
```
นอกจากการเก็บอนาคตไว้เป็นตัวแปรแล้ว คุณยังตรวจสอบสถานะของการดำเนินการเริ่มต้นเป็นระยะได้โดยเรียกใช้ 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.
  }
```
ดูข้อมูลเพิ่มเติมเกี่ยวกับการทำงานร่วมกับ 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();

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

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

คุณจะขยายเมธอดใน AdListener หรือไม่ก็ได้ คุณจึงต้องใช้เพียงเมธอดที่ต้องการเท่านั้น ด้านล่างคือตัวอย่างการใช้งานคลาสที่ขยายคลาส Method ของ 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);

ขนาดของแบนเนอร์

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

ขนาดเป็นจุด (กว้างxสูง)	คำอธิบาย	ความพร้อมใช้งาน	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

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

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

ตัวอย่างกรณีการใช้งาน