ตั้งค่าสื่อกลาง

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

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

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

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

หากยังไม่เคยใช้สื่อกลาง โปรดอ่าน ข้อมูลเบื้องต้นเกี่ยวกับสื่อกลาง

สำหรับการเสนอราคา: Google Mobile Ads SDK 18.3.0 ขึ้นไป

เริ่มต้นใช้งาน Google Mobile Ads SDK

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

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

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()));
  }
}

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",
    )
  }
}

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

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

Java

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

Kotlin

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

โปรดดูรายละเอียดเกี่ยวกับเมธอดนี้ในเอกสารประกอบ 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 ด้วย Google User Messaging Platform (UMP) SDK

ถัดไป
เลือกแหล่งที่มาของโฆษณา