광고 메타데이터

플랫폼 선택: Android iOS

이 가이드는 Android용 Google 모바일 광고 SDK와 함께 광고 메타데이터를 통합하려는 게시자를 대상으로 작성되었습니다.

기본 요건

  • Google 모바일 광고 SDK의 최소 버전은 17.0.0입니다.
  • 리워드 동영상의 단계를 완료합니다.

광고 메타데이터 가져오는 중

게재된 광고에 대해 자세히 알아보려면 보상형 동영상 광고에서 광고 메타데이터 변경사항을 수신 대기하세요.

onAdMetadataChanged()는 광고가 로드된 직후 또는 로드된 후 메타데이터가 비동기적으로 변경될 때 호출됩니다. 광고가 로드될 때 광고의 메타데이터가 제공된다고 보장할 수 없으므로 광고의 메타데이터에 액세스하기 전에 이 콜백을 기다리는 것이 좋습니다.

다음은 광고 메타데이터를 가져오는 방법을 보여주는 코드 예입니다.

자바

RewardedAd.load(this, "/21775744923/example/rewarded", new AdManagerAdRequest.Builder().build(),
    new RewardedAdLoadCallback() {
      @Override
      public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
        mRewardedAd = rewardedAd;
        rewardedAd.setOnAdMetadataChangedListener(new OnAdMetadataChangedListener() {
          @Override
          public void onAdMetadataChanged() {
            Bundle metadata = rewardedAd.getAdMetadata();
            String adId = metadata.getString("AdId");
          }
        });
      }
    });

Kotlin

RewardedAd.load(this, "/21775744923/example/rewarded", AdManagerAdRequest.Builder().build(),
                    object : RewardedAdLoadCallback() {
      override fun onAdLoaded(rewardedAd: RewardedAd) {
        mRewardedAd = rewardedAd
        rewardedAd.onAdMetadataChangedListener = OnAdMetadataChangedListener {
          val metadata = rewardedAd.adMetadata
          val adId = metadata.getString("AdId")
        }
      }
    })

메타데이터를 가져온 후 관심 있는 키의 번들을 확인할 수 있습니다. 광고 유형에 따라 연결된 광고 메타데이터 키가 다를 수 있습니다. VAST 동영상 광고에는 다음 키가 있습니다.

Key 유형 설명
AdId 문자열 광고의 ID입니다. 사용할 수 없는 경우 비어 있습니다.
AdTitle 문자열 제목입니다. 지정하지 않은 경우 비어 있습니다.
CreativeDurationMs 정수 선택한 광고 소재의 길이(밀리초)입니다. 비선형인 경우 -1입니다.
TraffickingParameters 문자열 트래피킹 매개변수입니다. 사용할 수 없는 경우 비어 있습니다.
DealId 문자열 현재 광고의 래퍼 체인에 있는 첫 번째 거래 ID입니다(위에서부터 시작). 사용할 수 없는 경우 비어 있습니다.
AdSystem 문자열 광고의 소스 광고 서버입니다. 사용할 수 없는 경우 비어 있습니다.
CreativeId 문자열 광고에 대해 선택된 광고 소재의 ID입니다. 사용할 수 없는 경우 비어 있습니다.
MediaURL 문자열 선택한 미디어의 URL입니다.
Wrappers 배열 배열은 가장 안쪽 래퍼 광고(인라인 광고에 가까움)에서 시작하여 가장 바깥쪽 래퍼 광고로 이동하는 요소로 채워집니다. 배열의 각 요소는 다음 키와 값을 포함하는 사전입니다.
AdId
문자열. 래퍼 광고에 사용되는 광고 ID입니다. 사용할 수 없는 경우 비어 있습니다.
AdSystem
문자열. 래퍼 광고에 사용된 광고 시스템입니다. 사용할 수 없는 경우 비어 있습니다.
CreativeId
문자열. 래퍼 광고에 사용된 광고 소재 ID입니다. 사용할 수 없는 경우 비어 있습니다.