시작하기

이 가이드에서는 미디에이션 어댑터를 Android 앱과 통합하는 방법을 설명합니다.

기본 요건

광고 형식에 적합한 미디에이션 기능을 통합하기 전에 해당 광고 형식을 앱에 통합해야 합니다.

• 배너 광고
• 전면 광고
• 네이티브 광고
• 보상형 광고
• 보상형 전면 광고

미디에이션을 처음 사용하시나요? 미디에이션 소개를 읽어보세요.

입찰: Google 모바일 광고 SDK 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)
}

이 메서드에 대한 자세한 내용은 getMediationAdapterClassName() 관련 ResponseInfo 문서를 참고하세요.

Activity 인스턴스로 광고 객체 초기화

새 광고 객체의 생성자 (예: AdManagerAdView)에서 Context 유형의 객체를 전달해야 합니다. 미디에이션을 사용할 때 이러한 Context가 다른 광고 네트워크로 전달됩니다. 일부 광고 네트워크에서는 Activity 유형의 더 제한적인 Context가 필요할 수 있으며, Activity 인스턴스가 없으면 광고를 게재하지 못할 수도 있습니다. 따라서 미디에이션 대상 광고 네트워크와 일관된 환경이 유지되도록, 광고 객체를 초기화할 때 Activity 인스턴스를 전달하는 것이 좋습니다.

미디에이션을 사용한 배너 광고

미디에이션에 사용되는 배너 광고 단위에 대한 모든 서드 파티 광고 소스 UI에서 새로고침을 중지하세요. 배너 광고 단위의 새로고침 빈도에 따라 Ad Manager에서도 새로고침을 실행하므로 위와 같이 조치하면 이중 새로고침을 방지할 수 있습니다.

미디에이션으로 네이티브 광고 사용

다음은 네이티브 광고 미디에이션을 구현할 때 고려해야 하는 몇 가지 권장사항입니다.

네이티브 광고 표시 정책

광고 네트워크마다 자체 정책이 있습니다. 미디에이션을 사용할 때는 앱에 광고를 제공한 미디에이션 대상 네트워크의 정책도 준수해야 함을 잊지 마시기 바랍니다.

loadAds() 대신 loadAd() 사용

loadAds() 메서드는 Google 광고만 게재합니다. 미디에이션된 광고의 경우 loadAd()를 대신 사용하세요.

미국 주 개인 정보 보호법 및 GDPR

미국 주 개인 정보 보호법 또는 개인 정보 보호법 (GDPR)을 준수해야 하는 경우 미국 주 규정 설정 또는 GDPR 설정의 단계에 따라 Ad Manager 개인 정보 보호 및 메시지의 미국 주 또는 GDPR 광고 파트너 목록에 미디에이션 파트너를 추가하세요. 이렇게 하지 않으면 파트너가 앱에 광고를 게재하지 못할 수 있습니다.