เริ่มใช้งาน

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

คู่มือนี้แสดงวิธีผสานรวมตัวกลางสื่อกลางกับแอป Android

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

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

หากเพิ่งเริ่มใช้สื่อกลาง อ่าน ข้อมูลเบื้องต้นเกี่ยวกับสื่อกลาง

สำหรับการเสนอราคา SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 18.3.0 ขึ้นไป

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

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

โค้ดตัวอย่างต่อไปนี้แสดงวิธีตรวจสอบสถานะการเริ่มต้นของ อแดปเตอร์แต่ละตัวก่อนที่จะส่งคำขอโฆษณา

Java

public void initialize(Context context) {
  new Thread(
          () ->
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(context, this::logAdapterStatus))
      .start();
}

private void logAdapterStatus(InitializationStatus initializationStatus) {
  // Check each adapter's initialization status.
  Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
  for (Map.Entry<String, AdapterStatus> entry : statusMap.entrySet()) {
    String adapterClass = entry.getKey();
    AdapterStatus status = entry.getValue();
    Log.d(
        TAG,
        String.format(
            "Adapter name: %s, Description: %s, Latency: %d",
            adapterClass, status.getDescription(), status.getLatency()));
  }
}
MediationSnippets.java

Kotlin

fun initialize(context: Context) {
  CoroutineScope(Dispatchers.IO).launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(context, ::logAdapterStatus)
  }
}

private fun logAdapterStatus(initializationStatus: InitializationStatus) {
  // Check each adapter's initialization status.
  for ((adapterClass, status) in initializationStatus.adapterStatusMap) {
    Log.d(
      TAG,
      "Adapter: $adapterClass, Status: ${status.description}, Latency: ${status.latency}ms",
    )
  }
}

MediationSnippets.kt

ตรวจสอบว่าคลาสอะแดปเตอร์เครือข่ายโฆษณาใดโหลดโฆษณา

นี่คือโค้ดตัวอย่างที่บันทึกชื่อคลาสเครือข่ายโฆษณาสำหรับโฆษณาแบนเนอร์

Java

ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
  adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);
ResponseInfoSnippets.java

Kotlin

Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)
ResponseInfoSnippets.kt

ดูรายละเอียดเกี่ยวกับวิธีการนี้ได้ในResponseInfoเอกสารประกอบเกี่ยวกับ getMediationAdapterClassName()

เริ่มต้นออบเจ็กต์โฆษณาด้วยอินสแตนซ์ของกิจกรรม

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

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

ใช้โฆษณาเนทีฟกับสื่อกลาง

ต่อไปนี้คือแนวทางปฏิบัติแนะนำบางส่วนที่ควรพิจารณาเมื่อใช้สื่อกลางแบบเนทีฟ

นโยบายการนำเสนอโฆษณาเนทีฟ
เครือข่ายโฆษณาแต่ละเครือข่ายมีนโยบายของตนเอง เมื่อใช้สื่อกลาง คุณต้อง อย่าลืมว่าแอปของคุณยังคงต้องปฏิบัติตามนโยบายของเครือข่ายสื่อกลาง ที่แสดงโฆษณา
ใช้ loadAd() แทน loadAds()
วิธี loadAds() จะแสดงเฉพาะโฆษณา Google สําหรับโฆษณาที่สื่อกลาง ให้ใช้ loadAd() แทน

กฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาและ GDPR

หากคุณต้องปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาหรือกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ให้ทำตามขั้นตอนในการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาหรือการตั้งค่า GDPR เพื่อเพิ่มพาร์ทเนอร์สื่อกลางในรายการพาร์ทเนอร์โฆษณาของรัฐในสหรัฐอเมริกาหรือ GDPR ในความเป็นส่วนตัวและการแสดงข้อความแจ้งผู้ใช้ของ Ad Manager หากไม่ดำเนินการดังกล่าว พาร์ทเนอร์อาจ แสดงโฆษณาในแอปของคุณไม่ได้

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้การประมวลผลข้อมูลแบบจำกัด (RDP) และการขอรับความยินยอมตาม GDPR ด้วย SDK สำหรับ User Messaging Platform (UMP) ของ Google

ถัดไป
เลือกเครือข่าย