เริ่มต้นใช้งาน

คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณาที่ต้องการสร้างรายได้จากแอป C++ ด้วย AdMob โดยไม่ใช้ Firebase หากคุณวางแผนที่จะรวม Firebase ไว้ในแอป หรือหากคุณพิจารณาอยู่ โปรดดูคู่มือเวอร์ชัน AdMob ที่มี Firebase แทน

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

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

หากคุณทำตามคู่มือนี้เป็นครั้งแรก เราขอแนะนำให้คุณดาวน์โหลดและทำตามแอปทดสอบ C++ สำหรับโฆษณาบนอุปกรณ์เคลื่อนที่ของ Google

ข้อกำหนดเบื้องต้น

Android

  • ใช้ Android Studio 3.2 ขึ้นไป
  • ตรวจสอบว่าไฟล์บิลด์ของแอปใช้ค่าต่อไปนี้
    • minSdkVersion ตั้งแต่ 16 ปีขึ้นไป
    • compileSdkVersion ตั้งแต่ 28 ปีขึ้นไป

iOS

  • ใช้ Xcode 13 ขึ้นไป
  • กําหนดเป้าหมายเป็น iOS 10.0 ขึ้นไป

ตั้งค่าแอปในบัญชี AdMob

ลงทะเบียนแอปเป็นแอป AdMob โดยทำตามขั้นตอนต่อไปนี้

  1. ลงชื่อเข้าใช้หรือลงชื่อสมัครใช้บัญชี AdMob

  2. ลงทะเบียนแอปกับ AdMob ขั้นตอนนี้จะสร้างแอป AdMob ที่มีรหัสแอป AdMob ที่ไม่ซ้ำกัน ซึ่งคุณจะต้องนำไปใช้ภายหลังในคู่มือนี้

ติดตั้ง SDK C++ โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google

เนื่องจาก C++ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google อยู่ในเนมสเปซ firebase::gma ให้ดาวน์โหลด Firebase C++ SDK แล้วแตกไฟล์ไปยังไดเรกทอรีที่ต้องการ

Firebase C++ SDK ไม่ใช่การกำหนดค่าเฉพาะแพลตฟอร์ม แต่ต้องมีการกำหนดค่าไลบรารีเฉพาะแพลตฟอร์ม

Android

เราขอแนะนำให้ใช้ CMake แต่คุณสามารถดูวิธีการสำหรับ ndk-build ในคู่มือเริ่มต้นใช้งาน Firebase C++ SDK ทั่วไปเพื่อลิงก์ libfirebase_app.a และ libfirebase_gma.a กับแอปของคุณ

  1. ในไฟล์ gradle.properties ของโปรเจ็กต์ ให้ระบุตำแหน่งของ SDK ที่แตกไฟล์แล้วดังนี้

    systemProp.firebase_cpp_sdk.dir=FULL_PATH_TO_SDK

  2. เพิ่มเนื้อหาต่อไปนี้ในไฟล์ settings.gradle ของโปรเจ็กต์

    def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir')

gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir"
includeBuild "$firebase_cpp_sdk_dir"

  3. ลงในไฟล์ Gradle โมดูล (ระดับแอป) ซึ่งมักจะเป็น app/build.gradle ให้เพิ่มเนื้อหาต่อไปนี้ ซึ่งรวมถึง ทรัพยากร Dependency ของไลบรารีสำหรับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google+

    android.defaultConfig.externalNativeBuild.cmake {
  arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
}

# Add the dependency for the Google Mobile Ads C++ SDK
apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
firebaseCpp.dependencies {
  gma
}

  4. เพิ่มเนื้อหาต่อไปนี้ในไฟล์ CMakeLists.txt ของโปรเจ็กต์

    # Add Firebase libraries to the target using the function from the SDK.
add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)

# Add the Google Mobile Ads C++ SDK.

# The Firebase C++ library `firebase_app` is required,
# and it must always be listed last.

set(firebase_libs
  firebase_gma
  firebase_app
)

target_link_libraries(${target_name} "${firebase_libs}")

  5. ซิงค์แอปเพื่อให้ทรัพยากร Dependency ทั้งหมดมีเวอร์ชันที่จำเป็น

iOS

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

  1. ดาวน์โหลด CocoaPods เวอร์ชัน 1 ขึ้นไปโดยเรียกใช้

    sudo gem install cocoapods --pre

  2. เพิ่มพ็อดโฆษณาบนอุปกรณ์เคลื่อนที่ของ Google จาก SDK ที่แยกไฟล์แล้ว

    1. สร้าง Podfile หากคุณยังไม่มี

      cd APP_DIRECTORY
pod init

    2. ไปที่ Podfile ให้เพิ่มพ็อดสำหรับ SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google, SDK สำหรับ User Messaging Platform ของ Google และ SDK หลักขั้นต่ำของ Firebase (จำเป็นสำหรับ GMA C++ SDK) ดังนี้

      pod 'Firebase/CoreOnly'
pod 'Google-Mobile-Ads-SDK'
pod 'GoogleUserMessagingPlatform'

    3. ติดตั้งพ็อด จากนั้นเปิดไฟล์ .xcworkspace ใน Xcode

      pod install
open APP.xcworkspace

    4. เพิ่มเฟรมเวิร์กต่อไปนี้จาก Firebase C++ SDK ลงในโปรเจ็กต์

      • xcframeworks/firebase.xcframework
      • xcframeworks/firebase_gma.xcframework

เรียบร้อยแล้ว แอป C++ ของคุณได้รับการกำหนดค่าให้ใช้ SDK สำหรับโฆษณาบนอุปกรณ์เคลื่อนที่ของ Google โดยไม่มีบริการ Firebase อื่นใด

กำหนดค่ารหัสแอป AdMob ของแอป

Android

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

iOS

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

เริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

ก่อนที่จะโหลดโฆษณา ให้แอปเริ่มต้น Google Mobile Ads C++ SDK โดยเรียกใช้ firebase::gma::Initialize() ซึ่งจะเริ่มต้น SDK และดำเนินการ firebase::Future เมื่อการเริ่มต้นเสร็จสมบูรณ์ (หรือหลังจากระยะหมดเวลา 30 วินาที) โดยจะต้องทำเพียงครั้งเดียวเท่านั้น คือเมื่อเปิดแอป

โฆษณาอาจโหลดล่วงหน้าโดย SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google หรือ SDK ของพาร์ทเนอร์สื่อกลางเมื่อเรียกใช้ Initialize() หากคุณต้องการขอความยินยอมจากผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ให้ตั้งค่าแฟล็กเฉพาะสำหรับคำขอ (เช่น tag_for_child_directed_treatment หรือ tag_for_under_age_of_consent) หรือดำเนินการก่อนโหลดโฆษณา โปรดตรวจสอบว่าคุณทำเช่นนั้นโดยเรียกใช้ firebase::gma::SetRequestConfiguration() ก่อนเริ่มต้นใช้งาน Google Mobile Ads C++ SDK ดูข้อมูลเพิ่มเติมได้ที่คู่มือการกำหนดเป้าหมาย

ต่อไปนี้คือตัวอย่างวิธีเรียกใช้ Initialize()

Android

// Initialize the Google Mobile Ads library
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(jni_env, j_activity, &result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing
  // dependency. Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

iOS

// Initialize the Google Mobile Ads library.
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(&result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing
  // dependency. Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

ใช้ Future เพื่อตรวจสอบสถานะความสมบูรณ์ของการเรียกใช้เมธอด

Future เป็นวิธีกำหนดสถานะความสมบูรณ์ของการเรียกใช้เมธอดแบบไม่พร้อมกัน

ตัวอย่างเช่น เมื่อแอปเรียกใช้ firebase::gma::Initialize() ระบบจะสร้าง firebase::Future ใหม่และส่งกลับมา จากนั้นแอปของคุณจะสามารถสำรวจ status() ของ Future เพื่อระบุว่าการเริ่มต้นเสร็จสมบูรณ์เมื่อใด เมื่อดำเนินการเสร็จแล้ว แอปของคุณสามารถเรียกใช้ result() เพื่อให้ได้ผลลัพธ์ AdapterInitializationStatus

เมธอดที่แสดงผล Future จะมีเมธอด "ผลลัพธ์ล่าสุด" ที่สัมพันธ์กันซึ่งแอปสามารถใช้เพื่อดึง Future ล่าสุดสําหรับการดําเนินการหนึ่งๆ ตัวอย่างเช่น firebase::gma::Initialize() มีเมธอดที่เกี่ยวข้องที่เรียกว่า firebase::gma::InitializeLastResult() ซึ่งแสดงผล Future ที่แอปของคุณสามารถใช้ในการตรวจสอบสถานะของการเรียกไปยัง firebase::gma::Initialize() ครั้งล่าสุด

หากสถานะของ Future เสร็จสมบูรณ์และรหัสข้อผิดพลาดคือ firebase::gma::kAdErrorCodeNone แสดงว่าการดำเนินการนั้นเสร็จสมบูรณ์

นอกจากนี้ คุณยังสามารถลงทะเบียนโค้ดเรียกกลับที่จะเรียกใช้เมื่อ Future เสร็จสมบูรณ์ ในบางกรณี โค้ดเรียกกลับจะแสดงในชุดข้อความอื่น ดังนั้นให้ตรวจสอบว่าโค้ดใช้เธรดได้อย่างปลอดภัย ข้อมูลโค้ดนี้ใช้ตัวชี้ฟังก์ชันสำหรับการเรียกกลับ

// Registers the OnCompletion callback. user_data is a pointer that is passed verbatim
// to the callback as a void*. This allows you to pass any custom data to the callback
// handler. In this case, the app has no data, so you must pass nullptr.
firebase::gma::InitializeLastResult().OnCompletion(OnCompletionCallback,
  /*user_data=*/nullptr);

// The OnCompletion callback function.
static void OnCompletionCallback(
  const firebase::Future<AdapterInitializationStatus>& future, void* user_data) {
  // Called when the Future is completed for the last call to firebase::gma::Initialize().
  // If the error code is firebase::gma::kAdErrorCodeNone,
  // then the SDK has been successfully initialized.
  if (future.error() == firebase::gma::kAdErrorCodeNone) {
    // success!
  } else {
    // failure.
  }
}

เลือกรูปแบบโฆษณา

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

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

ใช้งานโฆษณาแบนเนอร์

โฆษณาคั่นระหว่างหน้า

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

ใช้โฆษณาคั่นระหว่างหน้า

ได้รับรางวัลแล้ว

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

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