콘텐츠로 이동
EasterAdEasterAdDocs

설치와 설정

EasterAd Unity SDK(com.easterad.easterad)로 게임의 3D 표면과 2D UI에 광고를 표시합니다. SDK를 설치하고 테스트 세션으로 배치를 확인합니다.

1. 사전 요구사항

섹션 제목: “1. 사전 요구사항”

설치 전 개발 환경과 라이브 지원 환경을 확인합니다.

구분 요구사항 및 지원 범위
Unity 엔진 Unity 6000.0 이상 (검증 권장 버전: 6000.3.11f1)
라이브 송출 플랫폼 Windows 독립 실행형 플레이어를 정식 지원합니다.
※ 모바일(Android/iOS)은 별도 연결 모듈 통합으로 연동합니다.
개발/테스트 환경 Unity 에디터(Play Mode)에서 SDK 키를 생략해 테스트합니다.
필수 발급 정보 버전이 2.0.0으로 고정된 EasterAd 패키지 Git URL 및 테스트 식별자(Game ID, 테스트 광고 단위 ID)

2. SDK 설치 (Package Manager)

섹션 제목: “2. SDK 설치 (Package Manager)”

문의하기로 설치 Git URL과 저장소 접근 권한을 받은 뒤 Unity Package Manager에서 설치합니다.

  1. Unity 에디터 상단 메뉴에서 Window > Package Manager를 선택합니다.
  2. 창 좌측 상단의 + 버튼 > Add package from git URL…을 선택합니다.
  3. EasterAd에서 받은 2.0.0 설치용 Git URL을 입력하고 Add를 선택합니다.

3. SDK 활성화 및 자격증명 설정

섹션 제목: “3. SDK 활성화 및 자격증명 설정”

대시보드와 게임을 연결하는 기본 설정을 진행합니다.

  1. 상단 메뉴에서 Window > EasterAd를 선택합니다.
  2. Enable SDK를 선택하여 활성화합니다.
  3. 대시보드와 연동할 식별자를 입력합니다:
    • Game ID: 대시보드 게임 상세 화면에서 발급받은 Game ID를 입력합니다.
    • SDK Key:
      • 개발 및 검증 단계: 입력란을 비워 둡니다. SDK 키가 없으면 자동으로 테스트 세션으로 동작합니다.
      • 라이브 출시 단계: 게임 플랫폼 심사 승인 후 대시보드에서 발급받은 게임별 SDK 키를 입력합니다. 라이브 세션은 승인된 플랫폼(Windows 등)에서만 열립니다.

4. 초기화 완료 확인하기

섹션 제목: “4. 초기화 완료 확인하기”

게임을 실행하고 광고 컴포넌트를 스크립트로 제어하기 전에 EasterAdSdk.OnceInitialized가 true인지 확인합니다.

5. Showcase 샘플 씬으로 사전 검증

섹션 제목: “5. Showcase 샘플 씬으로 사전 검증”

공식 샘플 씬을 활용해 에디터 작동을 검증합니다.

  1. Package Manager에서 EasterAd 패키지를 선택하고 Samples 탭을 엽니다.
  2. EasterAd Customer Showcase 옆의 Import를 선택합니다.
  3. Assets/Samples 아래에 가져온 EasterAd 샘플 폴더에서 EasterAdCustomerShowcase.unity 씬을 엽니다.
  4. 인스펙터 또는 UI 필드에 사전에 발급받은 테스트 광고 단위 ID 2개(3D Plane용 1개, 2D Canvas용 1개)를 각각 입력합니다.
  5. Unity 재생(Play) 버튼을 누른 뒤 Load 3D Plane 및 Load Canvas Item 버튼을 눌러 각 지면에 광고가 정상적으로 표시되는지 확인합니다.

다음 단계

섹션 제목: “다음 단계”