คู่มือนี้จะแสดงวิธีผสานรวมอะแดปเตอร์สื่อกลางเข้ากับ แอปสำหรับ Android
ข้อกำหนดเบื้องต้น
ก่อนที่คุณจะสามารถผสานรวมสื่อกลางสำหรับรูปแบบโฆษณา คุณจะต้องผสานรวม รูปแบบโฆษณาลงในแอปของคุณ
- โฆษณาแบนเนอร์
- โฆษณาคั่นระหว่างหน้า
- โฆษณาเนทีฟ
- โฆษณาที่มีการให้รางวัล
- โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล โฆษณา
หากเพิ่งเคยใช้สื่อกลาง อ่านแล้ว ข้อมูลเบื้องต้นเกี่ยวกับสื่อกลาง
สำหรับการเสนอราคา: SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google 18.3.0 หรือสูงกว่า
เริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่
คู่มือเริ่มใช้งานฉบับย่อแสดงวิธีเริ่มต้นโฆษณาบนมือถือ SDK ระหว่างการเรียกใช้เริ่มต้น อะแดปเตอร์สื่อกลางยัง ได้เริ่มต้น คุณต้องรอให้การเริ่มต้นเสร็จสมบูรณ์ก่อน เมื่อคุณโหลดโฆษณา เพื่อให้มั่นใจว่าคุณมีส่วนร่วมอย่างเต็มที่จากเครือข่ายโฆษณาทุกเครือข่าย คำขอโฆษณาแรก
โค้ดตัวอย่างต่อไปนี้แสดงวิธีตรวจสอบการเริ่มต้นของอะแดปเตอร์แต่ละรายการ ก่อนส่งคำขอโฆษณา
Java
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.AdapterStatus;
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);
new Thread(
() ->
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(
this,
initializationStatus -> {
Map<String, AdapterStatus> statusMap =
initializationStatus.getAdapterStatusMap();
for (String adapterClass : statusMap.keySet()) {
AdapterStatus status = statusMap.get(adapterClass);
Log.d(
"MyApp",
String.format(
"Adapter name: %s, Description: %s, Latency: %d",
adapterClass, status.getDescription(), status.getLatency()));
}
// Start loading ads here...
}))
.start();
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val backgroundScope = CoroutineScope(Dispatchers.IO)
backgroundScope.launch {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this@MainActivity) { initializationStatus ->
val statusMap =
initializationStatus.adapterStatusMap
for (adapterClass in statusMap.keys) {
val status = statusMap[adapterClass]
Log.d(
"MyApp", String.format(
"Adapter name: %s, Description: %s, Latency: %d",
adapterClass, status!!.description, status.latency
)
)
}
// Start loading ads here...
}
}
}
}
ตรวจสอบว่าอะแดปเตอร์เครือข่ายโฆษณาใดโหลดโฆษณา
ต่อไปนี้คือตัวอย่างโค้ดที่บันทึกชื่อคลาสเครือข่ายโฆษณาสำหรับโฆษณาแบนเนอร์
Java
public void onAdLoaded() {
Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}
Kotlin
override fun onAdLoaded() {
Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}
โปรดดูเอกสารประกอบ ResponseInfo
ใน getMediationAdapterClassName()
เพื่อดูรายละเอียดเกี่ยวกับวิธีนี้
เริ่มต้นออบเจ็กต์โฆษณาด้วยอินสแตนซ์กิจกรรม
ในคอนสตรคเตอร์สําหรับออบเจ็กต์โฆษณาใหม่ (เช่น AdManagerAdView
) คุณต้องส่งออบเจ็กต์ประเภท Context
ระบบจะใช้Context
นี้ไปยังเครือข่ายโฆษณาอื่นๆ เมื่อใช้สื่อกลาง ใช้บ้าง
เครือข่ายโฆษณาต้องมี Context
ที่จำกัดมากกว่า ซึ่งเป็นประเภท
Activity
และอาจแสดงโฆษณาไม่ได้หากไม่มีอินสแตนซ์ Activity
ดังนั้น
เราขอแนะนำให้ส่งในอินสแตนซ์ Activity
เมื่อเริ่มต้นออบเจ็กต์โฆษณา
เพื่อให้มั่นใจได้ว่าเครือข่ายโฆษณาที่ใช้สื่อกลางจะได้รับประสบการณ์ที่สอดคล้องกัน
ใช้โฆษณาแบนเนอร์กับสื่อกลาง
อย่าลืมปิดการรีเฟรชใน UI แหล่งที่มาของโฆษณาบุคคลที่สามทั้งหมดสําหรับโฆษณาแบนเนอร์ หน่วยที่ใช้ในสื่อกลาง ซึ่งจะป้องกันไม่ให้ รีเฟรช 2 ครั้งเนื่องจาก Ad Manager จะทริกเกอร์การรีเฟรชด้วย ขึ้นอยู่กับอัตราการรีเฟรชของหน่วยโฆษณาแบนเนอร์
ใช้โฆษณาเนทีฟกับสื่อกลาง
ต่อไปนี้คือแนวทางปฏิบัติแนะนำที่ควรพิจารณาเมื่อใช้โฆษณาเนทีฟ สื่อกลาง
- นโยบายการนำเสนอโฆษณาเนทีฟ
- เครือข่ายโฆษณาแต่ละเครือข่ายมีนโยบายของตนเอง เมื่อใช้สื่อกลาง สิ่งสำคัญคือ อย่าลืมว่าแอปของคุณยังคงต้องเป็นไปตามนโยบายของสื่อกลาง เครือข่ายที่แสดงโฆษณาดังกล่าว
- ใช้
loadAd()
แทนloadAds()
- เมธอด
loadAds()
จะแสดงเฉพาะโฆษณา Google เท่านั้น สำหรับโฆษณาที่ใช้สื่อกลาง ให้ใช้loadAd()
แทน
กฎหมายคุ้มครองความเป็นส่วนตัวและ GDPR ของรัฐในสหรัฐอเมริกา
หากต้องปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาหรือกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ให้ทําตามขั้นตอนในการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาหรือการตั้งค่า GDPR เพื่อเพิ่มพาร์ทเนอร์สื่อกลางในรายชื่อพาร์ทเนอร์โฆษณาของรัฐในสหรัฐอเมริกาหรือ GDPR ของความเป็นส่วนตัวและการรับส่งข้อความของ Ad Manager หากไม่ดำเนินการดังกล่าว อาจส่งผลให้พาร์ทเนอร์แสดงโฆษณาในแอปไม่ได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้การประมวลผลข้อมูลแบบจำกัด (RDP) และการรับ GDPR ให้ความยินยอมกับ Google User Messaging Platform (UMP) SDK