คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณาที่ต้องการสร้างรายได้จากแอป C++ ด้วย AdMob โดยไม่ต้องใช้ Firebase หากคุณวางแผนที่จะรวม Firebase ไว้ในแอปหรือกำลังพิจารณาใช้ Firebase โปรดดูคู่มือนี้ในเวอร์ชัน AdMob ที่มี Firebase แทน
การผสานรวม SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google เข้ากับแอปเป็นขั้นตอนแรกสู่การแสดงโฆษณาและสร้างรายได้ เมื่อผสานรวม SDK แล้ว คุณจะเลือกรูปแบบโฆษณา เช่น โฆษณาคั่นระหว่างหน้า หรือโฆษณาที่มีการให้รางวัล และทำตามขั้นตอนเพื่อติดตั้งใช้งานได้
Google Mobile Ads C++ SDK รวม Google Mobile Ads SDK สำหรับ iOS และ Android และพร้อมให้บริการบนแพลตฟอร์มดังกล่าวเท่านั้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google C++ ใช้โครงสร้าง Firebase C++ เพื่อรองรับการดำเนินการแบบไม่พร้อมกัน จึงอยู่ในเนมสเปซของ firebase::gma
หากนี่เป็นครั้งแรกที่คุณศึกษาคู่มือนี้ เราขอแนะนำให้คุณดาวน์โหลดและทำตามโดยใช้แอปทดสอบ C++ โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google
ข้อกำหนดเบื้องต้น
Android
- ใช้ Android Studio 3.2 ขึ้นไป
- ตรวจสอบว่าไฟล์บิลด์ของแอปใช้ค่าต่อไปนี้
minSdkVersion
ตั้งแต่ 16 ขึ้นไปcompileSdkVersion
ตั้งแต่ 28 ปีขึ้นไป
iOS
- ใช้ Xcode 13 ขึ้นไป
- กำหนดเป้าหมายไปที่ iOS 10.0 ขึ้นไป
ตั้งค่าแอปในบัญชี AdMob
ลงทะเบียนแอปเป็นแอป AdMob โดยทำตามขั้นตอนต่อไปนี้
ลงชื่อเข้าใช้หรือลงชื่อสมัครใช้บัญชี AdMob
ลงทะเบียนแอปกับ AdMob ขั้นตอนนี้จะสร้างแอป AdMob ที่มีรหัสแอป AdMob ที่ไม่ซ้ำ ซึ่งจำเป็นต้องมีในส่วนต่อไปของคู่มือนี้
ติดตั้ง SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google
เนื่องจาก Google Mobile Ads C++ SDK อยู่ในเนมสเปซ firebase::gma
โปรดดาวน์โหลด Firebase C++ SDK
แล้วแตกไฟล์ ZIP ไปยังไดเรกทอรีที่ต้องการ
Firebase C++ SDK ไม่ใช่การกำหนดค่าเฉพาะแพลตฟอร์ม แต่ต้องมีการกำหนดค่าไลบรารีเฉพาะแพลตฟอร์ม
Android
เราขอแนะนำให้ใช้ CMake แต่คุณดูวิธีการสร้าง ndk ได้ในคู่มือเริ่มต้นใช้งาน Firebase C++ SDK ทั่วไปเพื่อลิงก์ libfirebase_app.a
และ libfirebase_gma.a
กับแอปของคุณ
ในไฟล์
gradle.properties
ของโปรเจ็กต์ ให้ระบุตำแหน่งของ SDK ที่แยกไฟล์แล้วดังนี้systemProp.firebase_cpp_sdk.dir=FULL_PATH_TO_SDK
ในไฟล์
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"
ในไฟล์ 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 }
เพิ่มเนื้อหาต่อไปนี้ลงในไฟล์
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}")
ซิงค์แอปเพื่อให้ทรัพยากร Dependency ทั้งหมดมีเวอร์ชันที่จำเป็น
iOS
ขั้นตอนในส่วนนี้คือตัวอย่างของวิธีเพิ่ม SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google C++ ลงในโปรเจ็กต์ iOS
ดาวน์โหลด CocoaPods เวอร์ชัน 1 ขึ้นไปโดยเรียกใช้
sudo gem install cocoapods --pre
เพิ่มพ็อดโฆษณาบนอุปกรณ์เคลื่อนที่ของ Google จาก SDK ที่แยกไฟล์แล้ว
สร้าง Podfile หากคุณยังไม่มี:
cd APP_DIRECTORY
pod init
ไปที่ Podfile เพิ่มพ็อดสำหรับ SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google C++, SDK สำหรับ User Messaging Platform ของ Google และ SDK หลักของ Firebase ขั้นต่ำ (จำเป็นสำหรับ GMA C++ SDK) ดังนี้
pod 'Firebase/CoreOnly' pod 'Google-Mobile-Ads-SDK' pod 'GoogleUserMessagingPlatform'
ติดตั้งพ็อดแล้วเปิดไฟล์
.xcworkspace
ใน Xcodepod install
open APP.xcworkspace
เพิ่มเฟรมเวิร์กต่อไปนี้จาก Firebase C++ SDK ลงในโปรเจ็กต์
xcframeworks/firebase.xcframework
xcframeworks/firebase_gma.xcframework
เรียบร้อยแล้ว แอป C++ ของคุณได้รับการกำหนดค่าให้ใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google C++ โดยไม่ต้องใช้บริการ Firebase อื่นๆ
กำหนดค่ารหัสแอป AdMob ของแอป
Android
ทำตามขั้นตอนที่ 3 ของกำหนดค่าแอปตามที่อธิบายไว้ในคำแนะนำ SDK โฆษณาในอุปกรณ์เคลื่อนที่สำหรับ Android แล้วกลับมาที่หน้านี้
iOS
ทำตามขั้นตอนอัปเดต Info.plist ตามที่อธิบายไว้ในคู่มือ SDK โฆษณาในอุปกรณ์เคลื่อนที่สำหรับ iOS แล้วกลับมาที่หน้านี้
เริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
ก่อนโหลดโฆษณา ให้แอปเริ่มต้น Google Mobile Ads C++ SDK โดยเรียกใช้ firebase::gma::Initialize()
ซึ่งจะเริ่มต้น SDK และดำเนินการ firebase::Future
เมื่อการเริ่มต้นเสร็จสมบูรณ์ (หรือหลังจากหมดเวลา 30 วินาที) โดยจะต้องทำเพียงครั้งเดียวเท่านั้น โดยเฉพาะอย่างยิ่งเมื่อเปิดแอป
โฆษณาอาจโหลดล่วงหน้าโดย SDK C++ โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google หรือ SDK ของพาร์ทเนอร์สื่อกลางเมื่อเรียกใช้ Initialize()
หากต้องการขอความยินยอมจากผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ให้ตั้งค่าแฟล็กเฉพาะสำหรับคำขอ (เช่น tag_for_child_directed_treatment
หรือ tag_for_under_age_of_consent
) หรือดำเนินการก่อนโหลดโฆษณา โปรดเรียกใช้ firebase::gma::SetRequestConfiguration()
ก่อนเริ่มต้น SDK ของ Google Ads สำหรับ Google Mobile ดูข้อมูลเพิ่มเติมได้ในคู่มือการกำหนดเป้าหมาย
ตัวอย่างวิธีโทรหา 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 มีรูปแบบโฆษณาต่างๆ มากมายเพื่อให้คุณเลือก รูปแบบที่เหมาะกับประสบการณ์ของผู้ใช้แอปมากที่สุด
แบนเนอร์
โฆษณาทรงสี่เหลี่ยมผืนผ้าที่ปรากฏด้านบนหรือด้านล่างของหน้าจออุปกรณ์ โฆษณาแบนเนอร์จะแสดงบนหน้าจอขณะที่ผู้ใช้โต้ตอบกับแอป และรีเฟรชโดยอัตโนมัติได้หลังจากผ่านไประยะหนึ่ง หากคุณเพิ่งเริ่มใช้การโฆษณา บนอุปกรณ์เคลื่อนที่ วิธีนี้เป็นการเริ่มต้นที่ดี
โฆษณาคั่นระหว่างหน้า
โฆษณาแบบเต็มหน้าจอที่บดบังอินเทอร์เฟซของแอปจนกว่าผู้ใช้จะปิด โดยจะเหมาะสำหรับการหยุดพักตามปกติในขั้นตอนการดำเนินแอป เช่น ระหว่างการเปลี่ยนด่านเกมหรือหลังจากทำงานเสร็จสักหน่อย
ได้รับรางวัลแล้ว
โฆษณาที่ให้รางวัลผู้ใช้จากการชมวิดีโอสั้นๆ และโต้ตอบกับโฆษณาที่เล่นได้และแบบสำรวจ ใช้สำหรับสร้างรายได้จากแอปที่เปิดให้เล่นฟรี