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

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

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

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

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

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

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

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

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

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

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

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

กำหนดค่าแอป

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

    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) ลงในไฟล์ Build ระดับแอป ดังนี้

    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. คลิก Sync Now ดูรายละเอียดเกี่ยวกับการซิงค์ได้ที่ ซิงค์โปรเจ็กต์กับไฟล์ 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 ให้รอจนกว่าจะมีการเรียกใช้ Handler การดำเนินการให้เสร็จสมบูรณ์ก่อนโหลดโฆษณา ซึ่งจะช่วยให้มั่นใจว่าอะแดปเตอร์การทําสื่อกลางทั้งหมดได้รับการเริ่มต้น

Google Mobile Ads SDK (เวอร์ชันเก่า) หรือ SDK ของพาร์ทเนอร์การทําสื่อกลางอาจโหลดโฆษณาล่วงหน้า เมื่อเริ่มต้นGoogle Mobile Ads SDK (Legacy) หากคุณต้องขอความยินยอมจากผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ให้ตั้งค่าแฟล็กคำขอเฉพาะ เช่น 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 นี้มีให้