Pangle과 입찰 통합

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

지원되는 통합 및 광고 형식

Pangle용 미디에이션 어댑터의 기능은 다음과 같습니다.

통합
입찰
폭포  1
형식
앱 오프닝 광고  2
배너
전면 광고
리워드 제공됨
보상형 전면 광고
네이티브
1 Waterfall 통합은 비공개 베타 버전입니다.

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

요구사항

  • iOS 배포 타겟이 10.0 이상임

1단계: Pangle UI에서 구성 설정

Pangle 계정에 가입하거나 로그인합니다.

새 애플리케이션 추가

애플리케이션 탭으로 이동하여 앱 추가 버튼을 클릭합니다.

애플리케이션을 만들려는 운영체제를 선택하고 양식의 나머지 부분을 작성합니다. 그런 다음 제출을 클릭합니다.

애플리케이션의 앱 ID를 기록해 둡니다.

광고 게재위치 만들기

애플리케이션이 생성되면 추가 버튼을 클릭하여 광고 게재위치를 만듭니다.

입찰

광고 형식광고 게재위치 이름을 선택하고 가격 책정 유형으로 인앱 입찰을 선택합니다. 나머지 양식을 작성하고 제출을 클릭합니다.

광고 게재위치가 생성되면 광고 게재위치 ID를 기록해 둡니다.

폭포

광고 형식광고 게재위치 이름을 선택하고, 가격 책정 유형으로 글로벌 CPM을 선택합니다. 나머지 양식을 작성하고 제출을 클릭합니다.

광고 게재위치가 생성되면 광고 게재위치 ID를 기록해 둡니다.

Pangle Reporting API 키 찾기

입찰

입찰 통합에는 이 단계가 필요하지 않습니다.

폭포

페이지 왼쪽 하단의 사용자 ID를 기록합니다.

통합 > SDK 및 API > Pangle Reporting API 2.0을 클릭합니다. 역할 ID보안 키를 기록해 둡니다.

테스트 모드 사용 설정

Pangle 테스트 광고를 사용 설정하는 방법에 관한 Pangle의 테스트 광고 추가 방법 가이드에 나온 안내를 따르세요.

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

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

  • 프로젝트의 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(입찰) 및 Pangle(폭포식 구조) 광고 소스를 사용하여 광고 검사기에서 단일 광고 소스 테스트를 사용 설정하세요.

선택적 단계

네이티브 광고

광고 렌더링

Pangle 어댑터는 네이티브 광고를 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.3.0.8.0

  • Pangle SDK 버전 6.3.0.8과의 호환성을 확인했습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 11.11.0
  • Pangle SDK 버전 6.3.0.8

버전 6.3.0.6.0

  • Pangle SDK 버전 6.3.0.6과의 호환성을 확인했습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 11.11.0
  • Pangle SDK 버전 6.3.0.6

버전 6.2.0.9.0

  • Pangle SDK 버전 6.2.0.9와의 호환성을 확인했습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 11.10.0.
  • Pangle SDK 버전 6.2.0.9

버전 6.2.0.8.0

  • Pangle SDK 버전 6.2.0.8과의 호환성을 확인했습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 11.10.0.
  • Pangle SDK 버전 6.2.0.8.

버전 6.2.0.7.0

  • Pangle SDK 버전 6.2.0.7과의 호환성을 확인했습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 11.8.0
  • Pangle SDK 버전 6.2.0.7

버전 6.2.0.6.0

  • Pangle SDK 버전 6.2.0.6과의 호환성을 확인했습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 11.8.0
  • Pangle SDK 버전 6.2.0.6

버전 6.2.0.5.0

  • Pangle SDK 버전 6.2.0.5와의 호환성 확인

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 11.8.0.
  • Pangle SDK 버전 6.2.0.5

버전 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

  • GADPangleNetworkExtrasGADAdNetworkExtras 프로토콜을 준수하지 않는 문제를 수정했습니다.
  • 전면 광고, 보상형 광고, 앱 오프닝 광고에 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

  • GADMediationAdapterPangle 클래스의 setGDPR()setCCPA() 메서드 이름을 각각 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