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

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

ก่อนเริ่มต้น

หากต้องการเตรียมแอป ให้ทำตามขั้นตอนในส่วนต่อไปนี้

ข้อกําหนดเบื้องต้นของแอป

• ตรวจสอบว่าไฟล์บิลด์ของแอปใช้ค่าต่อไปนี้

  • SDK เวอร์ชันต่ำสุด 24 ขึ้นไป
  • คอมไพล์ SDK เวอร์ชัน 35 ขึ้นไป

• สำหรับแอป Kotlin ให้ใช้ Kotlin เวอร์ชัน 1.9 เป็นเวอร์ชันต่ำสุด

กำหนดค่าแอป

1. ในไฟล์การตั้งค่า Gradle ให้ใส่ที่เก็บ Maven ของ Google และที่เก็บส่วนกลางของ Maven

   Kotlin

   pluginManagement {
     repositories {
       google()
       mavenCentral()
       gradlePluginPortal()
     }
   }
   
   dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
     repositories {
       google()
       mavenCentral()
     }
   }
   
   rootProject.name = "My Application"
   include(":app")

   ดึงดูด

   pluginManagement {
     repositories {
       google()
       mavenCentral()
       gradlePluginPortal()
     }
   }
   
   dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
     repositories {
       google()
       mavenCentral()
     }
   }
   
   rootProject.name = "My Application"
   include ':app'

2. เพิ่ม Dependency ของ Google Mobile Ads SDK ลงในไฟล์บิลด์ระดับแอป โดยทำดังนี้

   Kotlin

   dependencies {
     implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.17.0-alpha02")
   }

   ดึงดูด

   dependencies {
     implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.17.0-alpha02'
   }

3. คลิกซิงค์เลย โปรดดูรายละเอียดเกี่ยวกับการซิงค์ที่หัวข้อซิงค์โปรเจ็กต์กับไฟล์ Gradle

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

ประเด็นสําคัญ: คุณต้องเริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ก่อนโหลดโฆษณาและโต้ตอบกับวิธีอื่นๆ ของ MobileAds เว้นแต่จะระบุไว้อย่างชัดเจนในเอกสารอ้างอิง API (ดูgetVersion()) ไม่เช่นนั้นระบบอาจแสดงข้อผิดพลาด UninitializedPropertyAccessException

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

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

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

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

SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google หรือ SDK ของพาร์ทเนอร์สื่อกลางอาจโหลดโฆษณาไว้ล่วงหน้าเมื่อเริ่มต้น หากต้องการขอความยินยอมจากผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ให้ตั้งค่า Flag ที่เจาะจงคำขอ เช่น RequestConfiguration.TagForChildDirectedTreatment หรือ RequestConfiguration.TagForUnderAgeOfConsent หรือดำเนินการก่อนที่จะโหลดโฆษณา โปรดตรวจสอบว่าคุณดำเนินการดังกล่าวก่อนที่จะเริ่มต้นใช้งาน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

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

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

ป้ายประกาศ

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

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

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

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

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

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

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

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

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

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

ผู้ใช้ไม่จําเป็นต้องเลือกดูโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล ซึ่งต่างจากโฆษณาที่มีการให้รางวัล

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

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

การเปิดแอป

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

ใช้โฆษณาเปิดแอป