이 가이드에서는 Google 모바일 광고 SDK를 사용하여 광고를 로드하고 표시하는 방법을 설명합니다. 광고를 게재할 수 있는 미디에이션을 이용하며, 폭포식 구조 통합. 여기에는 DT Exchange를 광고 단위의 조정 구성, DT Exchange SDK와 어댑터를 통합하는 방법 삽입하세요. Unity
지원되는 통합 및 광고 형식
DT Exchange용 AdMob 미디에이션 어댑터에는 다음 기능을 지원합니다.
통합 | |
---|---|
입찰 | |
폭포 | |
형식 | |
배너 | |
전면 광고 | |
리워드 제공됨 |
요구사항
- 최신 Google 모바일 광고 SDK
- Unity 4 이상
- Android에 배포하기 위한 요건
<ph type="x-smartling-placeholder">
- </ph>
- Android API 수준 21 이상
- iOS에 배포하는 경우
<ph type="x-smartling-placeholder">
- </ph>
- 12.0 이상의 iOS 배포 대상
- Google에서 구성한 작업 Unity 프로젝트 모바일 광고 SDK에 오신 것을 환영합니다. 자세한 내용은 시작하기를 참고하세요.
- 중재 완료 시작 가이드
1단계: DT Exchange UI에서 구성 설정
Add new app and ad placement
Sign up or log in to DT Exchange Console.
Click on the Add App button to add your app.
Select your Platform, fill out the rest of the form, and click Add Placements.
Android
iOS
Enter a name for the new placement in the field labeled Name your Placement and select your desired Placement Type from the dropdown list. Finally, click Save Placement.
App ID and Placement ID
Open the left navigation bar by hovering your mouse over it. Then click Apps from the left menu.
On the App Management page, take note of the App ID next to your app.
Select your app, navigate to the Placements tab, and click on the copy icon next to Placement Name. Take note of the Placement ID.
Publisher ID, Consumer Key and Consumer Secret
Click on your username from the left menu and select User Profile.
Take note of the Publisher ID, Consumer Key, and Consumer Secret as these are needed in the next step.
2단계: UI에서 AdMob DT Exchange 수요 설정
광고 단위에 대한 미디에이션 설정 구성
GDPR 및 미국 주 규정 광고 파트너 목록에 Fyber 추가
GDPR 설정 및 미국 주 규정 설정 Fyber 를 AdMob UI의 GDPR 및 미국 주 규정 광고 파트너 목록에 추가합니다.
3단계: DT Exchange SDK 및 어댑터 가져오기
DT용 Google 모바일 광고 미디에이션 플러그인 최신 버전 다운로드
Exchange Server의
변경 로그 및 추출
ZIP 파일에서 GoogleMobileAdsFyberMediation.unitypackage
를 다운로드합니다.
Unity 프로젝트 편집기에서 Assets(애셋) > Assets(애셋) > 패키지 가져오기 > 사용자 지정
Package를 열고 필요한 GoogleMobileAdsFyberMediation.unitypackage
파일을 찾습니다.
다운로드되었습니다. 모든 파일이 선택되었는지 확인하고 Import(가져오기)를 클릭합니다.
그런 다음 애셋 > Play 서비스 리졸버 > Android 리졸버 > 강제 적용
해결을 선택합니다. Unity Play 서비스 리졸버 라이브러리가 종속 항목을 실행합니다.
처음부터 새로 만들고 선언된 종속 항목을
Unity 앱의 Assets/Plugins/Android
디렉터리
4단계: DT Exchange SDK에 개인 정보 보호 설정 구현
EU 동의 및 GDPR
Google EU 사용자 동의에 따름 정책에 따라 특정 정보 공개가 이루어지도록 해야 합니다. 다음과 관련하여 유럽 경제 지역 (EEA) 사용자의 동의를 얻은 기기 식별자 및 개인 정보의 사용 이 정책에는 EU 온라인 개인 정보 보호 지침 및 일반 데이터 보호 요구사항 규정 (GDPR). 동의를 받을 때 각 광고 네트워크를 명시해야 합니다. 개인 정보를 수집, 수신 또는 사용할 수 있는 미디에이션 체인에서 각 네트워크의 사용에 대한 정보를 제공합니다. Google에서는 현재 사용자의 동의 여부를 이러한 네트워크에 자동으로 전달합니다.
이 섹션에서는 DT Exchange에 개인 맞춤 광고를 사용 설정 또는 사용 중지하는 방법을 설명합니다.
DT Exchange 버전 1.1.0용 Google 모바일 광고 미디에이션 플러그인에는
Fyber
클래스와 SetGDPRRequired()
및 SetGDPRConsentString()
메서드
DT Exchange에 동의 정보를 수동으로 전달할 수 있습니다. 다음
샘플 코드는 이러한 매개변수를 DT Exchange에 전달하는 방법을 보여줍니다.
어댑터:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");
DT Exchange의 GDPR 도움말을 참조하세요.
미국 주 개인 정보 보호법
미국 주 개인 정보 보호법 사용자는 '할인' 기능을 '개인 정보' (법에서 'Do Not Sell My Personal(내 개인 판매 거부)' 문구 Information' '판매' 링크를 클릭하면 확인할 수 있습니다. 이 미국 주 개인 정보 보호 법률 준수 가이드를 사용하면 제한적인 데이터 처리 각 광고에 이 설정을 적용할 수는 없습니다. 네트워크를 설정할 수 있습니다 따라서 각 광고 네트워크를 개인 정보 보호 판매에 참여할 수 있는 미디에이션 체인에 해당 네트워크의 가이드라인을 준수하여 규정 준수를 지원합니다
DT Exchange 버전 3.1.1용 Google 모바일 광고 미디에이션 플러그인에는
동의를 전달할 수 있는 SetCCPAString()
메서드가 포함된 Fyber
클래스
수동으로 DT Exchange로 전송합니다. 다음 샘플 코드에서는
를 사용하여 이러한 매개변수를 DT Exchange 어댑터에 전달합니다.
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetCCPAString("myCCPAConsentString");
// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();
DT Exchange의 CCPA Open을 방문하세요. 출처 도움말을 참조하세요.
5단계: 필수 코드 추가하기
Android
DT Exchange 통합에는 추가 코드가 필요하지 않습니다.
iOS
SKAdNetwork 통합
DT Exchange의
문서
를 사용하여 프로젝트의 Info.plist
파일에 SKAdNetwork 식별자를 추가합니다.
6단계: 구현 테스트
테스트 광고 사용 설정
AdMob
테스트 광고 확인
DT Exchange에서 테스트 광고를 수신하고 있는지 확인하려면 광고 검사기에서 DT Exchange (Waterfall) 광고 소스를 사용하여 단일 광고 소스 테스트를 사용 설정하세요.
오류 코드
어댑터가 DT Exchange로부터 광고를 수신하지 못하는 경우, 게시자는
광고 응답의 근본적인 오류를
ResponseInfo
아래의
다음 클래스를 사용합니다.
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
다음은 DT Exchange 어댑터가 생성하는 코드와 함께 제공되는 메시지입니다. 광고가 로드되지 못할 때:
Android
오류 코드 | 이유 |
---|---|
101 | UI에 구성된 AdMob DT Exchange 서버 매개변수가 누락되었거나 잘못되었습니다. |
103 | 요청된 광고 크기가 DT Exchange에서 지원하는 배너 크기와 일치하지 않습니다. |
105 | DT Exchange SDK에서 광고를 로드했지만 예상치 못한 컨트롤러를 반환했습니다. |
106 | 광고를 게재할 준비가 되지 않았습니다. |
200-399 | DT Exchange SDK에서 오류를 반환했습니다. 코드를 참고하세요. 를 참조하세요. |
iOS
오류 코드 | 이유 |
---|---|
0-10 | DT Exchange SDK에서 오류를 반환했습니다. 문서 참조 를 참조하세요. |
101 | UI에 구성된 AdMob DT Exchange 서버 매개변수가 누락되었거나 잘못되었습니다. |
102 | 요청된 광고 크기가 DT Exchange에서 지원하는 배너 크기와 일치하지 않습니다. |
103 | 광고 객체가 이미 사용되어 광고를 표시할 수 없습니다. |
104 | 광고가 준비되지 않아 DT Exchange 광고를 게재하지 못했습니다. |
105 | DT Exchange SDK에서 초기화 오류를 반환했습니다. |
DT Exchange Unity 미디에이션 플러그인 변경 로그
버전 3.3.0
DummyClient
에서PlaceholderClient
로 이름이 변경되었습니다.- DT Exchange Android 어댑터 버전 8.3.0.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.3.1.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 9.2.0을 사용하여 빌드 및 테스트되었습니다.
버전 3.2.1
- DT Exchange Android 어댑터 버전 8.2.7.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.3.1.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 9.1.1로 빌드 및 테스트되었습니다.
버전 3.2.0
- DT Exchange Android 어댑터 버전 8.2.7.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.3.0.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 9.1.0을 사용하여 빌드 및 테스트되었습니다.
버전 3.1.12
- DT Exchange Android 어댑터 버전 8.2.7.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.2.8.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 9.1.0을 사용하여 빌드 및 테스트되었습니다.
버전 3.1.11
- DT Exchange Android 어댑터 버전 8.2.7.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.2.7.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 9.1.0을 사용하여 빌드 및 테스트되었습니다.
버전 3.1.10
- DT Exchange Android 어댑터 버전 8.2.6.1을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.2.7.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 9.0.0을 사용하여 빌드 및 테스트되었습니다.
버전 3.1.8
- DT Exchange Android 어댑터 버전 8.2.5.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.2.6.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 8.6.0을 사용하여 빌드 및 테스트되었습니다.
버전 3.1.7
- DT Exchange Android 어댑터 버전 8.2.4.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.2.4.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 8.5.2로 빌드 및 테스트되었습니다.
버전 3.1.6
- DT Exchange Android 어댑터 버전 8.2.3.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.2.3.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 8.4.1을 사용하여 빌드 및 테스트되었습니다.
버전 3.1.5
- 어댑터 콘텐츠를
GoogleMobileAds/Mediation/DTExchange/
로 이동했습니다. GoogleMobileAds.Mediation.DTExchange
를 사용하도록 어댑터 네임스페이스를 리팩터링했습니다.- DT Exchange Android 어댑터 버전 8.2.3.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.2.1.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 8.1.0을 사용하여 빌드 및 테스트되었습니다.
버전 3.1.4
- DT Exchange Android 어댑터 버전 8.2.2.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.1.9.1을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 7.4.1을 사용하여 빌드 및 테스트되었습니다.
버전 3.1.3
- DT Exchange Android 어댑터 버전 8.2.1.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.1.9.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 7.4.0을 사용하여 빌드 및 테스트되었습니다.
버전 3.1.2
- Unity 미디에이션 플러그인 이름을 'DT Exchange'로 리브랜딩했습니다.
GoogleMobileAds.Api.Mediation.Fyber.Fyber
클래스의 이름을GoogleMobileAds.Api.Mediation.DTExchange.DTExchange
로 바꿨습니다.- DT Exchange Android 어댑터 버전 8.2.1.0을 지원합니다.
- DT Exchange iOS 어댑터 버전 8.1.7.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 7.3.1을 사용하여 빌드 및 테스트되었습니다.
버전 3.1.1
Fyber
클래스에 다음 메서드를 추가했습니다. <ph type="x-smartling-placeholder">- </ph>
SetCCPAString(string)
ClearCCPAString()
- Fyber Android 어댑터 버전 8.2.0.0을 지원합니다.
- Fyber iOS 어댑터 버전 8.1.6.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 7.3.0을 사용하여 빌드 및 테스트되었습니다.
버전 3.1.0
- Fyber Android 어댑터 버전 8.2.0.0을 지원합니다.
- Fyber iOS 어댑터 버전 8.1.5.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 7.2.0을 사용하여 빌드 및 테스트되었습니다.
버전 3.0.2
- Fyber Android 어댑터 버전 8.1.3.1을 지원합니다.
- Fyber iOS 어댑터 버전 8.1.5.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 7.0.2를 사용하여 빌드 및 테스트되었습니다.
버전 3.0.1
- Fyber Android 어댑터 버전 8.1.3.0을 지원합니다.
- Fyber iOS 어댑터 버전 8.1.4.0을 지원합니다.
- Google 모바일 광고 Unity 플러그인 버전 7.0.0을 사용하여 빌드 및 테스트되었습니다.
버전 3.0.0
- Fyber Android 어댑터 버전 8.1.2.0을 지원합니다.
- Fyber iOS 어댑터 버전 8.1.2.0을 지원합니다.
버전 2.0.0
- Fyber Android 어댑터 버전 7.8.4.1을 지원합니다.
- Fyber iOS 어댑터 버전 8.0.0.0을 지원합니다.
버전 1.6.1
- Fyber Android 어댑터 버전 7.8.3.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.8.6.0을 지원합니다.
버전 1.6.0
- Fyber Android 어댑터 버전 7.8.2.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.8.5.0을 지원합니다.
버전 1.5.2
- Fyber Android 어댑터 버전 7.7.4.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.7.3.0을 지원합니다.
버전 1.5.1
- Fyber Android 어댑터 버전 7.7.2.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.7.2.0을 지원합니다.
버전 1.5.0
- Fyber Android 어댑터 버전 7.7.1.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.7.1.0을 지원합니다.
버전 1.4.0
- Fyber Android 어댑터 버전 7.7.0.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.6.4.0을 지원합니다.
버전 1.3.0
- Fyber Android 어댑터 버전 7.6.0.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.6.0.0을 지원합니다.
버전 1.2.3
- Fyber Android 어댑터 버전 7.5.4.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.5.6.0을 지원합니다.
버전 1.2.2
- Fyber Android 어댑터 버전 7.5.3.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.5.4.0을 지원합니다.
버전 1.2.1
- Fyber Android 어댑터 버전 7.5.2.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.5.3.0을 지원합니다.
버전 1.2.0
- Fyber Android 어댑터 버전 7.5.0.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.5.1.0을 지원합니다.
버전 1.1.0
- GDPR 요구사항을 지원하기 위해
Fyber
클래스에 다음 메서드를 추가했습니다. <ph type="x-smartling-placeholder">- </ph>
SetGDPRConsent()
SetGDPRConsentString()
ClearGDPRConsentData()
- Fyber Android 어댑터 버전 7.3.4.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.5.0.0을 지원합니다.
버전 1.0.0
- 첫 출시!
- Fyber Android 어댑터 버전 7.3.4.0을 지원합니다.
- Fyber iOS 어댑터 버전 7.4.0.0을 지원합니다.