광고 메타데이터

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

기본 요건

• Google 모바일 광고 SDK 최소 버전 17.0.0
• 보상형 동영상의 단계를 완료합니다.

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

일부 앱에서 게재된 광고에 대해 자세히 알고 싶어 할 수 있습니다. AdMetadataListener를 구현하여 RewardedVideoAd.setAdMetadataListener()를 호출하여 보상형 동영상 광고의 광고 메타데이터 변경사항을 수신 대기할 수 있습니다. AdMetadataListener.onAdMetadataChanged()가 호출되면 광고 메타데이터에서 RewardedVideo.getAdMetadata()를 확인할 수 있습니다.

onAdMetadataChanged()는 광고가 로드된 직후 또는 로드된 후 메타데이터가 비동기식으로 변경될 때 호출됩니다. 광고가 로드될 때 광고의 메타데이터를 사용하지 못할 수도 있으므로 광고의 메타데이터에 액세스하기 전에 이 콜백을 기다리는 것이 좋습니다.

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

Java

RewardedAd.load(this, "/6499/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, "/6499/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로, 사용할 수 없는 경우 비어 있습니다.

참고: VAST 래퍼 광고에만 광고 메타데이터에 Wrappers 키가 있습니다. VAST 인라인 광고는 Wrappers 메타데이터를 포함하지 않습니다.