เริ่มเลย

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

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

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

• โฆษณาแบนเนอร์
• โฆษณาคั่นระหว่างหน้า
• โฆษณาเนทีฟ
• โฆษณาที่มีการให้รางวัล
• โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล โฆษณา

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

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

เริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่

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

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

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

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...
      }
    }
  }
}

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

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

public void onAdLoaded() {
  Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}

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 การตั้งค่าเพื่อเพิ่ม พาร์ทเนอร์สื่อกลางใน "ความเป็นส่วนตัวและ" ของ Ad Manager ของการรับส่งข้อความ รายชื่อรัฐในสหรัฐอเมริกาหรือรายชื่อพาร์ทเนอร์โฆษณา GDPR มิเช่นนั้น อาจมีพาร์ทเนอร์ ไม่ได้แสดงโฆษณาในแอป