이 가이드는 광고 메타데이터를 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 |
배열 |
배열은 가장 안쪽에 있는 래퍼 광고(인라인 광고에 가까운)에서 시작하여
가장 바깥쪽 래퍼 광고로 이동하는 요소로 채워집니다. 배열의 각 요소는 다음 키와 값을 포함하는 사전입니다.
|