เริ่มเลย

คู่มือนี้จะแสดงวิธีผสานรวมอะแดปเตอร์สื่อกลางเข้ากับ แอปสำหรับ 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