이 가이드에서는 Google 모바일 광고 SDK를 사용하여 광고를 로드하고 표시하는 방법을 설명합니다. 를 사용하는 Pangle 광고 AdMob 미디에이션 폭포식 구조와 입찰 통합을 모두 다룹니다. Pangle을 광고 단위의 미디에이션 구성, Pangle SDK와 어댑터를 iOS 앱에 연결합니다.
지원되는 통합 및 광고 형식
Pangle용 미디에이션 어댑터의 기능은 다음과 같습니다.
통합 | |
---|---|
입찰 | |
폭포 | 를 탭합니다. <ph type="x-smartling-placeholder"> |
형식 | |
앱 오프닝 광고 | 를 탭합니다. <ph type="x-smartling-placeholder"> </ph> 1 |
배너 | |
전면 광고 | |
리워드 제공됨 | |
보상형 전면 광고 | |
네이티브 |
요구사항
- 10.0 이상의 iOS 배포 대상
최신 Google 모바일 광고 SDK
중재 완료 시작 가이드
1단계: Pangle UI에서 구성 설정
새 애플리케이션 추가
Applications(애플리케이션) 탭으로 이동하고 Add App(앱 추가) 버튼을 클릭합니다.
애플리케이션을 만들려는 운영체제를 선택하고 양식의 나머지 부분을 작성합니다. 그런 다음 제출을 클릭합니다.
애플리케이션의 앱 ID를 기록해 둡니다.
광고 게재위치 만들기
애플리케이션을 만들었으면 추가 버튼을 클릭하여 광고 게재위치를 만듭니다.
입찰
광고 형식과 광고 게재위치 이름을 선택하고 가격 책정 유형으로 인앱 입찰을 선택합니다. 양식의 나머지 부분을 작성하고 제출을 클릭합니다.
광고 게재위치를 만들었으면 광고 게재위치 ID를 기록해 둡니다.
폭포
광고 형식과 광고 게재위치 이름을 선택하고, 가격 책정 유형으로 글로벌 CPM을 선택합니다. 양식의 나머지 부분을 작성하고 제출을 클릭합니다.
광고 게재위치를 만들었으면 광고 게재위치 ID를 기록해 둡니다.
Pangle Reporting API 키 찾기
입찰
이 단계는 입찰 통합에는 필요하지 않습니다.
폭포
페이지 왼쪽 하단에 있는 User ID를 메모합니다.
통합 > SDK 및 API > Pangle Reporting API 2.0을 클릭합니다. 역할 ID 및 보안 키를 기록해 둡니다.
테스트 모드 사용 설정
Pangle 테스트 광고를 사용 설정하는 방법은 Pangle의 테스트 광고 추가 방법 가이드에 있는 안내를 따릅니다.
2단계: UI에서 AdMob Pangle 수요 설정
광고 단위에 대한 미디에이션 설정 구성
Pangle 를 광고 단위의 미디에이션 구성에 추가해야 합니다.
먼저 AdMob 계정에 로그인합니다. 그런 다음 미디에이션 탭으로 이동합니다. 수정할 기존 미디에이션 그룹이 있는 경우 해당 미디에이션 그룹의 이름을 클릭하여 수정한 후 Pangle 광고 소스로 추가로 건너뜁니다.
새 미디에이션 그룹을 만들려면 미디에이션 그룹 만들기를 선택합니다.
광고 형식과 플랫폼을 입력하고 계속을 클릭합니다.
미디에이션 그룹에 이름을 지정하고 타겟팅할 위치를 선택합니다. 미디에이션 그룹 상태를 사용으로 설정한 다음 광고 단위 추가를 클릭합니다.
이 미디에이션 그룹을 하나 이상의 기존AdMob 광고 단위와 연결합니다. 그런 다음 완료를 클릭합니다.
이제 광고 단위 카드가 선택한 광고 단위로 채워진 것을 볼 수 있습니다.
광고 소스로 Pangle 추가
입찰
광고 소스 섹션의 입찰 카드에서 광고 소스 추가를 선택합니다. 그런 다음 Pangle을 선택합니다.
파트너십 계약을 체결하는 방법을 클릭하고Pangle과(와) 입찰 파트너십을 설정합니다.
확인 및 동의를 클릭한 다음 계속을 클릭합니다.
이미 Pangle에 대한 매핑이 있는 경우 해당 매핑을 선택할 수 있습니다. 그렇지 않으면 매핑 추가를 클릭합니다.
그런 다음 이전 섹션에서 얻은 App ID and Ad Placement ID를 입력합니다. 그런 다음 완료를 클릭합니다.
중요: App ID 는Pangle UI에서와 같이 타겟팅된 앱과 연결되어야 합니다.폭포
광고 소스 섹션의 폭포식 구조 카드에서 광고 소스 추가를 선택합니다. 그런 다음 Pangle을 선택합니다.
Pangle를 선택합니다. 그런 다음Pangle 에 eCPM 값을 입력하고 계속을 클릭합니다.이미 Pangle에 대한 매핑이 있는 경우 해당 매핑을 선택할 수 있습니다. 그렇지 않으면 매핑 추가를 클릭합니다.
그런 다음 이전 섹션에서 얻은 App ID and Ad Placement ID를 입력합니다. 그런 다음 완료를 클릭합니다.
3단계: Pangle SDK 및 어댑터 가져오기
CocoaPods 사용 (권장)
프로젝트의 Podfile에 다음 행을 추가합니다.
pod 'GoogleMobileAdsMediationPangle'
명령줄에서 다음을 실행합니다.
pod install --repo-update
수동 통합
- 최신 버전의
iOS용 Pangle SDK
프로젝트의 모든
.framework
파일과 번들을 연결합니다. - 다음 링크의 다운로드 링크에서 최신 버전의 Pangle 어댑터를 다운로드합니다.
변경 로그 및
PangleAdapter.xcframework
를 생성합니다.
4단계: 필수 코드 추가하기
SKAdNetwork 통합
Pangle 문서 따르기
를 사용하여 프로젝트의 Info.plist
파일에 SKAdNetwork 식별자를 추가합니다.
5단계: 구현 테스트
테스트 광고 사용 설정
AdMob 용 테스트 기기를 등록하고 Pangle UI에서 테스트 모드를 사용 설정해야 합니다.
테스트 광고 확인
Pangle에서 테스트 광고를 수신하고 있는지 확인하려면 광고 검사기에서 Pangle (Bidding) and Pangle (Waterfall) 광고 소스를 사용하여 단일 광고 소스 테스트를 사용 설정하세요.
선택적 단계
네이티브 광고
광고 렌더링
Pangle 어댑터는 네이티브 광고를 다음과 같이 반환합니다.
</ph>
GADNativeAd
객체입니다. 이는 다음을 채웁니다.
필드
GADNativeAd
필드 | 애셋은 항상 Pangle 어댑터에 의해 포함됨 |
---|---|
광고 제목 | |
이미지 | 1 |
본문 | |
아이콘 | |
클릭 유도 문구 | |
별표 평점 | |
스토어 | |
가격 | |
광고주 |
1 Pangle 어댑터는 그렇지 않습니다.
네이티브 광고의 기본 이미지 애셋에 직접 액세스할 수 있어야 합니다. 대신
어댑터는
GADMediaView
동영상 또는 이미지로
검색할 수 있습니다
오류 코드
어댑터가 Pangle에서 광고를 수신하지 못하는 경우
광고 응답의 근본적인 오류를
GADResponseInfo.adNetworkInfoArray
다음 클래스에 포함됩니다.
GADMediationAdapterPangle
다음은 Pangle 어댑터가 생성할 때 발생하는 코드와 관련 메시지입니다. 광고를 로드하지 못한 경우:
오류 코드 | 도메인 | 이유 |
---|---|---|
101 | com.google.ads.mediation.pangle | 서버 매개변수가 잘못되었습니다 (예: 앱 ID 또는 게재위치 ID 누락). |
102 | com.google.ads.mediation.pangle | 요청한 광고 크기가 Pangle 지원 배너 크기와 일치하지 않습니다. |
-1-60000 | Pangle SDK에서 전송 | Pangle SDK에서 오류를 반환했습니다. 자세한 내용은 Pangle의 문서를 참조하세요. |
Pangle iOS 미디에이션 어댑터 변경 로그
버전 6.1.0.6.0
- Pangle SDK 버전 6.1.0.6과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.7.0.
- Pangle SDK 버전 6.1.0.6.
버전 6.1.0.5.0
- Pangle SDK 버전 6.1.0.5와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.6.0.
- Pangle SDK 버전 6.1.0.5.
버전 6.1.0.4.0
- Pangle SDK 버전 6.1.0.4와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.6.0.
- Pangle SDK 버전 6.1.0.4.
버전 6.0.0.6.0
- Pangle SDK 버전 6.0.0.6과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.6.0.
- Pangle SDK 버전 6.0.0.6.
버전 6.0.0.5.0
- Pangle SDK 버전 6.0.0.5와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.5.0.
- Pangle SDK 버전 6.0.0.5.
버전 6.0.0.4.0
- Pangle SDK 버전 6.0.0.4와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.5.0.
- Pangle SDK 버전 6.0.0.4.
버전 5.9.0.9.0
- Pangle SDK 버전 5.9.0.9와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.5.0.
- Pangle SDK 버전 5.9.0.9.
버전 5.9.0.8.0
- Pangle SDK 버전 5.9.0.8과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.4.0.
- Pangle SDK 버전 5.9.0.8.
버전 5.9.0.7.0
- Pangle SDK 버전 5.9.0.7과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.3.0.
- Pangle SDK 버전 5.9.0.7.
버전 5.8.0.8.0
- Pangle SDK 버전 5.8.0.8과의 호환성 확인
- 새 Pangle SDK 신호 수집 API를 사용하도록 어댑터를 업데이트했습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.2.0.
- Pangle SDK 버전 5.8.0.8.
버전 5.8.0.7.0
- Pangle SDK 버전 5.8.0.7과의 호환성 확인
- 이제 iOS 버전 12.0 이상이 필요합니다.
- 이제 Google 모바일 광고 SDK 버전 11.0 이상이 필요합니다.
PangleAdapter.xcframework
내 프레임워크에Info.plist
가 포함되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 11.0.1.
- Pangle SDK 버전 5.8.0.7.
버전 5.7.0.7.0
- Pangle SDK 버전 5.7.0.7과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.14.0.
- Pangle SDK 버전 5.7.0.7.
버전 5.7.0.6.0
- Pangle SDK 버전 5.7.0.6과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.14.0.
- Pangle SDK 버전 5.7.0.6.
버전 5.6.0.8.0
- Pangle SDK 버전 5.6.0.8과의 호환성 확인
- 지원 중단된
adConfiguration.childDirectedTreatment
속성을 새GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment
속성으로 대체하여+setCOPPA
메서드를 리팩터링했습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.14.0.
- Pangle SDK 버전 5.6.0.8.
버전 5.5.0.9.0
- Pangle SDK 버전 5.5.0.9와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.13.0.
- Pangle SDK 버전 5.5.0.9.
버전 5.5.0.7.0
- Pangle SDK 버전 5.5.0.7과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.12.0.
- Pangle SDK 버전 5.5.0.7.
버전 5.5.0.5.0
- Pangle SDK 버전 5.5.0.5와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.11.0.
- Pangle SDK 버전 5.5.0.5.
버전 5.4.1.1.0
- 앱 오프닝 광고 형식에 대한 입찰 지원이 추가되었습니다.
- Pangle SDK 버전 5.4.1.1과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.10.0.
- Pangle SDK 버전 5.4.1.1.
버전 5.4.0.9.0
- Pangle SDK 버전 5.4.0.9와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.9.0.
- Pangle SDK 버전 5.4.0.9.
버전 5.4.0.8.0
GADPangleNetworkExtras
가GADAdNetworkExtras
프로토콜을 준수하지 않는 문제를 수정했습니다.- 전면 광고, 보상형 광고, 앱 오프닝 광고에
adDidShowFail
프로토콜 메서드를 구현했습니다. - Pangle SDK 버전 5.4.0.8과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.9.0.
- Pangle SDK 버전 5.4.0.8.
버전 5.3.1.2.0
- Pangle SDK 버전 5.3.1.2와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.8.0.
- Pangle SDK 버전 5.3.1.2.
버전 5.3.1.0.0
- Pangle SDK 버전 5.3.1.0과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.8.0.
- Pangle SDK 버전 5.3.1.0.
버전 5.2.1.1.0
- Pangle SDK 버전 5.2.1.1과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.7.0.
- Pangle SDK 버전 5.2.1.1.
버전 5.2.0.9.0
- Pangle SDK 버전 5.2.0.9와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.5.0.
- Pangle SDK 버전 5.2.0.9.
버전 5.2.0.8.0
- Pangle SDK 버전 5.2.0.8과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.5.0.
- Pangle SDK 버전 5.2.0.8.
버전 5.2.0.7.0
- 앱 오프닝, 배너 (MREC 포함), 전면 광고, 보상형 광고, 네이티브 광고 형식에 대한 폭포식 구조 지원이 추가되었습니다.
- Pangle SDK 버전 5.2.0.7과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.5.0.
- Pangle SDK 버전 5.2.0.7.
버전 5.2.0.6.0
- Pangle SDK 버전 5.2.0.6과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.5.0.
- Pangle SDK 버전 5.2.0.6.
버전 5.1.1.0.0
- Pangle SDK 버전 5.1.1.0과의 호환성 확인
arm64
시뮬레이터 아키텍처 지원이 추가되었습니다.- 이제 Google 모바일 광고 SDK 버전 10.4.0 이상이 필요합니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.4.0.
- Pangle SDK 버전 5.1.1.0.
버전 5.1.0.6.0
- Pangle SDK 버전 5.1.0.6과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.3.0.
- Pangle SDK 버전 5.1.0.6.
버전 5.0.1.0.0
- Pangle SDK 버전 5.0.1.0과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.2.0.
- Pangle SDK 버전 5.0.1.0.
버전 5.0.0.8.0
- Pangle SDK 버전 5.0.0.8과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.2.0.
- Pangle SDK 버전 5.0.0.8.
버전 5.0.0.7.0
- Pangle SDK 버전 5.0.0.7과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.1.0.
- Pangle SDK 버전 5.0.0.7.
버전 5.0.0.6.0
- Pangle SDK 버전 5.0.0.6과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.1.0.
- Pangle SDK 버전 5.0.0.6.
버전 4.9.1.0.0
armv7
아키텍처 지원을 삭제했습니다.- Pangle SDK 버전 4.9.1.0과의 호환성 확인
- 이제 iOS 버전 12.0 이상이 필요합니다.
- 이제 Google 모바일 광고 SDK 버전 10.0.0 이상이 필요합니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 10.0.0.
- Pangle SDK 버전 4.9.1.0.
버전 4.9.0.8.0
- Pangle SDK 버전 4.9.0.8과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.14.0.
- Pangle SDK 버전 4.9.0.8.
버전 4.9.0.7.0
- Pangle SDK 버전 4.9.0.7과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.14.0.
- Pangle SDK 버전 4.9.0.7.
버전 4.9.0.6.0
- Pangle SDK 버전 4.9.0.6과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.14.0.
- Pangle SDK 버전 4.9.0.6.
버전 4.8.1.0.0
- Pangle SDK 버전 4.8.1.0과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.14.0.
- Pangle SDK 버전 4.8.1.0.
버전 4.8.0.9.0
- Pangle SDK 버전 4.8.0.9와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.13.0.
- Pangle SDK 버전 4.8.0.9.
버전 4.8.0.7.0
- Pangle SDK 버전 4.8.0.7과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.13.0.
- Pangle SDK 버전 4.8.0.7.
버전 4.8.0.6.0
- Pangle SDK 버전 4.8.0.6과의 호환성이 확인되었습니다.
- 네이티브 광고 아이콘 이미지를 로드할 때 기본 스레드가 차단되는 문제가 해결되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.13.0.
- Pangle SDK 버전 4.8.0.6.
버전 4.7.0.7.0
- Pangle SDK 버전 4.7.0.7과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.11.0.
- Pangle SDK 버전 4.7.0.7.
버전 4.7.0.6.0
- Pangle SDK 버전 4.7.0.6과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.11.0.
- Pangle SDK 버전 4.7.0.6.
버전 4.7.0.5.0
- Pangle SDK 버전 4.7.0.5와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.11.0.
- Pangle SDK 버전 4.7.0.5.
버전 4.7.0.4.0
- Pangle SDK 버전 4.7.0.4와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.10.0.
- Pangle SDK 버전 4.7.0.4.
버전 4.6.2.2.0
setGDPR()
및setCCPA()
메서드의 이름을GADMediationAdapterPangle
클래스에서 각각setGDPRConsent()
와setDoNotSell
로 바꾸었습니다.- Pangle SDK 버전 4.6.2.2와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.10.0.
- Pangle SDK 버전 4.6.2.2.
버전 4.6.1.8.0
- Pangle SDK 버전 4.6.1.8과의 호환성 확인
- 네이티브 광고 형식에 대한 입찰 지원이 추가되었습니다.
didRewardUser
API를 사용하도록 어댑터를 업데이트했습니다.- 이제 Google 모바일 광고 SDK 버전 9.8.0 이상이 필요합니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.9.0.
- Pangle SDK 버전 4.6.1.8.
버전 4.5.2.8.0
- Pangle SDK 버전 4.5.2.8과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.7.0.
- Pangle SDK 버전 4.5.2.8.
버전 4.5.2.7.0
- Pangle SDK 버전 4.5.2.7과의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.7.0.
- Pangle SDK 버전 4.5.2.7.
버전 4.5.2.5.0
- Pangle SDK 버전 4.5.2.5와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.6.0.
- Pangle SDK 버전 4.5.2.5.
버전 4.5.2.4.0
- Pangle SDK 버전 4.5.2.4와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.6.0.
- Pangle SDK 버전 4.5.2.4.
버전 4.5.2.3.0
- Pangle SDK 버전 4.5.2.3과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.6.0.
- Pangle SDK 버전 4.5.2.3.
버전 4.5.1.3.0
- Pangle SDK 버전 4.5.1.3과의 호환성이 확인되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.5.0.
- Pangle SDK 버전 4.5.1.3.
버전 4.3.1.9.0
- Pangle SDK 버전 4.3.1.9와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.3.0.
- Pangle SDK 버전 4.3.1.9.
버전 4.3.0.5.0
- Pangle SDK 버전 4.3.0.5와의 호환성 확인
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.2.0.
- Pangle SDK 버전 4.3.0.5.
버전 4.3.0.4.0
- 첫 출시
- 배너 (MREC 포함), 전면 광고 및 보상형 광고 형식에 대한 입찰 지원이 추가되었습니다.
빌드 및 테스트 대상:
- Google 모바일 광고 SDK 버전 9.1.0.
- Pangle SDK 버전 4.3.0.4.