미디에이션과 ironSource 통합

이 가이드는 Google 모바일 광고 SDK를 사용하여 미디에이션을 통해 ironSource에서 광고를 로드하고 게재하려는 게시자를 대상으로 작성되었습니다. 광고 단위에 미디에이션 구성에 ironSource를 추가하는 방법, 광고 네트워크 최적화를 설정하는 방법, ironSource SDK 및 어댑터를 iOS 앱에 통합하는 방법을 다룹니다.

지원되는 형식 및 기능

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

형식
배너
전면 광고
리워드 제공됨
보상형 전면 광고
네이티브
특성
적응형 배너
광고 네트워크 최적화 (ANO) 자동 데이터 수집

요구사항

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

1단계: ironSource 설정

가입하고 ironSource 계정에 로그인하세요.

애플리케이션을 ironSource 대시보드에 추가하려면 새 앱 버튼을 클릭합니다.

앱 세부정보 입력

모바일 앱을 선택하고 앱의 App Store URL을 입력한 다음 앱 정보 가져오기를 클릭합니다. 앱 정보가 표시되면 앱 추가 버튼을 클릭합니다.

앱을 사용할 수 없는 경우 App Store Live App Application(애플리케이션 스토어에 없음)을 선택하고 앱의 임시 이름을 제공합니다. 플랫폼으로 iOS를 선택하고 앱 추가를 클릭합니다.

앱을 추가한 후 표시되는 새 앱 키를 기록해 둡니다. 이 값은AdMob 광고 단위 ID를 설정할 때 필요합니다. 앱에서 지원하는 광고 형식을 적절한 실시간 탭에서 선택합니다. 그런 다음, 완료를 클릭합니다.

인스턴스 ID

그런 다음 추가한 앱의 네트워크 인스턴스를 구성합니다. ironSource에서는 보상형 광고 및 전면 광고에 여러 네트워크 인스턴스를 지원합니다.

왼쪽 탐색 메뉴에서 광고 단위 및 게재위치 페이지로 이동하여 애플리케이션 목록에서 앱을 선택하고 수정 버튼을 클릭합니다.

네트워크 인스턴스 추가 링크를 선택하고 인스턴스 이름을 입력한 다음 저장을 클릭합니다.

인스턴스가 생성되면 인스턴스 ID 필드에 인스턴스 ID가 표시됩니다.

앱 키인스턴스 ID 외에도AdMob 광고 단위 ID를 설정하려면 ironSource 보안 비밀 키갱신 토큰이 필요합니다.

ironSource 게시자 대시보드에서 내 계정으로 이동한 후 API 탭을 클릭합니다. 보안 비밀 키갱신 토큰을 기록해 둡니다.

2단계: AdMob 광고 단위의 미디에이션 설정 구성하기

광고 단위의 미디에이션 구성에 ironSource를 추가하려면 먼저 AdMob 계정에 로그인하세요.

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

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

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

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

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

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

광고 소스로 ironSource 추가

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

그런 다음 최적화 도구 기능을 사용 설정한 후 이전 섹션에서 가져온 보안 비밀 키갱신 토큰을 입력하여 ironSource의 ANO를 설정합니다. 그런 다음 eCPM 값을 입력하고 계속을 클릭합니다.

이전 섹션에서 가져온 앱 키인스턴스 ID를 입력합니다.

보상형 광고 사용

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

이 설정을 적용하지 않으면 게재위치를 만들 때 ironSource 어댑터에서 ironSource 대시보드에 지정된 보상을 전달합니다.

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

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

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

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

    pod install --repo-update

수동 통합

  • 최신 버전의 ironSource iOS SDK를 다운로드하고 프로젝트에 IronSource.framework을 연결합니다.

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

4단계: 추가 코드 필요

ironSource iOS 통합에는 추가 코드가 필요하지 않습니다.

5단계: 구현 테스트

ironSource에서 테스트 광고를 사용 설정하려면 광고 통합 앱을 실행하고 로그에서 다음과 같은 메시지를 확인하세요.

테스트 기기의 광고 ID입니다. 클립보드에 복사합니다.

MONETIZE 탭으로 이동하여 Testing 버튼을 클릭합니다. 그런 다음 New Test Device 버튼을 클릭합니다.

기기 이름 및 이전 단계에서 가져온 광고 ID를 입력합니다. 그런 다음 저장을 클릭합니다.

새로 추가된 테스트 기기는 테스트 기기 아래에 표시됩니다. 필요에 따라 이 모듈에서 테스트 광고를 활성화하거나 비활성화할 수 있습니다.

선택 단계

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

아래 섹션에서는 ironSource의 개인 맞춤 광고를 사용 설정 또는 중지하는 방법을 설명합니다.

SDK 버전 6.7.9에서 ironSource 동의 동의 API 다음 샘플 코드는 ironSource SDK에서YES에 동의하도록 설정되어 있습니다. 이 메서드를 호출하기로 선택한 경우 Google 모바일 광고 SDK를 통해 광고를 요청하기 전에 호출하는 것이 좋습니다.

#import <IronSource/IronSource.h>
...

[IronSource setConsent:YES];

자세한 내용은 ironSource의 동의 관리 문서를 참고하세요.

오류 코드

어댑터가 ironSource에서 광고를 수신하지 못하면 게시자는 GADResponseInfo.adNetworkInfoArray는 다음 클래스에서 지원됩니다.

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

오류 코드 이유
101 UI에 구성된 AdMob ironSource 서버 매개변수가 누락되었거나 잘못되었습니다.
102 ironSource에 SDK를 초기화하려면 활동 컨텍스트가 필요합니다.
103 ironSource에서는 ironSource 인스턴스 ID당 1개의 광고만 로드할 수 있습니다.
501-1056 ironSource SDK 오류 자세한 내용은 문서를 참조하세요.
101 UI에 구성된 AdMob ironSource 서버 매개변수가 누락되었거나 잘못되었습니다.
102 ironSource 어댑터에서 요청 중인 광고 형식을 지원하지 않습니다.
103 이 네트워크 구성에 대한 ironSource 광고가 이미 로드되었습니다.
508-1037 ironSource SDK 오류 자세한 내용은 문서를 참조하세요.

IronSource iOS 미디에이션 어댑터 변경 로그

버전 7.2.1.2.0

  • ironSource SDK 버전 7.2.1.2와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.2.0
  • IronSource SDK 버전 7.2.1.2

버전 7.2.1.1.0

  • ironSource SDK 버전 7.2.1.1에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.2.0
  • IronSource SDK 버전 7.2.1.1

버전 7.2.1.0

  • ironSource SDK 버전 7.2.1에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.1.0
  • IronSource SDK 버전 7.2.1

버전 7.2.0.0

  • ironSource SDK 버전 7.2.0에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.0.0
  • IronSource SDK 버전 7.2.0

버전 7.1.14.1

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.0.0
  • IronSource SDK 버전 7.1.14

버전 7.1.14.0

  • ironSource SDK 버전 7.1.14와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.13.0
  • IronSource SDK 버전 7.1.14

버전 7.1.13.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.13.0
  • IronSource SDK 버전 7.1.13

버전 7.1.12.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.12.0
  • IronSource SDK 버전 7.1.12

버전 7.1.11.1.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.12.0
  • IronSource SDK 버전 7.1.11.1

버전 7.1.11.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.11.0
  • IronSource SDK 버전 7.1.11

버전 7.1.10.0

  • ironSource SDK 버전 7.1.10과의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.9.0
  • IronSource SDK 버전 7.1.10

버전 7.1.9.0

  • ironSource SDK 버전 7.1.9와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.9.0
  • IronSource SDK 버전 7.1.9

버전 7.1.8.0

  • ironSource SDK 버전 7.1.8과의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.8.0
  • IronSource SDK 버전 7.1.8

버전 7.1.7.0

  • ironSource SDK 버전 7.1.7과 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.7.0
  • IronSource SDK 버전 7.1.7

버전 7.1.6.1.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.5.0
  • IronSource SDK 버전 7.1.6.1

버전 7.1.6.0

  • ironSource SDK 버전 7.1.6에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.5.0
  • IronSource SDK 버전 7.1.6

버전 7.1.5.1.0

  • ironSource SDK 버전 7.1.5.1과의 호환성을 확인했습니다.
  • Google 모바일 광고 SDK 버전 8.0.0 이상에 대한 종속 항목이 완화되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.5.0
  • IronSource SDK 버전 7.1.5.1

버전 7.1.5.0

  • ironSource SDK 버전 7.1.5와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.3.0
  • IronSource SDK 버전 7.1.5

버전 7.1.4.0

  • ironSource SDK 버전 7.1.4와의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 8.3.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.3.0
  • IronSource SDK 버전 7.1.4

버전 7.1.3.0

  • 보상형 전면 광고 지원이 추가되었습니다.
  • ironSource SDK 버전 7.1.3과의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 8.2.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.2.0
  • IronSource SDK 버전 7.1.3

버전 7.1.2.0

  • ironSource SDK 버전 7.1.2와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.1.0
  • IronSource SDK 버전 7.1.2

버전 7.1.1.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.1.0
  • IronSource SDK 버전 7.1.1

버전 7.1.0.1

  • .xcframework 형식을 사용하도록 어댑터를 업데이트했습니다.
  • 이제 Google 모바일 광고 SDK 버전 8.0.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.0.0
  • IronSource SDK 버전 7.1.0

버전 7.1.0.0

  • ironSource SDK 버전 7.1.0에서 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.69.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.69.0
  • IronSource SDK 버전 7.1.0

버전 7.0.4.0

  • ironSource SDK 버전 7.0.4와의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.68.0 이상이 필요합니다.
  • 표준화된 어댑터 오류 코드와 메시지가 추가되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.68.0
  • IronSource SDK 버전 7.0.4

버전 7.0.3.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.66.0
  • IronSource SDK 버전 7.0.3

버전 7.0.2.0

  • ironSource SDK 버전 7.0.2와의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.66.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.66.0
  • IronSource SDK 버전 7.0.2

버전 7.0.1.0

  • ironSource SDK 버전 7.0.1에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.64.0
  • IronSource SDK 버전 7.0.1

버전 7.0.0.0

  • ironSource SDK 버전 7.0.0과의 호환성을 확인했습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.64.0 이상이 필요합니다.
  • 이제 최소 iOS 버전 9.0이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.64.0
  • IronSource SDK 버전 7.0.0

버전 6.18.0.2.0

  • ironSource SDK 버전 6.18.0.2와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.63.0
  • IronSource SDK 버전 6.18.0.2

버전 6.18.0.1.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.63.0
  • IronSource SDK 버전 6.18.0.1

버전 6.18.0.0

  • ironSource SDK 버전 6.18.0에서 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.63.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.63.0
  • IronSource SDK 버전 6.18.0

버전 6.17.0.1.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.62.0
  • IronSource SDK 버전 6.17.0.1

버전 6.17.0.0

  • ironSource SDK 버전 6.17.0에서 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.61.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.61.0
  • IronSource SDK 버전 6.17.0

버전 6.16.3.0

  • ironSource SDK 버전 6.16.3에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.60.0
  • IronSource SDK 버전 6.16.3

버전 6.16.2.0

  • ironSource SDK 버전 6.16.2에서 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.60.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.60.0
  • IronSource SDK 버전 6.16.2

버전 6.16.1.0

  • ironSource SDK 버전 6.16.1에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.58.0
  • IronSource SDK 버전 6.16.1

버전 6.16.0.0

  • ironSource SDK 버전 6.16.0에서 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.58.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.58.0
  • IronSource SDK 버전 6.16.0

버전 6.15.0.1.0

  • ironSource SDK 버전 6.15.0.1에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.57.0
  • IronSource SDK 버전 6.15.0.1

버전 6.15.0.0

  • ironSource SDK 버전 6.15.0에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.57.0
  • IronSource SDK 버전 6.15.0

버전 6.14.0.0

  • ironSource SDK 버전 6.14.0에서 호환성이 확인되었습니다.
  • i386 아키텍처에 대한 지원이 삭제되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.56.0
  • IronSource SDK 버전 6.14.0

버전 6.13.0.1.0

  • ironSource SDK 버전 6.13.0.1과의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.53.1
  • IronSource SDK 버전 6.13.0.1

버전 6.12.0.0

  • ironSource SDK 버전 6.12.0에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.53.1
  • IronSource SDK 버전 6.12.0

버전 6.11.0.0

  • ironSource SDK 버전 6.11.0에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.52.0
  • IronSource SDK 버전 6.11.0

버전 6.8.7.0

  • ironSource SDK 버전 6.8.7에서 호환성이 확인되었습니다.

버전 6.8.6.0

  • ironSource SDK 버전 6.8.6에서 호환성이 확인되었습니다.

버전 6.8.5.0

  • ironSource SDK 버전 6.8.5에서 호환성이 확인되었습니다.

버전 6.8.4.1.0

  • ironSource SDK 버전 6.8.4.1에서 호환성이 확인되었습니다.

버전 6.8.4.1

  • ironSource SDK에 올바른 버전 번호를 전송하기 위한 코드가 추가되었습니다.

버전 6.8.4.0

  • ironSource SDK 버전 6.8.4에서 호환성이 확인되었습니다.

버전 6.8.3.0

  • ironSource SDK 6.8.3과의 호환성이 확인되었습니다.
  • 여러 전면 광고를 요청하는 기능이 추가되었습니다.
  • 보상형 광고 로드 시 발생하는 비정상 종료 문제를 수정합니다.
  • 이 버전의 어댑터에는 버전 7.42.2 이상의 Google 모바일 광고 SDK가 필요합니다.

버전 6.8.0.1

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

버전 6.8.0.0

  • ironSource SDK 6.8.0에서 확인된 호환성

버전 6.7.12.0

  • ironSource SDK 6.7.12와의 확인된 호환성

버전 6.7.11.0

  • ironSource SDK 6.7.11에서 확인된 호환성

버전 6.7.10.0

  • ironSource SDK 6.7.10에서 확인된 호환성

버전 6.7.9.3.1

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

버전 6.7.9.3.0

  • ironSource SDK 6.7.9.3과의 호환성 확인

버전 6.7.9.2.0

  • ironSource SDK 6.7.9.2에서 확인된 호환성

버전 6.7.9.1.0

  • ironSource SDK 6.7.9.1과의 호환성 확인

버전 6.7.8.0

  • ironSource SDK 6.7.8과의 호환성 확인

버전 6.7.7.0

  • IronSource SDK를 광고 단위당 한 번씩 시작합니다.

버전 6.7.5.0

  • 첫 출시
  • 전면 광고 및 보상형 동영상 광고를 지원합니다.
,

이 가이드는 Google 모바일 광고 SDK를 사용하여 미디에이션을 통해 ironSource에서 광고를 로드하고 게재하려는 게시자를 대상으로 작성되었습니다. 광고 단위에 미디에이션 구성에 ironSource를 추가하는 방법, 광고 네트워크 최적화를 설정하는 방법, ironSource SDK 및 어댑터를 iOS 앱에 통합하는 방법을 다룹니다.

지원되는 형식 및 기능

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

형식
배너
전면 광고
리워드 제공됨
보상형 전면 광고
네이티브
특성
적응형 배너
광고 네트워크 최적화 (ANO) 자동 데이터 수집

요구사항

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

1단계: ironSource 설정

가입하고 ironSource 계정에 로그인하세요.

애플리케이션을 ironSource 대시보드에 추가하려면 새 앱 버튼을 클릭합니다.

앱 세부정보 입력

모바일 앱을 선택하고 앱의 App Store URL을 입력한 다음 앱 정보 가져오기를 클릭합니다. 앱 정보가 표시되면 앱 추가 버튼을 클릭합니다.

앱을 사용할 수 없는 경우 App Store Live App Application(애플리케이션 스토어에 없음)을 선택하고 앱의 임시 이름을 제공합니다. 플랫폼으로 iOS를 선택하고 앱 추가를 클릭합니다.

앱을 추가한 후 표시되는 새 앱 키를 기록해 둡니다. 이 값은AdMob 광고 단위 ID를 설정할 때 필요합니다. 앱에서 지원하는 광고 형식을 적절한 실시간 탭에서 선택합니다. 그런 다음, 완료를 클릭합니다.

인스턴스 ID

그런 다음 추가한 앱의 네트워크 인스턴스를 구성합니다. ironSource에서는 보상형 광고 및 전면 광고에 여러 네트워크 인스턴스를 지원합니다.

왼쪽 탐색 메뉴에서 광고 단위 및 게재위치 페이지로 이동하여 애플리케이션 목록에서 앱을 선택하고 수정 버튼을 클릭합니다.

네트워크 인스턴스 추가 링크를 선택하고 인스턴스 이름을 입력한 다음 저장을 클릭합니다.

인스턴스가 생성되면 인스턴스 ID 필드에 인스턴스 ID가 표시됩니다.

앱 키인스턴스 ID 외에도AdMob 광고 단위 ID를 설정하려면 ironSource 보안 비밀 키갱신 토큰이 필요합니다.

ironSource 게시자 대시보드에서 내 계정으로 이동한 후 API 탭을 클릭합니다. 보안 비밀 키갱신 토큰을 기록해 둡니다.

2단계: AdMob 광고 단위의 미디에이션 설정 구성하기

광고 단위의 미디에이션 구성에 ironSource를 추가하려면 먼저 AdMob 계정에 로그인하세요.

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

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

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

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

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

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

광고 소스로 ironSource 추가

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

그런 다음 최적화 도구 기능을 사용 설정한 후 이전 섹션에서 가져온 보안 비밀 키갱신 토큰을 입력하여 ironSource의 ANO를 설정합니다. 그런 다음 eCPM 값을 입력하고 계속을 클릭합니다.

이전 섹션에서 가져온 앱 키인스턴스 ID를 입력합니다.

보상형 광고 사용

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

이 설정을 적용하지 않으면 게재위치를 만들 때 ironSource 어댑터에서 ironSource 대시보드에 지정된 보상을 전달합니다.

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

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

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

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

    pod install --repo-update

수동 통합

  • 최신 버전의 ironSource iOS SDK를 다운로드하고 프로젝트에 IronSource.framework을 연결합니다.

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

4단계: 추가 코드 필요

ironSource iOS 통합에는 추가 코드가 필요하지 않습니다.

5단계: 구현 테스트

ironSource에서 테스트 광고를 사용 설정하려면 광고 통합 앱을 실행하고 로그에서 다음과 같은 메시지를 확인하세요.

테스트 기기의 광고 ID입니다. 클립보드에 복사합니다.

MONETIZE 탭으로 이동하여 Testing 버튼을 클릭합니다. 그런 다음 New Test Device 버튼을 클릭합니다.

기기 이름 및 이전 단계에서 가져온 광고 ID를 입력합니다. 그런 다음 저장을 클릭합니다.

새로 추가된 테스트 기기는 테스트 기기 아래에 표시됩니다. 필요에 따라 이 모듈에서 테스트 광고를 활성화하거나 비활성화할 수 있습니다.

선택 단계

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

아래 섹션에서는 ironSource의 개인 맞춤 광고를 사용 설정 또는 중지하는 방법을 설명합니다.

SDK 버전 6.7.9에서 ironSource 동의 동의 API 다음 샘플 코드는 ironSource SDK에서YES에 동의하도록 설정되어 있습니다. 이 메서드를 호출하기로 선택한 경우 Google 모바일 광고 SDK를 통해 광고를 요청하기 전에 호출하는 것이 좋습니다.

#import <IronSource/IronSource.h>
...

[IronSource setConsent:YES];

자세한 내용은 ironSource의 동의 관리 문서를 참고하세요.

오류 코드

어댑터가 ironSource에서 광고를 수신하지 못하면 게시자는 GADResponseInfo.adNetworkInfoArray는 다음 클래스에서 지원됩니다.

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

오류 코드 이유
101 UI에 구성된 AdMob ironSource 서버 매개변수가 누락되었거나 잘못되었습니다.
102 ironSource에 SDK를 초기화하려면 활동 컨텍스트가 필요합니다.
103 ironSource에서는 ironSource 인스턴스 ID당 1개의 광고만 로드할 수 있습니다.
501-1056 ironSource SDK 오류 자세한 내용은 문서를 참조하세요.
101 UI에 구성된 AdMob ironSource 서버 매개변수가 누락되었거나 잘못되었습니다.
102 ironSource 어댑터에서 요청 중인 광고 형식을 지원하지 않습니다.
103 이 네트워크 구성에 대한 ironSource 광고가 이미 로드되었습니다.
508-1037 ironSource SDK 오류 자세한 내용은 문서를 참조하세요.

IronSource iOS 미디에이션 어댑터 변경 로그

버전 7.2.1.2.0

  • ironSource SDK 버전 7.2.1.2와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.2.0
  • IronSource SDK 버전 7.2.1.2

버전 7.2.1.1.0

  • ironSource SDK 버전 7.2.1.1에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.2.0
  • IronSource SDK 버전 7.2.1.1

버전 7.2.1.0

  • ironSource SDK 버전 7.2.1에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.1.0
  • IronSource SDK 버전 7.2.1

버전 7.2.0.0

  • ironSource SDK 버전 7.2.0에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.0.0
  • IronSource SDK 버전 7.2.0

버전 7.1.14.1

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.0.0
  • IronSource SDK 버전 7.1.14

버전 7.1.14.0

  • ironSource SDK 버전 7.1.14와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.13.0
  • IronSource SDK 버전 7.1.14

버전 7.1.13.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.13.0
  • IronSource SDK 버전 7.1.13

버전 7.1.12.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.12.0
  • IronSource SDK 버전 7.1.12

버전 7.1.11.1.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.12.0
  • IronSource SDK 버전 7.1.11.1

버전 7.1.11.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.11.0
  • IronSource SDK 버전 7.1.11

버전 7.1.10.0

  • ironSource SDK 버전 7.1.10과의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.9.0
  • IronSource SDK 버전 7.1.10

버전 7.1.9.0

  • ironSource SDK 버전 7.1.9와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.9.0
  • IronSource SDK 버전 7.1.9

버전 7.1.8.0

  • ironSource SDK 버전 7.1.8과의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.8.0
  • IronSource SDK 버전 7.1.8

버전 7.1.7.0

  • ironSource SDK 버전 7.1.7과 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.7.0
  • IronSource SDK 버전 7.1.7

버전 7.1.6.1.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.5.0
  • IronSource SDK 버전 7.1.6.1

버전 7.1.6.0

  • ironSource SDK 버전 7.1.6에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.5.0
  • IronSource SDK 버전 7.1.6

버전 7.1.5.1.0

  • ironSource SDK 버전 7.1.5.1과의 호환성을 확인했습니다.
  • Google 모바일 광고 SDK 버전 8.0.0 이상에 대한 종속 항목이 완화되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.5.0
  • IronSource SDK 버전 7.1.5.1

버전 7.1.5.0

  • ironSource SDK 버전 7.1.5와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.3.0
  • IronSource SDK 버전 7.1.5

버전 7.1.4.0

  • ironSource SDK 버전 7.1.4와의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 8.3.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.3.0
  • IronSource SDK 버전 7.1.4

버전 7.1.3.0

  • 보상형 전면 광고 지원이 추가되었습니다.
  • ironSource SDK 버전 7.1.3과의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 8.2.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.2.0
  • IronSource SDK 버전 7.1.3

버전 7.1.2.0

  • ironSource SDK 버전 7.1.2와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.1.0
  • IronSource SDK 버전 7.1.2

버전 7.1.1.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.1.0
  • IronSource SDK 버전 7.1.1

버전 7.1.0.1

  • .xcframework 형식을 사용하도록 어댑터를 업데이트했습니다.
  • 이제 Google 모바일 광고 SDK 버전 8.0.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 8.0.0
  • IronSource SDK 버전 7.1.0

버전 7.1.0.0

  • ironSource SDK 버전 7.1.0에서 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.69.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.69.0
  • IronSource SDK 버전 7.1.0

버전 7.0.4.0

  • ironSource SDK 버전 7.0.4와의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.68.0 이상이 필요합니다.
  • 표준화된 어댑터 오류 코드와 메시지가 추가되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.68.0
  • IronSource SDK 버전 7.0.4

버전 7.0.3.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.66.0
  • IronSource SDK 버전 7.0.3

버전 7.0.2.0

  • ironSource SDK 버전 7.0.2와의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.66.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.66.0
  • IronSource SDK 버전 7.0.2

버전 7.0.1.0

  • ironSource SDK 버전 7.0.1에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.64.0
  • IronSource SDK 버전 7.0.1

버전 7.0.0.0

  • ironSource SDK 버전 7.0.0과의 호환성을 확인했습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.64.0 이상이 필요합니다.
  • 이제 최소 iOS 버전 9.0이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.64.0
  • IronSource SDK 버전 7.0.0

버전 6.18.0.2.0

  • ironSource SDK 버전 6.18.0.2와의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.63.0
  • IronSource SDK 버전 6.18.0.2

버전 6.18.0.1.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.63.0
  • IronSource SDK 버전 6.18.0.1

버전 6.18.0.0

  • ironSource SDK 버전 6.18.0에서 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.63.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.63.0
  • IronSource SDK 버전 6.18.0

버전 6.17.0.1.0

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

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.62.0
  • IronSource SDK 버전 6.17.0.1

버전 6.17.0.0

  • ironSource SDK 버전 6.17.0에서 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.61.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.61.0
  • IronSource SDK 버전 6.17.0

버전 6.16.3.0

  • ironSource SDK 버전 6.16.3에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.60.0
  • IronSource SDK 버전 6.16.3

버전 6.16.2.0

  • ironSource SDK 버전 6.16.2에서 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.60.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.60.0
  • IronSource SDK 버전 6.16.2

버전 6.16.1.0

  • ironSource SDK 버전 6.16.1에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.58.0
  • IronSource SDK 버전 6.16.1

버전 6.16.0.0

  • ironSource SDK 버전 6.16.0에서 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.58.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.58.0
  • IronSource SDK 버전 6.16.0

버전 6.15.0.1.0

  • ironSource SDK 버전 6.15.0.1에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.57.0
  • IronSource SDK 버전 6.15.0.1

버전 6.15.0.0

  • ironSource SDK 버전 6.15.0에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.57.0
  • IronSource SDK 버전 6.15.0

버전 6.14.0.0

  • ironSource SDK 버전 6.14.0에서 호환성이 확인되었습니다.
  • i386 아키텍처에 대한 지원이 삭제되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.56.0
  • IronSource SDK 버전 6.14.0

버전 6.13.0.1.0

  • ironSource SDK 버전 6.13.0.1과의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.53.1
  • IronSource SDK 버전 6.13.0.1

버전 6.12.0.0

  • ironSource SDK 버전 6.12.0에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.53.1
  • IronSource SDK 버전 6.12.0

버전 6.11.0.0

  • ironSource SDK 버전 6.11.0에서 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 7.52.0
  • IronSource SDK 버전 6.11.0

버전 6.8.7.0

  • ironSource SDK 버전 6.8.7에서 호환성이 확인되었습니다.

버전 6.8.6.0

  • ironSource SDK 버전 6.8.6에서 호환성이 확인되었습니다.

버전 6.8.5.0

  • ironSource SDK 버전 6.8.5에서 호환성이 확인되었습니다.

버전 6.8.4.1.0

  • ironSource SDK 버전 6.8.4.1에서 호환성이 확인되었습니다.

버전 6.8.4.1

  • ironSource SDK에 올바른 버전 번호를 전송하기 위한 코드가 추가되었습니다.

버전 6.8.4.0

  • ironSource SDK 버전 6.8.4에서 호환성이 확인되었습니다.

버전 6.8.3.0

  • ironSource SDK 6.8.3과의 호환성이 확인되었습니다.
  • 여러 전면 광고를 요청하는 기능이 추가되었습니다.
  • 보상형 광고 로드 시 발생하는 비정상 종료 문제를 수정합니다.
  • 이 버전의 어댑터에는 버전 7.42.2 이상의 Google 모바일 광고 SDK가 필요합니다.

버전 6.8.0.1

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

버전 6.8.0.0

  • ironSource SDK 6.8.0에서 확인된 호환성

버전 6.7.12.0

  • ironSource SDK 6.7.12와의 확인된 호환성

버전 6.7.11.0

  • ironSource SDK 6.7.11에서 확인된 호환성

버전 6.7.10.0

  • ironSource SDK 6.7.10에서 확인된 호환성

버전 6.7.9.3.1

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

버전 6.7.9.3.0

  • ironSource SDK 6.7.9.3과의 호환성 확인

버전 6.7.9.2.0

  • ironSource SDK 6.7.9.2에서 확인된 호환성

버전 6.7.9.1.0

  • ironSource SDK 6.7.9.1과의 호환성 확인

버전 6.7.8.0

  • ironSource SDK 6.7.8과의 호환성 확인

버전 6.7.7.0

  • IronSource SDK를 광고 단위당 한 번씩 시작합니다.

버전 6.7.5.0

  • 첫 출시
  • 전면 광고 및 보상형 동영상 광고를 지원합니다.