ตั้งค่า Google Mobile Ads SDK

เลือกแพลตฟอร์ม: Android Android iOS Unity Flutter

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

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

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

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

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

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

ตั้งค่าแอปในบัญชี 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:25.4.0")
   }

   ดึงดูด

   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 เวอร์ชัน 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 นี้

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

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

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

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

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

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

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

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

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

แบนเนอร์

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

ใช้โฆษณาแบนเนอร์

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

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

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

เนทีฟ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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