เริ่มใช้งาน

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

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

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

หากเพิ่งเริ่มใช้สื่อกลาง อ่าน ภาพรวมของสื่อกลาง AdMob

เริ่มต้น Google Mobile Ads SDK (เบต้า)

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

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

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
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 Google Mobile Ads SDK (beta) on a background thread.
      MobileAds.initialize(this@MainActivity, InitializationConfig.Builder("SAMPLE_APP_ID").build()) {
        initializationStatus ->
        for ((adapterName, adapterStatus) in initializationStatus.adapterStatusMap) {
          Log.d(
            "MyApp",
            String.format(
              "Adapter name: %s, Status code: %s, Status string: %s, Latency: %d",
              adapterName,
              adapterStatus.initializationState,
              adapterStatus.description,
              adapterStatus.latency,
            ),
          )
        }
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.AdapterStatus;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize Google Mobile Ads SDK (beta) on a background thread.
              MobileAds.initialize(
                  this,
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    Map<String, AdapterStatus> adapterStatusMap =
                        initializationStatus.getAdapterStatusMap();
                    for (String adapterClass : adapterStatusMap.keySet()) {
                      AdapterStatus adapterStatus = adapterStatusMap.get(adapterClass);
                      Log.d(
                          "MyApp",
                          String.format(
                              "Adapter name: %s, Status code: %s, Status description: %s,"
                                  + " Latency: %d",
                              adapterClass,
                              adapterStatus.getInitializationState(),
                              adapterStatus.getDescription(),
                              adapterStatus.getLatency()));
                    }
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

ไม่รวมโมดูล com.google.android.gms ในการผสานรวมสื่อกลาง

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

ในไฟล์ build.gradle ระดับแอป ให้ยกเว้นทั้งโมดูล play-services-ads และ play-services-ads-lite จากการอ้างอิงทั้งหมดทั่วโลก

configurations {
  all {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
  }
}

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

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

Kotlin

BannerAd.load(
  BannerAdRequest.Builder("AD_UNIT_ID", AdSize.BANNER).build(),
  object : AdLoadCallback<BannerAd> {
    override fun onAdLoaded(ad: BannerAd) {
      Log.d(
        "MyApp", "Adapter class name: " +
          ad.getResponseInfo().mediationAdapterClassName
      )
    }
  }
)

Java

BannerAd.load(
  new BannerAdRequest.Builder("AD_UNIT_ID", AdSize.BANNER).build(),
  new AdLoadCallback<BannerAd>() {
    @Override
    public void onAdLoaded(@NonNull BannerAd ad) {
      Log.d("MyApp",
          "Adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
    }
  }
);

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

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

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

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