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

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

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

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

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

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

    • SDK เวอร์ชันขั้นต่ำ 19 ขึ้นไป
    • คอมไพล์ SDK เวอร์ชัน 33 ขึ้นไป

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

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

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

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

กำหนดค่าแอป

  1. ในไฟล์ build.gradle ระดับโปรเจ็กต์ ให้ใส่ที่เก็บ Maven ของ Google และที่เก็บส่วนกลาง Maven ไว้ในส่วน buildscript และallprojects

    buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

  2. เพิ่มทรัพยากร Dependency สำหรับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ลงในไฟล์ Gradle ระดับแอปของโมดูล ซึ่งปกติคือ app/build.gradle ดังนี้

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

  3. เพิ่ม 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

    หากแอปใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 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 สำหรับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อเข้าถึงรหัสโฆษณา

    <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

ก่อนโหลดโฆษณา ให้เริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ด้วยการเรียกใช้ MobileAds.initialize()

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

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

ต่อไปนี้คือตัวอย่างวิธีเรียกใช้เมธอด 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);

    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {
        }
    });
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds

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

    MobileAds.initialize(this) {}
  }
}

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

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

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

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

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

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

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

เนทีฟ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ที่เก็บโฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ใน GitHub สาธิตวิธีใช้โฆษณารูปแบบต่างๆ ที่ API นี้นำเสนอ