가이드

Unity Ads 연결

Unity Ads 연결

Unity Ads 를 연결하면 AI 가 앱 설치 캠페인의 설치·지출·CPI·D7 ROAS·리텐션 을 분석하고, 승인을 받아 캠페인 일시정지·재개, 국가별 입찰·예산 변경, 캠페인·크리에이티브 팩 만들기, 소재 업로드 까지 합니다.

준비물: Unity Cloud 조직의 서비스 계정 키(Key ID · Secret key) 와 Organization ID. 서비스 계정은 조직 관리 권한이 있는 계정(Owner 등)이 만듭니다. 약 3분 걸립니다.

1. 조직 관리 화면 열기

cloud.unity.com 에 로그인한 뒤 홈에서 시작합니다.

unity-1-home.png
Unity Cloud 대시보드 홈 — Manage organization

2. Organization ID 복사하기

Administration 의 Settings 에 조직 ID 가 숫자로 보입니다. 뉴로 연결 창의 Organization core ID 칸에 넣을 값입니다.

unity-2-org-id.png
Administration › Settings — Organization ID

3. 서비스 계정 만들기

뉴로 전용 서비스 계정을 하나 만듭니다. 사람 계정과 달리 비밀번호 없이 키로만 들어옵니다.

unity-3-service-accounts.png
Administration › Service accounts — + New
unity-4-create-account.png
Create service account — 이름 정하고 Create

4. 역할 2개 주기

역할이 없으면 키가 맞아도 모든 요청이 거부됩니다(403). Organization roles 에서 User Acquisition 분류의 역할을 줍니다.

unity-5-roles-open.png
서비스 계정 화면 — + Manage organization roles
unity-6-roles-pick.png
Edit roles in organization — User Acquisition 에서 역할 2개 고르기
unity-7-roles-save.png
고른 역할 확인 후 Save
조회만 쓰려면 Advertise API Admin 대신 Advertise API Viewer 를 고르세요. 그러면 성과 분석은 되고, 캠페인·입찰·예산 변경은 거부됩니다.

5. 키 만들기

같은 서비스 계정 화면에서 키를 만듭니다. Secret key 는 이 창에서 한 번만 보입니다. 닫기 전에 복사하세요.

unity-8-add-key.png
서비스 계정 화면 — Keys 의 + Add key
unity-9-key-created.png
New key has been created — Key ID·Secret key 복사

6. 뉴로에 연결하기

뉴로 워크스페이스의 연동 → Unity Ads 를 열고 세 값을 넣습니다. 뉴로가 Unity 에 키를 확인한 뒤 저장합니다.

neuro-10-connect.png
뉴로 연동 화면의 Unity Ads 연결 창
  • Secret key 는 암호화해서 저장하고, 화면·대화에 다시 보여 주지 않습니다.

  • 워크스페이스당 Unity 조직 1개를 연결합니다. 같은 조직으로 다시 연결하면 키만 바뀝니다.

AI 에게 이렇게 요청하세요

  • “지난 7일 캠페인별 설치 수와 CPI, D7 ROAS 비교해 줘.”

  • “국가별 지출 상위 10개와 CPI 추이를 보여 줘.”

  • “KR 입찰가를 0.9달러로 올려 줘.” — 다른 국가 입찰은 그대로 두고 KR 만 바꿉니다.

  • “CPI 가 3달러 넘는 캠페인 일시정지해 줘.”

변경은 실행 전에 항상 승인 카드가 뜹니다. 금액은 Unity 단위(micros: 1달러 = 1,000,000)로 보내므로 카드의 환산 금액을 확인하세요.

자주 막히는 곳

  • 403 · 권한 없음 — 서비스 계정에 4단계 역할이 없습니다. 역할을 추가하면 다시 연결하지 않아도 바로 됩니다.

  • 리포트만 안 됨 — Advertise Stats API Viewer 가 빠졌습니다.

  • 키가 맞지 않음(401) — Key ID 와 Secret key 를 다시 복사하세요. Secret key 를 잃어버렸다면 키를 새로 만듭니다.

  • 캠페인 관리가 안 되고 리포트만 됨 — 조직이 아직 새 Unity 대시보드(통합 플랫폼)로 옮겨지지 않았습니다. 옮긴 뒤에는 다시 연결하지 않아도 열립니다.

  • 앱을 새로 만들 때 403 — Unity 프로젝트를 같이 만들려 해서입니다. 대시보드 Projects 의 기존 프로젝트를 골라 달라고 AI 에게 말하세요.