이 페이지는 Cloud Translation API를 통해 번역되었습니다.

미디에이션 수익 상승도 수익 통합

이 가이드에서는 Google 모바일 광고 SDK를 사용하여 광고를 로드하고 표시하는 방법을 설명합니다. Liftoff Monetize의 미디에이션, 입찰 및 폭포식 구조 통합을 모두 다룹니다. Liftoff를 추가하는 방법을 다룹니다. 광고 단위의 미디에이션 구성 및 Vungle SDK와 어댑터를 앱에 통합 Android

지원되는 통합 및 광고 형식

Liftoff Monetize용 미디에이션 어댑터에는 다음 기능이 있습니다.

통합
입찰	를 탭합니다. <ph type="x-smartling-placeholder"> </ph> ^1개
폭포
형식
앱 열기
배너	를 탭합니다. <ph type="x-smartling-placeholder">
전면 광고
리워드 제공됨
보상형 전면 광고	를 탭합니다. <ph type="x-smartling-placeholder"> ³
네이티브	를 탭합니다. <ph type="x-smartling-placeholder"> ²

¹ 입찰 통합 공개 베타 버전입니다.

² 입찰 이 형식에 대한 통합은 비공개 베타 버전입니다.

³ 보상형 광고 전면 광고를 설정하는 데 도움이 필요합니다. 계정에 연락하기 Liftoff Monetize 또는 monetize@liftoff.io에 문의해 주세요.

요구사항

Android API 수준 21 이상

최신 Google 모바일 광고 SDK
중재 완료 시작 가이드

1단계: Liftoff Monetize UI에서 구성 설정

2단계: UI에서 Liftoff Monetize 수요 Ad Manager 설정

GDPR 및 미국 주 규정 광고 파트너 목록에 Liftoff 추가

GDPR 설정 및 미국 주 규정 설정 Liftoff 를 Ad Manager UI의 GDPR 및 미국 주 규정 광고 파트너 목록에 추가합니다.

3단계: Vungle SDK 및 어댑터 가져오기

Android 스튜디오 통합 (권장)

앱 수준 build.gradle.kts 파일에 다음 구현을 추가합니다. 종속 항목 및 구성이 포함됩니다 최신 버전의 Vungle SDK 사용 어댑터:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:vungle:7.4.0.1")
}

수동 통합

최신 Vungle Android SDK 다운로드 그런 다음 libs 폴더 아래에서 .jar 파일의 압축을 풀고 살펴보겠습니다
Liftoff Monetize 어댑터 아티팩트로 이동합니다. 확인할 수 있습니다. 최신 버전 선택 및 Vungle 다운로드 어댑터의 .aar 파일을 가져와서 프로젝트에 추가합니다.

4단계: Liftoff Monetize SDK에서 개인 정보 보호 설정 구현

EU 동의 및 GDPR

Google EU 사용자 동의에 따름 정책에 따라 특정 정보 공개가 이루어지도록 해야 합니다. 다음과 관련하여 유럽 경제 지역 (EEA) 사용자의 동의를 얻은 기기 식별자 및 개인 정보의 사용 이 정책에는 EU 온라인 개인 정보 보호 지침 및 일반 데이터 보호 요구사항 규정 (GDPR). 동의를 받을 때 각 광고 네트워크를 명시해야 합니다. 개인 정보를 수집, 수신 또는 사용할 수 있는 미디에이션 체인에서 각 네트워크의 사용에 대한 정보를 제공합니다. Google에서는 현재 사용자의 동의 여부를 이러한 네트워크에 자동으로 전달합니다.

Liftoff Monetize에는 Vungle SDK에 동의를 전달할 수 있는 API가 포함되어 있습니다. 다음 샘플 코드는 이 동의 정보를 사용할 수 있습니다 이 메서드를 호출하도록 선택한 경우 Google 모바일 광고 SDK를 통해 광고를 요청하기 전에 해야 합니다.

자바

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

GDPR 권장 구현 안내를 참고하세요. 를 참조하세요.

미국 주 개인 정보 보호법

미국 주 개인 정보 보호법 사용자는 '할인' 기능을 '개인 정보' (법에서 'Do Not Sell My Personal(내 개인 판매 거부)' 문구 Information' '판매' 링크를 클릭하면 확인할 수 있습니다. 이 미국 주 개인 정보 보호 법규 준수 가이드를 통해 제한적인 데이터 처리 각 광고에 이 설정을 적용할 수는 없습니다. 네트워크를 설정할 수 있습니다 따라서 각 광고 네트워크를 개인 정보 보호 판매에 참여할 수 있는 미디에이션 체인에 해당 네트워크의 가이드라인을 준수하여 있습니다

자바

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setCCPAStatus(true)

CCPA 구현을 참고하세요. 를 참조하세요.

5단계: 필수 코드 추가하기

Liftoff Monetize 통합에는 추가 코드가 필요하지 않습니다.

6단계: 구현 테스트

테스트 광고 사용 설정

Ad Manager 용 테스트 기기를 등록하고 Liftoff Monetize UI에서 테스트 모드를 사용 설정해야 합니다.

테스트 광고 확인

Liftoff Monetize에서 테스트 광고를 수신하고 있는지 확인하려면 광고 검사기에서 Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) 광고 소스를 사용하여 단일 광고 소스 테스트를 사용 설정하세요.

선택 단계

네트워크별 매개변수

Liftoff Monetize 어댑터는 다음 추가 요청을 지원합니다. 이 매개변수는 어댑터에 전달할 수 있습니다.

userId: Liftoff Monetize의 인센티브를 받은 사용자 ID를 나타내는 문자열입니다.
adOrientation: 전체 화면 광고의 표시 방향을 지정하는 정수입니다.

다음은 이러한 매개변수를 설정하는 광고 요청을 생성하는 방법을 보여주는 코드 예입니다.

자바

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build();

Kotlin

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build()

네이티브 광고 렌더링

Liftoff Monetize 어댑터는 네이티브 광고를 NativeAd <ph type="x-smartling-placeholder"> 객체입니다. 이는 다음을 채웁니다. 필드 NativeAd를 탭합니다.

필드	Liftoff Monetize 어댑터에 의해 항상 애셋이 포함됨
광고 제목
이미지	1
미디어 뷰
본문
앱 아이콘
클릭 유도 문구
별표 평점
스토어
가격

¹ Liftoff Monetize 어댑터가 네이티브의 기본 이미지 애셋에 대한 직접 액세스를 제공하지 않음 있습니다. 대신 어댑터는 MediaView 동영상 또는 이미지로 검색할 수 있습니다

오류 코드

어댑터가 Liftoff Monetize에서 광고를 수신하지 못하는 경우 게시자는 이 API를 사용하여 광고 응답에서 ResponseInfo.getAdapterResponses() 다음 클래스에 포함됩니다.

형식	클래스 이름
앱 오프닝 광고 (입찰)	com.google.ads.mediation.vungle.VungleMediationAdapter
앱 오프닝 광고 (폭포식 구조)	com.google.ads.mediation.vungle.VungleMediationAdapter
배너 (입찰)	com.google.ads.mediation.vungle.VungleMediationAdapter
배너 (폭포식)	com.vungle.mediation.VungleInterstitialAdapter
전면 광고 (입찰)	com.google.ads.mediation.vungle.VungleMediationAdapter
전면 광고 (폭포식 구조)	com.vungle.mediation.VungleInterstitialAdapter
보상형 (입찰)	com.google.ads.mediation.vungle.VungleMediationAdapter
보상형 광고 (폭포식 구조)	com.vungle.mediation.VungleAdapter
보상형 전면 광고 (입찰)	com.google.ads.mediation.vungle.VungleMediationAdapter
보상형 전면 광고 (폭포식 구조)	com.google.ads.mediation.vungle.VungleMediationAdapter
네이티브 (입찰)	com.google.ads.mediation.vungle.VungleMediationAdapter
네이티브 (폭포)	com.google.ads.mediation.vungle.VungleMediationAdapter

다음은 Liftoff Monetize가 생성한 코드와 관련 메시지입니다. 어댑터는 다음과 같이 처리합니다.

오류 코드	도메인	이유
101	com.google.ads.mediation.vungle	서버 매개변수가 잘못되었습니다 (예: 앱 ID 또는 게재위치 ID).
102	com.google.ads.mediation.vungle	요청한 배너 크기가 유효한 Liftoff Monetize 광고에 매핑되지 않습니다. 있습니다.
103	com.google.ads.mediation.vungle	Liftoff Monetize는 `Activity`컨텍스트를 요청해야 합니다. 있습니다.
104	com.google.ads.mediation.vungle	Vungle SDK는 동일한 게재위치에 대해 여러 광고를 로드할 수 없습니다. 있습니다.
105	com.google.ads.mediation.vungle	Vungle SDK 초기화에 실패했습니다.
106	com.google.ads.mediation.vungle	Vungle SDK에서 성공적인 로드 콜백을 반환했지만 Banners.getBanner()를 또는 Vungle.getNativeAd()에서 null을 반환했습니다.
107	com.google.ads.mediation.vungle	Vungle SDK는 광고를 재생할 준비가 되지 않았습니다.
108	com.google.ads.mediation.vungle	Vungle SDK에서 잘못된 입찰 토큰을 반환했습니다.

Vungle SDK에서 발생하는 오류는 오류 코드: iOS 및 Android용 Vungle SDK를 참조하세요.

Liftoff Monetize Android 미디에이션 어댑터 변경 로그

버전 7.4.0.1

입찰 및 폭포식 구조 배너 광고를 위한 맞춤 광고 크기 지원이 추가되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 23.2.0.
Vungle SDK 버전 7.4.0.

버전 7.4.0.0

VungleMediationAdapter에서 VungleInterstitialAdapter 클래스를 확장했습니다. Google Ad Manager의 앱 오프닝 광고 형식에 폭포식 구조 지원을 추가합니다.
Vungle SDK 7.4.0과의 호환성 확인

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 23.2.0.
Vungle SDK 버전 7.4.0.

버전 7.3.2.0

Vungle SDK 7.3.2와의 호환성 확인

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 23.0.0.
Vungle SDK 버전 7.3.2.

버전 7.3.1.0

Vungle SDK 7.3.1과의 호환성 확인

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 23.0.0.
Vungle SDK 버전 7.3.1.

버전 7.3.0.0

필요한 최소 Google 모바일 광고 SDK 버전이 23.0.0으로 업데이트되었습니다.
Vungle SDK 7.3.0과의 호환성 확인
앱 오프닝 광고 형식에 폭포식 구조 및 입찰 지원이 추가되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 23.0.0.
Vungle SDK 버전 7.3.0.

버전 7.1.0.0

Vungle SDK 7.1.0과의 호환성 확인

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 22.3.0.
Vungle SDK 버전 7.1.0.

버전 7.0.0.1

Google 모바일 광고 SDK가 입찰 네이티브 광고의 노출수를 기록하지 않는 문제가 해결되었습니다.
어댑터가 Google 모바일 광고 SDK 버전 22.3.0에 종속되도록 되돌렸습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 22.3.0.
Vungle SDK 버전 7.0.0.

버전 7.0.0.0

모든 폭포식 구조 광고 형식에 대해 동일한 게재위치 ID로 여러 광고를 로드하는 지원이 추가되었습니다.
어댑터 이름을 Vungle에서 Liftoff Monetize로 리브랜딩했습니다.
Vungle SDK 7.0.0과의 호환성 확인

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 22.4.0
Vungle SDK 버전 7.0.0.

버전 6.12.1.1

새 VersionInfo 클래스를 사용하도록 어댑터를 업데이트했습니다.
필요한 최소 Google 모바일 광고 SDK 버전이 22.0.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 22.0.0.
Vungle SDK 버전 6.12.1.

버전 6.12.1.0

Vungle SDK 6.12.1과의 호환성 확인

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 21.4.0.
Vungle SDK 버전 6.12.1.

버전 6.12.0.1

배너 광고 형식에 대한 입찰 지원이 추가되었습니다.
Vungle SDK 6.12.0과의 호환성 확인
필요한 최소 Google 모바일 광고 SDK 버전이 21.4.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 21.4.0.
Vungle SDK 버전 6.12.0.

버전 6.12.0.0

보상형 전면 광고 형식에 대한 폭포식 구조 미디에이션 및 입찰 지원이 추가되었습니다.
네이티브 광고 형식에 대한 입찰 지원이 추가되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 21.1.0.
Vungle SDK 버전 6.12.0.

버전 6.11.0.3

네이티브 광고 형식에 대한 폭포식 구조 미디에이션 지원이 추가되었습니다.
필요한 최소 Google 모바일 광고 SDK 버전이 21.1.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 21.1.0.
Vungle SDK 버전 6.11.0.

버전 6.11.0.2

보상형 입찰 광고에서 동일한 게재위치 ID에 대해 여러 광고를 로드하는 기능이 추가되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 21.0.0.
Vungle SDK 버전 6.11.0.

버전 6.11.0.1

compileSdkVersion 및 targetSdkVersion를 API 31로 업데이트했습니다.
필요한 최소 Google 모바일 광고 SDK 버전이 21.0.0으로 업데이트되었습니다.
필요한 최소 Android API 수준을 19로 업데이트했습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 21.0.0.
Vungle SDK 버전 6.11.0.

버전 6.11.0.0

Vungle SDK 6.11.0과의 호환성 확인

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 20.6.0.
Vungle SDK 버전 6.11.0.

버전 6.10.5.0

Vungle SDK 6.10.5와의 호환성 확인
필요한 최소 Google 모바일 광고 SDK 버전이 20.6.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 20.6.0.
Vungle SDK 버전 6.10.5.

버전 6.10.4.0

Vungle SDK 6.10.4와의 호환성 확인

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 20.5.0.
Vungle SDK 버전 6.10.4.

버전 6.10.3.0

Vungle SDK 6.10.3과의 호환성 확인

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 20.5.0.
Vungle SDK 버전 6.10.3.

버전 6.10.2.1

Vungle SDK 6.10.2와의 호환성 확인
전면 광고 및 보상형 광고 형식에 대한 입찰 지원이 추가되었습니다.
필요한 최소 Google 모바일 광고 SDK 버전이 20.5.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 20.5.0.
Vungle SDK 버전 6.10.2.

버전 6.10.2.0

Vungle SDK 6.10.2와의 호환성 확인
배너 및 전면 광고를 요청할 때 Vungle 네트워크별 매개변수를 가져오기 위해 매개변수 serverParameters를 mediationExtras로 대체하여 어댑터 문제를 해결했습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 20.3.0.
Vungle SDK 버전 6.10.2.

버전 6.10.1.0

Vungle SDK 6.10.1과의 호환성 확인
필요한 최소 Google 모바일 광고 SDK 버전이 20.3.0으로 업데이트되었습니다.
이제 MREC 광고가 Vungle의 배너 API에서 지원됩니다.
표준화된 오류 코드 및 메시지가 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 20.3.0.
Vungle SDK 버전 6.10.1.

버전 6.9.1.1

필요한 최소 Google 모바일 광고 SDK 버전이 20.0.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 20.0.0.
Vungle SDK 버전 6.9.1.

버전 6.9.1.0

Vungle SDK 6.9.1과의 호환성 확인
OMSDK 지원이 추가되었습니다.
다양한 버그 수정
Vungle onAdViewed 콜백의 보상형 광고 지원
필요한 최소 Google 모바일 광고 SDK 버전이 19.7.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 19.7.0.
Vungle SDK 버전 6.9.1.

버전 6.8.1.1

필요한 최소 Google 모바일 광고 SDK 버전이 19.6.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 19.6.0.
Vungle SDK 버전 6.8.1.

버전 6.8.1.0

Vungle SDK 6.8.1과의 호환성 확인
필요한 최소 Google 모바일 광고 SDK 버전이 19.5.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 19.5.0.
Vungle SDK 버전 6.8.1.

버전 6.8.0.0

Vungle SDK 6.8.0과의 호환성 확인
배너 광고가 새로고침되거나 폐기될 때 onAdClosed()를 전달하지 않도록 어댑터가 업데이트되었습니다.
FlexFeed 및 FlexView를 삭제합니다 (Vungle 6.8.0에서 지원 중단됨).
필요한 최소 Google 모바일 광고 SDK 버전이 19.4.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 19.4.0.
Vungle SDK 버전 6.8.0.

버전 6.7.1.0

Vungle SDK 6.7.1과의 호환성 확인
광고가 애플리케이션 컨텍스트를 사용하여 로드되는 경우 광고가 로드되지 않는 버그가 수정되었습니다.
targetSdkVersion을 API 29로 업데이트했습니다.
필요한 최소 Google 모바일 광고 SDK 버전이 19.3.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 19.3.0.
Vungle SDK 버전 6.7.1.

버전 6.7.0.0

Vungle SDK 6.7.0과의 호환성 확인
인라인 적응형 배너 요청을 지원하도록 어댑터가 업데이트되었습니다.
이제 전면 광고 및 보상형 광고의 음소거가 기본적으로 해제됩니다.
이제 전면 광고를 클릭하면 onAdLeftApplication() 콜백을 전달합니다.
필요한 최소 Google 모바일 광고 SDK 버전이 19.2.0으로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 19.2.0.
Vungle SDK 버전 6.7.0.

버전 6.5.3.0

Vungle SDK 6.5.3과의 호환성 확인
새로 도입된 Vungle 배너 형식 지원 추가
필요한 최소 Google 모바일 광고 SDK 버전이 19.0.1로 업데이트되었습니다.

빌드 및 테스트 대상:

Google 모바일 광고 SDK 버전 19.0.1.
Vungle SDK 버전 6.5.3.

버전 6.4.11.1

배너 광고가 새로고침되지 않던 문제가 해결되었습니다.

버전 6.4.11.0

Vungle SDK 6.4.11과의 호환성 확인
배너 광고에 대한 지원이 추가되었습니다.
어댑터를 AndroidX로 이전했습니다.
필요한 최소 Google 모바일 광고 SDK 버전이 18.2.0으로 업데이트되었습니다.

버전 6.3.24.1

새로운 오픈 베타 Rewarded API를 지원하도록 어댑터를 업데이트했습니다.
필요한 최소 Google 모바일 광고 SDK 버전이 17.2.0으로 업데이트되었습니다.

버전 6.3.24.0

Vungle SDK 6.3.24와의 호환성 확인

버전 6.3.17.0

Vungle SDK 6.3.17과의 호환성 확인

버전 6.3.12.0

Vungle SDK 6.3.12와의 호환성 확인

버전 6.2.5.1

onRewardedVideoComplete() 광고 이벤트를 호출하도록 어댑터를 업데이트했습니다.

버전 6.2.5.0

Vungle SDK 6.2.5와의 호환성 확인

버전 5.3.2.1

Google 모바일 광고 SDK에 클릭수를 올바르게 보고하도록 어댑터가 업데이트되었습니다.

버전 5.3.2.0

Vungle SDK 5.3.2와의 호환성 확인
Android 스튜디오 3.0용 Adpater 프로젝트가 업데이트되었습니다.
Bundle 빌더 클래스에 다음 메서드를 추가했습니다.
- setOrdinalViewCount : 이 필드는 미디에이션 서수인 게시자가 Vungle에서 서수 데이터 보고서를 수신할 때마다
- setFlexViewCloseTimeInSec : 이 옵션은 가변형 뷰 광고를 만드는 데 사용됩니다. 지정된 시간(초)이 지나면 자동으로 닫힙니다.

버전 5.3.0.0

Vungle SDK 5.3.0과의 호환성 확인

버전 5.1.0.0

Vungle SDK 5.1.0과 호환되도록 어댑터가 업데이트되었습니다.
버전 이름 지정 시스템이 다음으로 변경됨 [Vungle SDK 버전].[어댑터 패치 버전]

이전 버전

전면 광고 및 보상형 동영상 광고 형식에 대한 지원이 추가되었습니다.