시작하기

이 가이드에는 미디에이션 어댑터를 Android 앱

기본 요건

광고 형식에 대한 미디에이션을 통합하려면 먼저 해당 미디에이션을 통합해야 합니다. 앱에 삽입해야 합니다.

미디에이션이 처음이신가요? 읽기 미디에이션 소개

입찰의 경우: Google 모바일 광고 SDK 18.3.0 또는 그 이상일 수 있습니다.

모바일 광고 SDK 초기화

빠른 시작 가이드에는 모바일 광고를 초기화하는 방법이 나와 있습니다. SDK를 사용하는 것이 좋습니다. 초기화 호출 도중에는 미디에이션 어댑터도 초기화됩니다. 초기화가 완료될 때까지 기다린 후에 Google 디스플레이 네트워크에 있는 모든 광고 네트워크가 첫 번째 광고 요청에 광고가 게재됩니다.

다음 샘플 코드는 각 어댑터의 초기화를 확인하는 방법을 보여줍니다. 상태를 변경할 수 있습니다.

자바

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

광고를 로드한 광고 네트워크 어댑터 클래스 확인

다음은 배너 광고의 광고 네트워크 클래스 이름을 기록하는 샘플 코드입니다.

자바

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

getMediationAdapterClassName()ResponseInfo 문서를 참고하세요. 를 참조하세요.

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

새 광고 객체의 생성자에서 (예: AdManagerAdView), 특정 유형의 객체를 전달해야 하는 Context. 미디에이션을 사용할 때 이 Context가 다른 광고 네트워크에 전달됩니다. 다소 유용함 광고 네트워크에는Context Activity Activity 인스턴스가 없으면 광고를 게재하지 못할 수도 있습니다. 따라서 광고 객체를 초기화할 때 Activity 인스턴스를 전달하는 것이 좋습니다. 미디에이션된 광고 네트워크에서 일관된 환경을 제공할 수 있습니다.

미디에이션과 함께 배너 광고 사용

모든 서드 파티 광고 소스 UI에서 배너 광고에 대한 새로고침을 중지하세요. 조정에 사용되는 단위 이렇게 하면 Ad Manager에서도 새로고침을 트리거하므로 배너 광고 단위의 새로고침 빈도에 따라 설정할 수 있습니다

미디에이션과 함께 네이티브 광고 사용

다음은 네이티브 광고를 구현할 때 고려해야 할 몇 가지 권장사항입니다. 중재를 받을 수도 있습니다.

네이티브 광고 표시 정책
광고 네트워크마다 자체 정책이 있습니다. 미디에이션을 사용할 때는 앱은 여전히 미디에이션 대상 이 광고 네트워크를 통해 전달됩니다.
loadAds() 대신 loadAd() 사용
loadAds() 메서드는 Google 광고만 게재합니다. 미디에이션된 광고의 경우 대신 loadAd()하세요.

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

미국 주 개인 정보 보호 법률 또는 개인 정보 보호법 규정 (GDPR)에 따라 미국 주 규정의 단계 설정 또는 GDPR 설정으로 이동하여 Ad Manager의 미디에이션 파트너 개인 정보 보호 및 메시지 미국 주 또는 GDPR 광고 파트너 목록입니다. 그렇지 않을 경우 파트너가 문제를 해결할 수 있습니다

제한적인 데이터 처리 사용 설정에 대해 자세히 알아보기 (RDP) 및 GDPR 입수 Google 사용자 메시지 플랫폼 (UMP)에 대한 동의 SDK를 사용하는 것이 좋습니다.