광고 메타데이터

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

기본 요건

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

광고 메타데이터 가져오기

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

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입니다. 사용할 수 없는 경우 비어 있습니다.

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