이 가이드에서는 Google 모바일 광고 SDK를 사용하여 광고를 로드하고 표시하는 방법을 설명합니다. 을(를) 사용하는 Chartboost의 광고 AdMob 미디에이션 살펴보겠습니다 광고 단위의 미디에이션 구성, Chartboost SDK와 어댑터를 통합하는 방법 삽입하세요. iOS
지원되는 통합 및 광고 형식
Chartboost용 미디에이션 어댑터의 기능은 다음과 같습니다.
통합 | |
---|---|
입찰 | |
폭포 | |
형식 | |
배너 | |
전면 광고 | |
리워드 제공됨 | |
네이티브 |
요구사항
- 12.0 이상의 iOS 배포 대상
최신 Google 모바일 광고 SDK
중재 완료 시작 가이드
1단계: Chartboost UI에서 구성 설정
2단계: UI에서 Chartboost 수요 AdMob 설정
광고 단위에 대한 미디에이션 설정 구성
Chartboost 를 광고 단위의 미디에이션 구성에 추가해야 합니다.
먼저 AdMob 계정에 로그인합니다. 그런 다음 미디에이션 탭으로 이동합니다. 수정할 기존 미디에이션 그룹이 있는 경우 해당 미디에이션 그룹의 이름을 클릭하여 수정한 후 Chartboost 광고 소스로 추가로 건너뜁니다.
새 미디에이션 그룹을 만들려면 미디에이션 그룹 만들기를 선택합니다.
광고 형식과 플랫폼을 입력하고 계속을 클릭합니다.
미디에이션 그룹에 이름을 지정하고 타겟팅할 위치를 선택합니다. 미디에이션 그룹 상태를 사용으로 설정한 다음 광고 단위 추가를 클릭합니다.
이 미디에이션 그룹을 하나 이상의 기존AdMob 광고 단위와 연결합니다. 그런 다음 완료를 클릭합니다.
이제 광고 단위 카드가 선택한 광고 단위로 채워진 것을 볼 수 있습니다.
광고 소스로 Chartboost 추가
광고 소스 섹션의 폭포식 구조 카드에서 광고 소스 추가를 선택합니다. 그런 다음 Chartboost을 선택합니다.
Chartboost를 선택하고 최적화 스위치를 사용 설정합니다. 이전 섹션에서 가져온 User ID and User Signature을 입력하여Chartboost에 대해 광고 소스 최적화를 설정합니다. 그런 다음Chartboost 에 eCPM 값을 입력하고 계속을 클릭합니다.이미 Chartboost에 대한 매핑이 있는 경우 해당 매핑을 선택할 수 있습니다. 그렇지 않으면 매핑 추가를 클릭합니다.
그런 다음 이전 섹션에서 얻은 App ID, App Signature and Ad Location를 입력합니다. 그런 다음 완료를 클릭합니다.
Chartboost 광고 위치(이름이 지정된 위치)는 앱에서 광고를 게재할 위치를 나타내는 단순한 이름입니다.AdMob 설정에 지정된 위치로 요청을 보냅니다. 요청이 전송되면 Chartboost는 보고 목적으로 플랫폼에 위치를 추가합니다. 또한 사용자는 게임에서 광고 위치를 호출하기 전에 Chartboost 플랫폼에서 직접 새 광고 위치를 만들 수 있습니다.
Chartboost UI에서 광고 위치는 고급 설정을 클릭하여 기본 설정 페이지에 표시할 수 있습니다. 자세한 내용은 Chartboost의 이름이 지정된 위치 가이드를 참조하세요.
마지막으로 완료를 클릭하여 Chartboost를 광고 소스로 추가한 후 저장을 클릭합니다.
GDPR 및 미국 주 규정 광고 파트너 목록에 Chartboost 추가
GDPR 설정 및 미국 주 규정 설정 Chartboost 를 AdMob UI의 GDPR 및 미국 주 규정 광고 파트너 목록에 추가합니다.
3단계: Chartboost SDK 및 어댑터 가져오기
CocoaPods 사용 (권장)
프로젝트의 Podfile에 다음 행을 추가합니다.
pod 'GoogleMobileAdsMediationChartboost'
명령줄에서 다음을 실행합니다.
pod install --repo-update
수동 통합
최신 버전의 Chartboost SDK 및 링크 프로젝트에 Chartboost.framework 및 CHAMoatMobileAppKit.framework가 있습니다.
변경 로그의 다운로드 링크에서 Chartboost 어댑터의 최신 버전을 다운로드합니다. 프로젝트에서 ChartboostAdapter.framework를 연결합니다.
다음 프레임워크를 프로젝트에 추가합니다.
StoreKit
Foundation
CoreGraphics
WebKit
AVFoundation
UIKit
4단계: Chartboost SDK에서 개인 정보 보호 설정 구현
EU 동의 및 GDPR
Google EU 사용자 동의에 따름 정책에 따라 특정 정보 공개가 이루어지도록 해야 합니다. 다음과 관련하여 유럽 경제 지역 (EEA) 사용자의 동의를 얻은 기기 식별자 및 개인 정보의 사용 이 정책에는 EU 온라인 개인 정보 보호 지침 및 일반 데이터 보호 요구사항 규정 (GDPR). 동의를 받을 때 각 광고 네트워크를 명시해야 합니다. 개인 정보를 수집, 수신 또는 사용할 수 있는 미디에이션 체인에서 각 네트워크의 사용에 대한 정보를 제공합니다. Google에서는 현재 사용자의 동의 여부를 이러한 네트워크에 자동으로 전달합니다.
SDK 버전 8.2.0에서 Chartboost는 addDataUseConsent
메서드를 추가했습니다. 이
다음 샘플 코드는 CHBGDPRConsentNonBehavioral
에 데이터 사용 동의를 설정합니다. 만약
이 메서드를 호출한 경우
Google 모바일 광고 SDK를 통해 광고를 요청할 수 있습니다.
Swift
let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)
Objective-C
CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];
차트 부스트 보기 GDPR 도움말 및 <ph type="x-smartling-placeholder"> iOS 개인 정보 보호 방법 를 참조하세요.
미국 주 개인 정보 보호법
미국 주 개인 정보 보호법 사용자는 '할인' 기능을 '개인 정보' (법에서 'Do Not Sell My Personal(내 개인 판매 거부)' 문구 Information' '판매' 링크를 클릭하면 확인할 수 있습니다. 이 미국 주 개인 정보 보호 법규 준수 가이드를 통해 제한적인 데이터 처리 각 광고에 이 설정을 적용할 수는 없습니다. 네트워크를 설정할 수 있습니다 따라서 각 광고 네트워크를 개인 정보 보호 판매에 참여할 수 있는 미디에이션 체인에 해당 네트워크의 가이드라인을 준수하여 있습니다
SDK 버전 8.2.0에서 Chartboost는 addDataUseConsent
메서드를 추가했습니다. 이
다음 샘플 코드는 CHBCCPAConsentOptInSale
에 데이터 사용 동의를 설정합니다. 만약
이 메서드를 호출하기로 선택하는 경우 이 메서드를 요청하기 전에
광고를 게재할 수 있습니다.
Swift
let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)
Objective-C
CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];
차트 부스트 보기 CCPA 도움말 및 <ph type="x-smartling-placeholder"> iOS 개인 정보 보호 방법 를 참조하세요.
오류 코드
어댑터가 Chartboost의 광고를 수신하지 못하면
광고 응답의 근본적인 오류를
GADResponseInfo.adNetworkInfoArray
다음 클래스에 포함됩니다.
GADMAdapterChartboost
GADMediationAdapterChartboost
다음은 Chartboost 어댑터가 생성하는 코드와 관련 메시지입니다. 광고가 로드되지 못할 때:
오류 코드 | 이유 |
---|---|
101 | UI에 구성된 Chartboost 서버 매개변수가 AdMob 누락되거나 잘못되었습니다. |
102 | Chartboost SDK에서 초기화 오류를 반환했습니다. |
103 | Chartboost 광고는 표시 시점에 캐시되지 않습니다. |
104 | 요청한 광고 크기가 Chartboost 지원 배너 크기와 일치하지 않습니다. |
105 | 기기의 OS 버전이 Chartboost SDK의 최소 지원 OS 버전보다 낮습니다. |
200-299 | Chartboost SDK 캐시 오류입니다. 코드를 참고하세요. 를 참조하세요. |
300-399 | Chartboost SDK에 오류가 표시됩니다. 코드를 참고하세요. 를 참조하세요. |
400-499 | Chartboost SDK 클릭 오류 코드를 참고하세요. 를 참조하세요. |
Chartboost iOS 미디에이션 어댑터 변경 로그
버전 9.7.0.0
- Chartboost SDK 버전 9.7.0과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.2.0.
- Chartboost SDK 버전 9.7.0.
버전 9.6.0.1
- 이제 iOS 버전 12.0 이상이 필요합니다.
- 이제 Google 모바일 광고 SDK 버전 11.0 이상이 필요합니다.
ChartboostAdapter.xcframework
내 프레임워크에Info.plist
가 포함되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.0.1.
- Chartboost SDK 버전 9.6.0.
버전 9.6.0.0
- Chartboost SDK 버전 9.6.0과의 호환성 확인
- 지원 중단된
GADMobileAds.sharedInstance.sdkVersion
메서드를GADMobileAds.sharedInstance.versionNumber
로 대체했습니다. GADMediationInterstitialAd
구현을 추가했습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.14.0.
- Chartboost SDK 버전 9.6.0.
버전 9.5.1.0
- Chartboost SDK 버전 9.5.1과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.12.0.
- Chartboost SDK 버전 9.5.1.
버전 9.4.0.0
- Chartboost SDK 버전 9.4.0과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.7.0.
- Chartboost SDK 버전 9.4.0.
버전 9.3.1.0
- Chartboost SDK 버전 9.3.1과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.7.0.
- Chartboost SDK 버전 9.3.1.
버전 9.3.0.0
- Chartboost SDK 버전 9.3.0과의 호환성 확인
- 이제 iOS 버전 11.0 이상이 필요합니다.
- 이제 Google 모바일 광고 SDK 버전 10.4.0 이상이 필요합니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.4.0.
- Chartboost SDK 버전 9.3.0.
버전 9.2.0.0
ChartboostAdapter
헤더 파일에서GADMChartboostExtras
가져오기를 삭제했습니다.- Chartboost SDK 버전 9.2.0과의 호환성 확인
- 이제 Google 모바일 광고 SDK 버전 10.0.0 이상이 필요합니다.
armv7
아키텍처 지원을 삭제했습니다.- 이제 iOS 버전 11.0 이상이 필요합니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.0.0.
- Chartboost SDK 버전 9.2.0.
버전 9.1.0.0
- Chartboost SDK 버전 9.1.0과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.11.0.
- Chartboost SDK 버전 9.1.0.
버전 9.0.0.0
- Chartboost SDK 버전 9.0.0과의 호환성 확인
- Google 모바일 광고 SDK 버전 9.10.0과의 호환성이 확인되었습니다.
didRewardUser
API를 사용하도록 어댑터를 업데이트했습니다.- 이제 Google 모바일 광고 SDK 버전 9.8.0 이상이 필요합니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.10.0.
- Chartboost SDK 버전 9.0.0.
버전 8.5.0.2
- Google 모바일 광고 SDK 버전 9.0.0과의 호환성이 확인되었습니다.
- 이제 Google 모바일 광고 SDK 버전 9.0.0 이상이 필요합니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.0.0.
- Chartboost SDK 버전 8.5.0.
버전 8.5.0.1.0
- CocoaPods의 버전 8.5.0.1을 참조하는 Chartboost SDK 8.5.0과의 호환성 확인
빌드 및 테스트
- Google 모바일 광고 SDK 버전 8.13.0.
- Chartboost SDK 버전 8.5.0.
버전 8.5.0.0
- Chartboost SDK 8.5.0과의 호환성 확인
빌드 및 테스트
- Google 모바일 광고 SDK 버전 8.12.0.
- Chartboost SDK 버전 8.5.0.
버전 8.4.2.0
- Chartboost SDK 8.4.2와의 호환성 확인
빌드 및 테스트
- Google 모바일 광고 SDK 버전 8.6.0.
- Chartboost SDK 버전 8.4.2.
버전 8.4.1.1
- Google 모바일 광고 SDK 버전 8.0.0 이상으로의 종속 항목이 완화되었습니다.
빌드 및 테스트
- Google 모바일 광고 SDK 버전 8.4.0.
- Chartboost SDK 버전 8.4.1.
버전 8.4.1.0
- Chartboost SDK 8.4.1과의 호환성 확인
- 이제 Google 모바일 광고 SDK 버전 8.1.0 이상이 필요합니다.
빌드 및 테스트
- Google 모바일 광고 SDK 버전 8.1.0.
- Chartboost SDK 버전 8.4.1.
버전 8.4.0.1
- 표준화된 어댑터 오류 코드와 메시지를 추가했습니다.
.xcframework
형식을 사용하도록 어댑터를 업데이트했습니다.- 이제 Google 모바일 광고 SDK 버전 8.0.0 이상이 필요합니다.
빌드 및 테스트
- Google 모바일 광고 SDK 버전 8.0.0.
- Chartboost SDK 버전 8.4.0.
버전 8.4.0.0
- Chartboost SDK 8.4.0과의 호환성 확인
- 이제 Google 모바일 광고 SDK 버전 7.68.0 이상이 필요합니다.
빌드 및 테스트
- Google 모바일 광고 SDK 버전 7.68.0
- Chartboost SDK 버전 8.4.0.
버전 8.3.1.0
- Chartboost SDK 8.3.1과의 호환성 확인
- 이제 Google 모바일 광고 SDK 버전 7.66.0 이상이 필요합니다.
- 이제 iOS 버전 10.0 이상이 필요합니다.
- 적응형 배너 요청을 지원하도록 어댑터가 업데이트되었습니다.
빌드 및 테스트
- Google 모바일 광고 SDK 버전 7.66.0
- Chartboost SDK 버전 8.3.1.
버전 8.2.1.0
- Chartboost SDK 8.2.1과의 호환성 확인
- 이제 Google 모바일 광고 SDK 버전 7.64.0 이상이 필요합니다.
- 이제 iOS 버전 9.0 이상이 필요합니다.
빌드 및 테스트
- Google 모바일 광고 SDK 버전 7.64.0
- Chartboost SDK 버전 8.2.1.
버전 8.2.0.0
- Chartboost SDK 8.2.0과의 호환성 확인
- 이제 Google 모바일 광고 SDK 버전 7.61.0 이상이 필요합니다.
빌드 및 테스트
- Google 모바일 광고 SDK 버전 7.61.0.
- Chartboost SDK 버전 8.2.0.
버전 8.1.0.1
- 필요한 최소 Google 모바일 광고 SDK 버전이 7.60.0으로 업데이트되었습니다.
- Chartboost의 새 API를 사용하도록 어댑터를 업데이트하고 지원 중단된 API를 삭제했습니다.
- 이제 어댑터에서 동일한 Chartboost 위치를 사용하여 동일한 형식의 여러 광고를 로드할 수 있습니다.
- AdMob 또는 Ad Manager UI에서 리워드가 재정의되지 않는 경우 보상형 광고의 리워드 값은 이제 Chartboost UI에서
0
가 아닌 지정된 값이 됩니다.
빌드 및 테스트
- Google 모바일 광고 SDK 버전 7.60.0
- Chartboost SDK 버전 8.1.0.
버전 8.1.0.0
- Chartboost SDK 8.1.0과의 호환성 확인
- 필요한 최소 Google 모바일 광고 SDK 버전이 7.59.0으로 업데이트되었습니다.
- i386 아키텍처에 대한 지원을 삭제했습니다.
빌드 및 테스트
- Google 모바일 광고 SDK 버전 7.59.0.
- Chartboost SDK 버전 8.1.0.
버전 8.0.4.0
- Chartboost SDK 8.0.4와의 호환성 확인
빌드 및 테스트
- Google 모바일 광고 SDK 버전 7.52.0
- Chartboost SDK 버전 8.0.4.
버전 8.0.1.1
- 배너 광고를 요청하면 채워지지 않는 문제를 해결했습니다.
버전 8.0.1.0
- Chartboost SDK 8.0.1과의 호환성 확인
- 배너 광고 요청에 대한 지원이 추가되었습니다.
버전 7.5.0.1
- Chartboost SDK를 올바르게 초기화하는 코드가 추가되었습니다.
버전 7.5.0.0
- Chartboost SDK 7.5.0과의 호환성 확인
- 새 보상형 API를 사용하도록 어댑터가 업데이트되었습니다.
- 여러 전면 광고 요청을 처리하도록 어댑터가 업데이트되었습니다.
- 이제 Google 모바일 광고 SDK 버전 7.42.2 이상이 필요합니다.
버전 7.3.0.0
- Chartboost SDK 7.3.0과의 호환성 확인
버전 7.2.0.1
- 어댑터에
adapterDidCompletePlayingRewardBasedVideoAd:
콜백을 추가했습니다.
버전 7.2.0.0
- Chartboost SDK 7.2.0과의 호환성 확인
버전 7.1.2.0
- Chartboost SDK 7.1.2와의 호환성 확인
버전 7.1.1.0
- Chartboost SDK 7.1.1과의 호환성 확인
버전 7.1.0.0
- Chartboost SDK 7.1.0과의 호환성 확인
버전 7.0.4.0
- Chartboost SDK 7.0.4와의 호환성 확인
버전 7.0.3.0
- Chartboost SDK 7.0.3과의 호환성 확인
버전 7.0.2.0
- Chartboost SDK 7.0.2와의 호환성 확인
- 새로운 Chartboost 오류 코드 2개에 대한 지원이 추가되었습니다.
버전 7.0.1.0
- Chartboost SDK 7.0.1과의 호환성 확인
버전 7.0.0.0
- Chartboost SDK 7.0.0과의 호환성 확인
버전 6.6.3.0
- Chartboost SDK 6.6.3과의 호환성 확인
- 'armv7s'에 대한 지원이 삭제되었습니다. 살펴봤습니다
- 게시자가 Swift에서 가져올 때 컴파일 문제가 발생하는 버그가 수정되었습니다.
비모듈식을 가져온 모듈로서의
ChartboostAdapter.framework
Chartboost SDK
버전 6.6.2.0
- Chartboost SDK 6.6.2와의 호환성 확인
버전 6.6.1.0
- Chartboost SDK 6.6.1과의 호환성 확인
버전 6.6.0.0
- Chartboost SDK 6.6.0과의 호환성 확인
버전 6.5.2.1
- 비트코드 지원을 사용합니다.
- 이제 Chartboost 어댑터를 프레임워크로 배포합니다.
- 프로젝트에서
ChartboostAdapter.framework
를 가져오려면 다음을 설정하세요.Allow Non-modular Includes in Framework Modules
에서YES
(빌드)로 변경 타겟의 설정입니다.
버전 6.5.2.0
- 버전 이름 지정 시스템이 다음으로 변경됨 [Chartboost SDK 버전].[어댑터 패치 버전].
- 필요한 최소 Chartboost SDK가 v6.5.1로 업데이트되었습니다.
- 필요한 최소 Google 모바일 광고 SDK가 v7.10.1로 업데이트되었습니다.
- 여러 Chartboost 광고 위치를 지원하도록 버그를 수정했습니다.
- 이제 앱은 다음과 같은 경우
interstitialWillDismissScreen:
콜백을 받습니다. 전면 광고가 닫히려고 하면 - 이제 리워드 기반일 때 앱에서
rewardBasedVideoAdDidOpen:
콜백을 받습니다. 동영상 광고가 열립니다.
버전 1.1.0
- Chartboost extras에서 Chartboost 광고 위치를 삭제했습니다. 광고 위치가 변경됨 미디에이션을 위해 Chartboost를 구성할 때 AdMob 콘솔에서 지정됩니다.
버전 1.0.0
- 첫 출시입니다. 리워드 기반 동영상 광고 및 전면 광고를 지원합니다.