설치와 설정

EasterAd Unity SDK(com.easterad.easterad)는 게임 월드 속 3D 오브젝트나 2D UI에 광고를 자연스럽게 결합할 수 있도록 지원하는 인게임 광고 SDK입니다. 별도의 복잡한 초기화 코드 없이 에디터 설정만으로 씬 로드 시 자동 초기화되며, 개발 중에는 테스트 세션을 통해 라이브 환경에 영향을 주지 않고 안전하게 검증할 수 있습니다.

1. 사전 요구사항

설치를 진행하기 전에 개발 환경과 라이브 지원 환경을 확인하세요.

구분	요구사항 및 지원 범위
Unity 엔진	Unity 6000.0 이상 (검증 권장 버전: `6000.3.11f1`)
라이브 송출 플랫폼	Windows 독립 실행형 플레이어를 정식 지원합니다. ※ 모바일(Android/iOS)은 별도 연결 모듈 통합으로 연동하며, 기타 플랫폼은 지원 매트릭스를 참고하세요.
개발/테스트 환경	Unity 에디터(Play Mode)에서는 SDK 키 없이도 테스트 세션으로 동작하여 자유롭게 연동을 검증할 수 있습니다.
필수 발급 정보	EasterAd 패키지 Git URL(버전 고정 태그) 및 테스트 식별자(Game ID, 테스트 광고 단위 ID)

2. SDK 설치 (Package Manager)

Unity Package Manager의 Git URL 추가 기능을 통해 설치하는 것을 권장합니다.

Unity 에디터 상단 메뉴에서 Window > Package Manager를 엽니다.
창 좌측 상단의 + 버튼 > Add package from git URL…을 선택합니다.
EasterAd에서 전달받은 Git URL과 버전 태그(예: https://github.com/...#v2.0.0)를 입력하고 Add를 클릭합니다.

flowchart LR
    A["Package Manager 열기"] --> B["Git URL / 패키지 추가"]
    B --> C["Window > EasterAd 메뉴 확인"]
    C --> D["StreamingAssets 설정 생성"]

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

설치가 완료되면 대시보드와 게임을 연결하는 기본 설정을 진행합니다.

상단 메뉴에서 Window > EasterAd를 엽니다.
Enable SDK를 체크하여 활성화합니다.
대시보드와 연동할 식별자를 입력합니다:
- Game ID: 대시보드 게임 상세 화면에서 발급받은 고유 식별자(Game ID)를 입력합니다.
- SDK Key:
  - 개발 및 검증 단계: 입력란을 비워 둡니다. SDK 키가 없으면 자동으로 테스트 세션으로 동작하므로, 안전하게 광고 요청 및 렌더링을 테스트할 수 있습니다.
  - 라이브 출시 단계: 게임의 플랫폼 심사가 승인된 후, 대시보드에서 발급받은 SDK 키를 입력합니다. 라이브 세션은 승인된 플랫폼(Windows 등)에서만 열립니다.

설정 파일 저장 위치 (`StreamingAssets`)

설정 창에서 입력한 내용은 프로젝트의 Assets/StreamingAssets/EasterAd_Config.txt 파일에 저장되어 빌드 바이너리에 자동으로 포함됩니다.

4. 초기화 메커니즘

EasterAd Unity SDK는 개발 편의를 위해 완전 자동 초기화(Auto-Initialization) 방식을 채택하고 있습니다.

자동 실행: Window > EasterAd에서 SDK를 활성화해 두면, 첫 씬이 로드될 때 SDK 싱글톤이 자동으로 초기화 절차를 시작합니다. 별도의 Init() 코드를 수동으로 호출할 필요가 없습니다.
오브젝트 자동 큐잉: SDK 초기화가 완료되기 전에 씬에 배치된 광고 컴포넌트(Item)가 생성되더라도 오류가 발생하지 않습니다. 컴포넌트는 내부 큐에서 대기하다가 SDK 초기화가 완료되는 즉시 자동으로 처리됩니다.
수동 제어 확인 플래그: 스크립트에서 동적으로 광고 컴포넌트를 조작하거나 요청을 제어해야 한다면, EasterAdSdk.OnceInitialized 플래그가 true인지 확인하세요.

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

연동을 시작하기 전, SDK 패키지에 포함된 공식 샘플 씬을 활용해 에디터 작동을 먼저 검증하세요.

Package Manager에서 EasterAd 패키지를 선택하고 Samples 탭을 엽니다.
EasterAd Customer Showcase 옆의 Import 버튼을 클릭합니다.
Assets/Samples/.../EasterAdCustomerShowcase.unity 씬을 엽니다.
샘플 씬은 의도치 않은 광고 호출을 방지하기 위해 자동 로드가 꺼져 있고 Ad Unit ID가 비어 있습니다.
인스펙터 또는 UI 필드에 사전에 발급받은 테스트 광고 단위 ID 2개(3D Plane용 1개, 2D Canvas용 1개)를 각각 입력합니다.
Unity Play 버튼을 누른 뒤, Load 3D Plane 및 Load Canvas Item 버튼을 클릭하여 각 지면에 광고가 정상적으로 표시되는지 확인합니다.

다음 단계

광고 단위 배치하기 (3D Plane & 2D Canvas): 씬의 3D 오브젝트나 UI에 지면을 배치하고 연결하는 방법을 알아봅니다.
라이프사이클과 결과 처리: 광고 로드 상태 흐름, NoFill 처리, 클릭 상호작용 및 진단 이벤트를 다룹니다.