미디에이션과 Unity 애즈 통합

이 가이드는 미디에이션을 통해 Unity 모바일에서 광고를 로드하고 표시하는 데 Google 모바일 광고 SDK를 사용하려는 게시자를 대상으로 합니다. 광고 단위의 미디에이션 구성에 Unity 광고를 추가하는 방법, 광고 소스 최적화, 설정 방법, Unity Ads SDK와 어댑터를iOS 앱에 통합하는 방법을 설명합니다.

지원되는 통합 및 광고 형식

Unity 광고용 AdMob 미디에이션 어댑터에는 다음과 같은 기능이 있습니다.

통합
입찰
폭포
형식
배너
전면 광고
리워드 제공됨
네이티브

요구사항

  • iOS 배포 대상 10.0 이상
  • 최신 Google 모바일 광고 SDK

1단계: Unity 광고 설정

Unity Ads에 가입 또는 로그인합니다.

Unity Ads 대시보드에서 프로젝트 탭으로 이동하여 새 프로젝트 버튼을 클릭합니다.

양식을 작성하고 페이지 하단의 프로젝트 추가를 클릭하여 Unity 대시보드에 프로젝트를 추가합니다.

프로젝트가 생성되면 프로젝트의 수익 창출 > 게재위치 탭으로 이동하여 게임 ID를 기록해 둡니다.

새 게재위치를 만들려면 게재위치 추가 버튼을 클릭합니다.

광고 게재위치 만들기에 대한 추가 안내를 보려면 원하는 광고 형식에 해당하는 탭을 선택하세요.

원하는 게재위치 ID를 입력하고 광고 형식으로 배너를 선택한 후 게재위치 만들기를 클릭합니다.

전면 광고

원하는 게재위치 ID를 입력하고 광고 형식으로 전면 동영상을 선택한 후 게재위치 만들기를 클릭합니다.

리워드 제공됨

원하는 게재위치 ID를 입력하고 광고 형식으로 보상형 동영상을 선택한 후 게재위치 만들기를 클릭합니다.

광고 ID게재위치 ID 외에도 AdMob 광고 단위 ID를 설정하려면 Unity Ads API 키조직 핵심 ID가 필요합니다.

Unity Ads 대시보드Ads Data Export > API Access 탭으로 이동하여 monetization Stats API Access Key를 기록해 둡니다.

그런 다음 Unity Ads 대시보드설정 탭으로 이동하여 조직 핵심 ID를 기록해 둡니다.

2단계: 광고 단위에 대한 AdMob 미디에이션 설정 구성

광고 단위의 미디에이션 구성에 Unity 광고를 추가해야 합니다. 먼저 AdMob 계정에 로그인합니다.

다음으로 미디에이션 탭으로 이동합니다. 수정할 기존 미디에이션 그룹이 있는 경우 해당 미디에이션 그룹의 이름을 클릭하여 수정한 후 Unity 광고를 광고 소스로 추가로 건너뛰세요.

새 미디에이션 그룹을 만들려면 미디에이션 그룹 만들기를 선택합니다.

AdMob 베타 미디에이션 탭

광고 형식과 플랫폼을 입력한 다음 계속을 클릭합니다.

미디에이션 그룹의 이름을 지정하고 타겟팅할 위치를 선택합니다. 다음으로 미디에이션 그룹 상태를 사용으로 설정합니다. 그런 다음 광고 단위 추가를 클릭하면 광고 단위 선택 오버레이가 열립니다.

새 미디에이션 그룹 2

이 미디에이션 그룹을 기존 AdMob 광고 단위와 연결합니다. 그런 다음 완료를 클릭합니다.

이제 선택한 광고 단위로 채워진 광고 단위 카드가 표시됩니다.

미디에이션 그룹 광고 단위

광고 소스로 Unity 광고 추가

광고 소스 카드에서 광고 네트워크 추가를 선택합니다. 그런 다음 Unity Ads를 선택합니다.

최적화 도구 스위치를 사용 설정합니다. 이전 섹션에서 가져온 API 키조직 핵심 ID를 입력하여 Unity 광고에 대한 광고 소스 최적화를 설정합니다. 그런 다음 Unity Ads의 eCPM 값을 입력하고 계속을 클릭합니다.

그런 다음 이전 섹션에서 가져온 게임 ID게재위치 ID를 입력합니다. 그런 다음 완료를 클릭합니다.

마지막으로 저장을 클릭합니다.

보상형 광고 사용하기

보상형 광고 단위의 설정에서 리워드 금액 및 리워드 유형 값을 제공합니다. 그런 다음 게재되는 광고 네트워크에 관계없이 사용자에게 동일한 보상을 제공하려면 미디에이션 그룹의 모든 네트워크에 적용 체크박스를 선택합니다.

이 설정을 적용하지 않으면 Unity 어댑터가 기본적으로 "" 유형의 리워드(빈 문자열) 값을 1로 합니다. Unity Ads SDK에서는 보상형 광고에 구체적인 리워드 값을 제공하지 않습니다.

AdMob 광고 단위의 리워드 값 설정에 대한 자세한 내용은 광고 단위 만들기를 참조하세요.

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

  • 프로젝트의 Podfile에 다음 줄을 추가합니다.

    pod 'GoogleMobileAdsMediationUnity'
    
  • 명령줄에서 다음을 실행합니다.

    pod install --repo-update

수동 통합

  • 최신 버전의 Unity Ads SDK를 다운로드하고 프로젝트에 UnityAds.framework를 연결합니다.

  • 변경 로그의 다운로드 링크에서 최신 버전의 Unity Ads 어댑터를 다운로드하고 프로젝트의 UnityAdapter.framework 링크를 연결합니다.

4단계: 추가 코드 필요

Unity 광고 통합에는 추가 코드가 필요하지 않습니다.

5단계: 구현 테스트하기

테스트 광고는 두 가지 방법으로 Unity Ads 대시보드에서 사용 설정할 수 있습니다.

모든 기기에서 테스트 광고를 사용 설정하려면 프로젝트의 설정 > 프로젝트 설정 탭으로 이동합니다. 테스트 모드 섹션에서 클라이언트 테스트 모드가 재정의되지 않음 섹션을 수정하고 클라이언트 테스트 모드 재정의 체크박스를 선택하고 테스트 모드 강제 사용을 선택한 후 저장을 클릭합니다.

특정 기기에서만 테스트 광고를 사용 설정하려면 광고 데이터 내보내기 > 테스트 기기 탭으로 이동하세요. 테스트 기기 섹션에서 새 기기 추가 버튼을 클릭하고 결과 양식을 작성합니다.

선택 단계

Google EU 사용자 동의 정책에 따라 기기 식별자 및 개인 정보 사용과 관련하여 유럽 경제 지역 (EEA)의 사용자에게 특정 공개 정보를 제공하고 동의를 얻어야 합니다. 이 정책에는 EU 온라인 개인 정보 보호 지침 및 개인 정보 보호법 (GDPR)의 요구사항이 반영되어 있습니다. 동의를 구할 때는 미디에이션 체인에서 개인 정보를 수집, 수신 또는 사용할 수 있는 각 광고 네트워크를 식별하고 각 네트워크의 사용에 관한 정보를 제공해야 합니다. Google은 현재 사용자의 동의 선택을 이러한 네트워크에 자동으로 전달할 수 없습니다.

SDK 버전 2.0.0에서는 Unity Ads에서 개인 정보 보호 설정을 지원하는 API를 추가했습니다. 다음 샘플 코드는 이 동의 정보를 Unity Ads SDK에 전달하는 방법을 보여줍니다. 동의 정보를 Unity Ads SDK에 수동으로 전달하려는 경우 Google 모바일 광고 SDK를 통해 광고를 요청하기 전에 이 코드를 호출하는 것이 좋습니다.

Swift

import UnityAds
// ...

let gdprMetaData = UADSMetaData()
gdprMetaData.set("gdpr.consent", value: true)
gdprMetaData.commit()

Objective-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *gdprMetaData = [[UADSMetaData alloc] init];
[gdprMetaData set:@"gdpr.consent" value:@YES];
[gdprMetaData commit];

Unity Ads의 개인 정보 보호 동의 및 데이터 APIGDPR 준수 가이드에서 자세한 내용과 각 메서드에 제공할 수 있는 값을 확인하세요.

GDPR 광고 파트너 목록에 Unity 광고 추가

GDPR 설정 의 단계에 따라 Unity 광고를AdMob UI의 GDPR 광고 파트너 목록에 추가합니다.

CCPA

캘리포니아 소비자 개인 정보 보호법 (CCPA) 은 캘리포니아 주민들에게 (법에서 정의한 바에 따라) 자신의 '개인 정보'에 대한 선택 해제 권한을 제공할 수 있어야 합니다. CCPA 준비 가이드에서는 Google 광고 게재에 제한적인 데이터 처리를 사용 설정할 수 있지만 Google은 미디에이션 체인의 각 광고 네트워크에 이 설정을 적용할 수 없습니다. 따라서 미디에이션 체인에서 개인 정보 판매에 참여할 수 있는 각 광고 네트워크를 식별하고 각 네트워크의 안내를 따라 CCPA를 준수해야 합니다.

SDK 버전 2.0.0에서는 Unity Ads에서 개인 정보 보호 설정을 지원하는 API를 추가했습니다. 다음 샘플 코드는 이 동의 정보를 Unity Ads SDK에 전달하는 방법을 보여줍니다. 동의 정보를 Unity Ads SDK에 수동으로 전달하려는 경우 Google 모바일 광고 SDK를 통해 광고를 요청하기 전에 이 코드를 호출하는 것이 좋습니다.

Swift

import UnityAds
// ...

let ccpaMetaData = UADSMetaData()
ccpaMetaData.set("privacy.consent", value: true)
ccpaMetaData.commit()

Objective-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *ccpaMetaData = [[UADSMetaData alloc] init];
[ccpaMetaData set:@"privacy.consent" value:@YES];
[ccpaMetaData commit];

Unity Ads의 개인 정보 보호 동의 및 데이터 APICCPA 준수 가이드에서 자세한 내용과 각 메서드에 제공할 수 있는 값을 참고하세요.

오류 코드

어댑터가 Unity Ads에서 광고를 수신하지 못한 경우 게시자는 다음 클래스의 GADResponseInfo.adNetworkInfoArray를 사용합니다.

GADMAdapterUnity
GADMediationAdapterUnity

다음은 광고 로드에 실패할 때 UnityAds 어댑터에서 발생하는 코드 및 관련 메시지입니다.

오류 코드 이유
0-10 UnityAds SDK에서 오류를 반환했습니다. 자세한 내용은 코드를 참고하세요.
101 UI에 구성된 UnityAds 서버 매개변수가 AdMob 누락되었거나 잘못되었습니다.
102 UnityAds에서 NO_FILL 상태의 게재위치가 반환되었습니다.
103 UnityAds에서 DISABLED 상태인 게재위치를 반환했습니다.
104 UnityAds에서 null 컨텍스트가 포함된 광고를 표시하려고 했습니다.
105 Unity 광고에서 광고를 초기화, 로드 및/또는 표시하는 데 사용되는 컨텍스트는 활동 인스턴스가 아닙니다.
106 UnityAds에서 게재할 준비가 되지 않은 광고를 게재하려고 했습니다.
107 UnityUnity는 기기에서 지원되지 않습니다.
108 UnityAds는 게재위치당 한 번에 하나의 광고만 로드할 수 있습니다.
109 UnityAds가 오류 상태로 완료되었습니다.
200-204 UnityAds 배너 관련 오류입니다. 자세한 내용은 코드를 참고하세요.
0-9 UnityAds SDK에서 오류를 반환했습니다. 자세한 내용은 Unity 문서를 참조하세요.
101 UI에 구성된 UnityAds 서버 매개변수가 AdMob 누락되었거나 잘못되었습니다.
102 UnityAds에서 지원하지 않는 기기입니다.
103 UnityAds에서 오류 상태 kUnityAdsFinishStateError로 표시를 완료했습니다.
104 Unity 광고 객체는 초기화 프로그램을 호출한 후 nil이 됩니다.
105 광고가 준비되지 않아 Unity 광고를 표시할 수 없습니다.
106 UnityAds에서 게재위치가 변경된 콜백(게재위치 상태 kUnityAdsPlacementStateNoFill)
107 UnityAds에서 게재위치 상태가 kUnityAdsPlacementStateDisabled인 콜백으로 게재위치를 변경했습니다.
108 이 게재위치에 대한 광고가 이미 로드되었습니다. UnityAds SDK는 동일한 게재위치에 대해 여러 광고 로드를 지원하지 않습니다.

Unity 광고 iOS 미디에이션 어댑터 변경 로그

버전 4.3.0.0

  • Unity Ads SDK 4.3.0과의 호환성을 확인했습니다.

빌드 및 테스트 방법:

  • Google 모바일 광고 SDK 버전 9.8.0
  • Unity Ads SDK 버전 4.3.0

버전 4.2.1.0

  • Unity Ads SDK 4.2.1과의 호환성이 확인되었습니다.

빌드 및 테스트 방법:

  • Google 모바일 광고 SDK 버전 9.4.0
  • Unity Ads SDK 버전 4.2.1

버전 4.1.0.0

  • Unity Ads SDK 4.1.0과의 호환성이 확인되었습니다.

빌드 및 테스트 방법:

  • Google 모바일 광고 SDK 버전 9.2.0
  • Unity Ads SDK 버전 4.1.0

버전 4.0.1.0

  • Unity Ads SDK 4.0.1과의 호환성이 확인되었습니다.

빌드 및 테스트 방법:

  • Google 모바일 광고 SDK 버전 9.0.0
  • Unity Ads SDK 버전 4.0.1

버전 4.0.0.2

  • arm64 시뮬레이터 아키텍처에 대한 지원이 추가되었습니다.

빌드 및 테스트 방법:

  • Google 모바일 광고 SDK 버전 9.0.0
  • Unity Ads SDK 버전 4.0.0

버전 4.0.0.1

  • Google 모바일 광고 SDK 버전 9.0.0과의 호환성을 확인했습니다.
  • 이제 Google 모바일 광고 SDK 버전 9.0.0 이상이 필요합니다.

빌드 및 테스트 방법:

  • Google 모바일 광고 SDK 버전 9.0.0
  • Unity Ads SDK 버전 4.0.0

버전 4.0.0.0

  • Unity Ads SDK 4.0.0과의 호환성이 확인되었습니다.
  • 이제 최소 iOS 버전 10.0이 필요합니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 8.13.0
  • Unity Ads SDK 버전 4.0.0

버전 3.7.5.0

  • Unity Ads SDK 3.7.5와의 호환성이 확인되었습니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 8.8.0
  • Unity Ads SDK 버전 3.7.5

버전 3.7.4.0

  • Unity Ads SDK 3.7.4와의 호환성이 확인되었습니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 8.7.0
  • Unity Ads SDK 버전 3.7.4

버전 3.7.2.0

  • Unity Ads SDK 3.7.2와의 호환성이 확인되었습니다.
  • Google 모바일 광고 SDK 버전 8.0.0 이상에 대한 종속 항목이 완화되었습니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 8.5.0
  • Unity Ads SDK 버전 3.7.2

버전 3.7.1.0

  • Unity Ads SDK 3.7.1과의 호환성을 확인했습니다.
  • 이제 Google 모바일 광고 SDK 버전 8.4.0 이상이 필요합니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 8.4.0
  • Unity Ads SDK 버전 3.7.1

버전 3.6.2.0

  • .xcframework 형식을 사용하도록 어댑터를 업데이트했습니다.
  • Unity Ads SDK 3.6.2와의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 8.2.0 이상이 필요합니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 8.2.0
  • Unity Ads SDK 버전 3.6.2

버전 3.6.0.0

  • Unity Ads SDK 3.6.0과의 호환성을 확인했습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.69.0 이상이 필요합니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 7.69.0
  • Unity Ads SDK 버전 3.6.0

버전 3.5.1.1

  • Unity Ads SDK가 초기화를 완료할 때 가끔 발생하는 비정상 종료 문제가 해결되었습니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 7.68.0
  • Unity Ads SDK 버전 3.5.1

버전 3.5.1.0

  • Unity Ads SDK 3.5.1과의 호환성을 확인했습니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 7.68.0
  • Unity Ads SDK 버전 3.5.1

버전 3.5.0.0

  • Unity Ads SDK 3.5.0과의 호환성을 확인했습니다.
  • 적응형 배너 광고 지원이 추가되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.68.0 이상이 필요합니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 7.68.0
  • Unity Ads SDK 버전 3.5.0

버전 3.4.8.0

  • Unity Ads SDK 3.4.8과의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.63.0 이상이 필요합니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 7.63.0
  • Unity Ads SDK 버전 3.4.8

버전 3.4.6.0

  • Unity Ads SDK 3.4.6과의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.60.0 이상이 필요합니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 7.60.0
  • Unity Ads SDK 버전 3.4.6

버전 3.4.2.2

  • 표준화된 어댑터 오류 코드와 메시지가 추가되었습니다.
  • 필요한 최소 Google 모바일 광고 SDK 버전이 7.59.0으로 업데이트되었습니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 7.59.0
  • Unity Ads SDK 버전 3.4.2

버전 3.4.2.1

  • 초기화 및 광고 로드 실패를 조기에 인식하고 시간 초과를 줄이기 위해 Unity 오류 전달을 개선했습니다.
  • i386 아키텍처에 대한 지원이 삭제되었습니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 7.57.0
  • Unity Ads SDK 버전 3.4.2

버전 3.4.2.0

  • Unity Ads SDK 3.4.2와의 호환성이 확인되었습니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 7.55.1
  • Unity Ads SDK 버전 3.4.2

버전 3.4.0.0

  • Unity Ads SDK 3.4.0과의 호환성을 확인했습니다.
  • 이제 여러 배너 광고를 한 번에 로드할 수 있습니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 7.53.0
  • Unity Ads SDK 버전 3.4.0

버전 3.3.0.0

  • Unity Ads SDK 3.3.0과의 호환성을 확인했습니다.
  • 이제 여러 배너 광고를 한 번에 로드할 수 있습니다.

빌드 및 테스트 방법

  • Google 모바일 광고 SDK 버전 7.51.0
  • Unity Ads SDK 버전 3.3.0

버전 3.2.0.1

  • Unity Ads SDK 3.2.0과의 호환성을 확인했습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.46.0 이상이 필요합니다.
  • 로드할 때 Unity 배너 광고가 표시되지 않는 문제가 해결되었습니다.
  • 어댑터가 unityAdsReady 콜백을 올바르게 전달하지 못하는 문제가 수정되었습니다.

버전 3.2.0.0

  • 미게재 보고에 대한 회귀로 인해 버전이 삭제되었습니다.

버전 3.1.0.0

  • Unity Ads SDK 3.1.0과의 호환성이 확인되었습니다.

버전 3.0.3.0

  • Unity Ads SDK 3.0.3과의 호환성을 확인했습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.42.2 이상이 필요합니다.
  • 유연한 배너 광고 크기에 대한 지원이 추가되었습니다.
  • Unity 배너 광고가 세션당 한 번만 로드되는 문제가 해결되었습니다.

버전 3.0.1.0

  • Unity Ads SDK 3.0.1과의 호환성이 확인되었습니다.
  • 보상형 광고를 할당 해제할 때 발생하는 비정상 종료 문제가 해결되었습니다.

버전 3.0.0.3

  • 새 보상형 API를 사용하도록 어댑터를 업데이트합니다.
  • 이제 Google 모바일 광고 SDK 버전 7.41.0 이상이 필요합니다.

버전 3.0.0.2

  • 배너 광고에 대한 지원이 추가되었습니다.

버전 3.0.0.1

  • 어댑터가 이전 요청의 'placementId'를 저장하는 문제를 수정했습니다.

버전 3.0.0.0

  • Unity Ads SDK 3.0.0과의 호환성을 확인했습니다.

버전 2.3.0.0

  • Unity Ads SDK 2.3.0과의 호환성을 확인했습니다.

버전 2.2.1.1

  • 어댑터에 adapterDidCompletePlayingRewardBasedVideoAd: 콜백을 추가했습니다.

버전 2.2.1.0

  • Unity Ads SDK 2.2.1과의 호환성을 확인했습니다.

버전 2.2.0.0

  • Unity Ads SDK 2.2.0과의 호환성을 확인했습니다.

버전 2.1.2.0

  • Unity Ads SDK 2.1.2와의 호환성을 확인했습니다.
  • armv7s 아키텍처에 대한 지원이 삭제되었습니다.

버전 2.1.1.0

  • Unity Ads SDK 2.1.1과의 호환성이 확인되었습니다.

버전 2.1.0.0

  • Unity Ads SDK 2.1.0과 호환되도록 어댑터를 업데이트했습니다.

버전 2.0.8.0

  • Unity Ads SDK 2.0.8과의 호환성이 확인되었습니다.

버전 2.0.7.0

  • 이제 어댑터에서 AdMob과 Unity Ads의 클릭 통계가 일치하도록 Unity Ads 클릭을 추적합니다.
  • 이제 앱이 interstitialWillLeaveApplication:rewardBasedVideoAdWillLeaveApplication: 콜백을 수신합니다.

버전 2.0.6.0

  • Unity Ads SDK 2.0.6과의 호환성이 확인되었습니다.

버전 2.0.5.0

  • Unity Ads SDK 2.0.5와의 호환성이 확인되었습니다.

버전 2.0.4.0

  • 버전 이름 지정 시스템을 [Unity Ads SDK 버전].[어댑터 패치 버전]으로 변경했습니다.
  • 필요한 최소 Unity Ads SDK가 v2.0.4로 업데이트되었습니다.
  • 필요한 최소 Google 모바일 광고 SDK가 v7.10.1로 업데이트되었습니다.

버전 1.0.2

  • 사용자의 보상을 상품성의 핵심이 아닌 요소로 만들었습니다. 리워드 키는 항상 비어 있거나 유효한 문자열입니다.

버전 1.0.1

  • rewardBasedVideoAdDidOpen: 콜백이 호출되지 않는 버그가 수정되었습니다.

버전 1.0.0

  • 전면 광고 및 보상 기반 동영상 광고를 지원합니다.