이 가이드는 Android용 Google 모바일 광고 SDK와 광고 메타데이터를 통합하려는 게시자를 대상으로 작성되었습니다.
기본 요건
광고 메타데이터 가져오기
게재된 광고에 대해 자세히 알아보려면 보상형 동영상 광고에서 광고 메타데이터 변경사항을 수신 대기하세요.
onAdMetadataChanged()는 광고가 로드된 직후 또는 로드된 후
메타데이터가 비동기식으로 변경될 때 호출됩니다. 광고가 로드될 때 광고의 메타데이터를 사용할 수 있다고 보장할 수는 없으므로 광고의 메타데이터에 액세스하기 전에 이 콜백을 기다리는 것이 좋습니다.
다음은 광고 메타데이터를 검색하는 방법을 보여주는 코드 예입니다.
Kotlin
RewardedAd.load(
AdRequest.Builder("AD_UNIT_ID").build(),
object : AdLoadCallback<RewardedAd> {
override fun onAdLoaded(ad: RewardedAd) {
...
ad.adEventCallback = object : RewardedAdEventCallback {
override fun onAdMetadataChanged() {
val metadata = ad.adMetadata
val adId = metadata.getString("AdId")
}
}
}
})
자바
RewardedAd.load(
new AdRequest.Builder("AD_UNIT_ID").build(),
new AdLoadCallback<RewardedAd>() {
@Override
public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
Rewarded.this.rewardedAd = rewardedAd;
...
rewardedAd.setAdEventCallback(new RewardedAdEventCallback() {
@Override
public void onAdMetadataChanged() {
Bundle metadata = rewardedAd.getAdMetadata();
String adId = metadata.getString("AdId");
}
});
};
};
);
AD_UNIT_ID 광고 단위를 바꿉니다. 예를 들어 보상형 광고의 경우
/21775744923/example/rewarded입니다.
메타데이터를 가져온 후 번들에서 관심 있는 키를 확인할 수 있습니다. 광고 유형에 따라 연결된 광고 메타데이터 키가 다를 수 있습니다. VAST 동영상 광고에는 다음과 같은 키가 있습니다.
Key |
유형 | 설명 |
|---|---|---|
AdId |
문자열 | 광고의 ID입니다. 사용할 수 없는 경우 비어 있습니다. |
AdTitle |
문자열 | 제목입니다. 지정하지 않은 경우 비어 있습니다. |
CreativeDurationMs |
정수 | 선택한 광고 소재의 길이(밀리초)입니다. 비선형인 경우 -1입니다. |
TraffickingParameters |
문자열 | 트래피킹 매개변수입니다. 사용할 수 없는 경우 비어 있습니다. |
DealId |
문자열 | 가장 바깥쪽 래퍼 광고부터 시작하여 현재 광고의 래퍼 체인에 있는 첫 번째 거래 ID입니다. 사용할 수 없는 경우 비어 있습니다. |
AdSystem |
문자열 | 광고의 소스 광고 서버입니다. 사용할 수 없는 경우 비어 있습니다. |
CreativeId |
문자열 | 광고에 대해 선택한 광고 소재의 ID입니다. 사용할 수 없는 경우 비어 있습니다. |
MediaURL |
문자열 | 선택한 미디어의 URL입니다. |
Wrappers |
배열 |
배열은 가장 안쪽 래퍼 광고
(인라인 광고에 가까움)부터 시작하여 가장 바깥쪽 래퍼 광고로 이동하는 요소로 채워집니다. 배열의 각
요소는 다음 키와
값을 포함하는 사전입니다.
|