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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เวอร์ชันเก่า)

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

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

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

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

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

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

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

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

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

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

กำหนดค่าแอป

  1. รวมที่เก็บ Maven ของ Google และ ที่เก็บ Maven Central ไว้ในไฟล์การตั้งค่า Gradle โดยทำดังนี้

    Kotlin

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

    Groovy

    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 (Legacy) ลงในไฟล์บิลด์ระดับแอปโดยทำดังนี้

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:25.4.0")
}

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:25.4.0'
}

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

  4. เพิ่มรหัสแอป AdMob ตามที่ ระบุไว้ในอินเทอร์เฟซเว็บ AdMob, ลงในไฟล์ AndroidManifest.xml ของแอป โดยเพิ่มแท็ก <meta-data> ที่มี android:name="com.google.android.gms.ads.APPLICATION_ID" คุณดูรหัสแอป ได้ในอินเทอร์เฟซเว็บ AdMob สำหรับ android:value ให้แทรกรหัสแอป AdMob ของคุณเองโดยใส่ไว้ในเครื่องหมายคำพูด

    <manifest>
  <application>
    <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="SAMPLE_APP_ID"/>
  </application>
</manifest>

    แทนที่ SAMPLE_APP_ID ด้วยรหัสแอป AdMob ขณะทดสอบ ให้ใช้รหัสแอปตัวอย่างที่แสดงในตัวอย่างก่อนหน้า

    โปรดทราบด้วยว่าหากเพิ่มแท็ก <meta-data> ไม่ตรงตามที่แสดงไว้ทุกประการ จะทำให้แอปขัดข้องและแสดงข้อความต่อไปนี้

    Missing application ID.

    (ไม่บังคับ) ประกาศสิทธิ์ AD_ID เพื่อให้เวอร์ชันก่อนหน้าทำงานร่วมกับ Android 13 ได้

    หากแอปของคุณใช้ Google Mobile Ads SDK (Legacy) เวอร์ชัน 20.4.0 หรือ สูงกว่า คุณสามารถข้ามขั้นตอนนี้ได้เนื่องจาก SDK จะประกาศสิทธิ์ com.google.android.gms.permission.AD_ID โดยอัตโนมัติและเข้าถึงรหัสโฆษณาได้ทุกเมื่อที่พร้อมใช้งาน

    สำหรับแอปที่ใช้ Google Mobile Ads SDK (Legacy) เวอร์ชัน 20.3.0 ลงไปและกำหนดเป้าหมายเป็น Android 13 คุณต้องเพิ่มสิทธิ์ com.google.android.gms.permission.AD_ID ในไฟล์ AndroidManifest.xml เพื่อให้ Google Mobile Ads SDK (Legacy) เข้าถึง รหัสโฆษณาได้โดยทำดังนี้

    <manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    ดูข้อมูลเพิ่มเติมเกี่ยวกับการประกาศสิทธิ์ com.google.android.gms.permission.AD_ID รวมถึงวิธีปิดใช้ได้ที่บทความนี้ใน Play Console

เริ่มต้น Google Mobile Ads SDK (Legacy)

ก่อนโหลดโฆษณา ให้เริ่มต้น Google Mobile Ads SDK (Legacy) โดยเรียกใช้ MobileAds.initialize()

เมธอดนี้จะเริ่มต้น SDK และเรียกใช้ Listener การดำเนินการให้เสร็จสมบูรณ์เมื่อการเริ่มต้น Google Mobile Ads SDK (Legacy) และการเริ่มต้นตัวดัดแปลงเสร็จสมบูรณ์แล้ว หรือหลังจากหมดเวลา 30 วินาที คุณต้องดำเนินการนี้เพียงครั้งเดียว ซึ่งควรทำเมื่อเปิดแอป

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

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

ตัวอย่างวิธีเรียกใช้เมธอด initialize() ในเธรดเบื้องหลังภายในกิจกรรม

Java

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MainActivity) {}
}

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

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

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

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

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

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

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

เนทีฟ

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

ติดตั้งใช้งานโฆษณาเนทีฟ

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

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

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

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

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

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

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

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

โฆษณาเปิดแอป

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

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

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

ที่เก็บ Google Mobile Ads ใน GitHub แสดง วิธีใช้รูปแบบโฆษณาต่างๆ ที่ API นี้มีให้