광고 메타데이터

플랫폼 선택: Android iOS

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

기본 요건

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

앱에서 게재되는 광고에 대해 자세히 알 수 있도록 광고를 자체 GADAdMetadataDelegate로 설정하세요. 그런 다음 GADAdMetadataDelegate에서 adMetadataDidChange: 메서드를 구현하여 광고 메타데이터 변경사항을 수신 대기할 수 있습니다. 이 대리자가 호출되면 광고에서 adMetadata 속성을 확인합니다.

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

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

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [ request];
  [GADRewardedAd
       loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        self.rewardedAd.fullScreenContentDelegate = self;

        /// Set the ad to be the delegate of its ad metadata.
        self.rewardedAd.adMetadataDelegate = self;

        NSLog(@"Rewarded ad loaded.");
      }];
}

/#pragma mark GADAdMetadataDelegate implementation

- (void)adMetadataDidChange:(id<GADAdMetadataProvider>)ad {
  NSDictionary<NSString*, id> *adMetadata = _rewardedAd.adMetadata;
  NSString *adId = adMetadata[@"AdId"];
}

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

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