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

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

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

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

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

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

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

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

กำหนดค่าแอป

  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.4.0")
}

    ดึงดูด

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

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

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

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

    แทนที่ /<network_code>~<application_id> ด้วยรหัสแอป Ad Manager ขณะทดสอบ ให้ใช้รหัสแอปตัวอย่างที่แสดงในตัวอย่างก่อนหน้า

    นอกจากนี้ โปรดทราบว่าการไม่เพิ่มแท็ก <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 เพื่อให้ 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

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

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

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

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

Java

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

Kotlin

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

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

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

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

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

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

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

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

เนทีฟ

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

Google Ad Manager มีวิธีติดตั้งใช้งานโฆษณาเนทีฟ 2 วิธี ได้แก่ สไตล์โฆษณาเนทีฟและ โฆษณาเนทีฟมาตรฐานผ่านการแสดงผลที่กำหนดเอง

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

ใช้สไตล์โฆษณาเนทีฟ ใช้โฆษณาเนทีฟ (การแสดงผลที่กำหนดเอง)

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

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

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

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

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

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

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

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

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

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

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

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

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