หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

ข้อควรทราบก่อนที่จะเริ่มต้น

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

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

ใช้ Android Studio 3.2 ขึ้นไป
ตรวจสอบว่าไฟล์บิวด์ของแอปใช้ค่าต่อไปนี้
- minSdkVersion ตั้งแต่ 19 ขึ้นไป
- compileSdkVersion ตั้งแต่ 28 ขึ้นไป

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

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

ลงชื่อเข้าใช้หรือลงชื่อสมัครใช้บัญชี AdMob
ลงทะเบียนแอปกับ AdMob ขั้นตอนนี้จะสร้างแอป AdMob ที่มีรหัสแอป AdMob โดยเฉพาะ ซึ่งจําเป็นสําหรับการใช้งานในภายหลังในคู่มือนี้

กําหนดค่าแอปของคุณ

ในไฟล์ build.gradle ระดับโปรเจ็กต์ ให้รวมที่เก็บ Maven ของ Google และที่เก็บส่วนกลางของ Maven ทั้งใน buildscript และallprojects
```
buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}
```
เพิ่ม Dependency สําหรับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ลงในไฟล์ Gradle ระดับโมดูลของโมดูล ซึ่งโดยปกติจะเป็น app/build.gradle
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:22.1.0'
}
```
เพิ่ม AdMob รหัสแอป (ระบุใน AdMob UI) ลงในไฟล์AndroidManifest.xmlของแอป หากต้องการทําเช่นนั้น ให้เพิ่มแท็ก <meta-data> ด้วย android:name="com.google.android.gms.ads.APPLICATION_ID" คุณดูรหัสแอปได้ใน AdMob UI สําหรับ android:value ให้ใส่ AdMob รหัสแอป ของคุณเอง โดยใส่เครื่องหมายคําพูด
```
<manifest>
    <application>
        
        <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> ดังที่แสดงด้านบนจะทําให้ มีข้อความขัดข้อง
```
The Google Mobile Ads SDK was initialized incorrectly.
```
(ไม่บังคับ) ประกาศสิทธิ์ AD_ID สําหรับเวอร์ชันก่อนหน้าให้ทํางานกับ Android 13 ได้

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

สําหรับแอปที่ใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 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 เสร็จสมบูรณ์เมื่อการเริ่มต้นเสร็จสมบูรณ์แล้ว (หรือหลังจากระยะหมดเวลา 30 วินาที) ซึ่งต้องทําเพียงครั้งเดียวเท่านั้น ขอแนะนําอย่างยิ่งเมื่อเปิดแอป

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

        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 มีรูปแบบโฆษณาหลายรูปแบบให้เลือก คุณจึงสามารถเลือกรูปแบบที่เหมาะสมกับประสบการณ์ของผู้ใช้แอปมากที่สุด

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

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

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

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

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

เนทีฟ

โฆษณาที่สามารถกําหนดค่าได้ซึ่งตรงกับรูปลักษณ์ของแอปคุณ คุณกําหนดได้ว่าจะวางโฆษณาไว้ที่ใดและที่ใด ดังนั้นการออกแบบจึงสอดคล้องกับการออกแบบของแอปคุณมากขึ้น

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

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

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

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

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

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