การผสานรวม 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> <!-- 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>
ดังที่แสดงด้านบนจะทําให้ มีข้อความขัดข้อง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 นี้มีให้