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

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

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

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

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

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

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

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

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

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

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

กำหนดค่าแอป

  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.gms:play-services-ads:24.2.0")
}

    ดึงดูด

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.2.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="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>

    ในแอปจริง ให้แทนที่รหัสแอปตัวอย่างด้วยรหัสแอป AdMob จริง คุณใช้รหัสตัวอย่างได้หากเพียงแค่ทดลองใช้ SDK ในแอป Hello World

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

    Missing application ID.

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

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

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

    <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

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

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

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

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

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

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

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, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
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) {}
    }
  }
}

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

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

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

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

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

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

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

เนทีฟ

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

ใช้โฆษณาเนทีฟ

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

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

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

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

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

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

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

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

การเปิดแอป

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

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

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

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