Ads Unified Platform 공용 API 사용하여 새 Unity Dashboard 마이그레이션
관리 API (legacy) 통합을 Ads Unified Platform 공용 API로 마이그레이션하여 프로그래밍 기능을 잃지 않고 새로운 Unity Dashboard로 프로덕션 계정을 이동할 수 있습니다.
읽는 시간 9분최근 업데이트: 한 달 전
Ads Unified Platform 공용 API 최신 버전의 관리 API레거시. 지원되는 경로 통해 이전 Unity Dashboard 경험지원 사용 중단 예정 예정)에서 사용 중인 프로그래밍 기능을 잃지 않고 새 Unity Dashboard 마이그레이션할 수 있습니다.
마이그레이션은 고객이 시작합니다. Unity 마이그레이션을 요청하는 지원 티켓을 제출하기 전까지 조직을 New Unity Dashboard 이동하지 않습니다. 관리 API레거시는 그 때까지 조직에서 계속 작동하며, 모든 조직이 마이그레이션될 때까지 Unity 전체 플랫폼에서 API 지원을 중단하지 않습니다.
관리 API레거시를 사용하여 프로그래밍 방식으로 엔드포인트를 관리하는 경우 새 Unity Dashboard 이동하기 전에 Ads Unified Platform 공용 API 업데이트하십시오. 다음 표에는 수익화 및 사용자 확보 고객을 위한 엔드포인트 업데이트가 자세히 나와 있습니다.
사용자 유형 | Dashboard | 관리되는 엔드포인트 |
|---|---|---|
| 퍼블리셔 | 수익화 |
|
| 광고주 | UA |
|
중요
마이그레이션 요청을 제출하고 조직이 마이그레이션되면 관리 API(레거시)가 조직에서 즉시 작동을 중지합니다. 단가 또는 플레이스먼트 조정과 같은 관리 API레거시 빌드된 자동화 또는 지속적인 최적화에 의존하는 경우 마이그레이션을 요청하기 전에 Ads Unified Platform 공용 API 업데이트하십시오. 그렇지 않으면 조직이 New Unity Dashboard 이동하면 이러한 자동화가 작동을 멈추고 매출 영향을 줄 수 있습니다.
Unified Platform 공용 API 사용하여 새로운 Unity Dashboard 마이그레이션하려면 다음 워크플로를 완료하십시오.
Workflow | 단계 |
|---|---|
| 시험 및 확인 |
|
마이그레이션 요청 및 설정 중요 마이그레이션을 시작하기 전에 테스트 및 확인 워크플로 완료해야 합니다. |
|
마이그레이션된 API 통합 테스트 및 검증
새로운 대시보드 경험 마이그레이션하기 전에 테스트 조직, 서비스 계정 및 API 키를 생성합니다. 이 테스트 환경을 사용하여 새 대시보드 경험 API 통합 기능을 올바르게 검증합니다.
필수 조건
Ads Unified Platform 공용 API 시작하기 전에 팀원이 Unity 대시보드에서 대시보드의 조직 역할을 수행해야 합니다.
사용자 확보 엔드포인트를 사용하려면 사용자 확보 대시보드의 관리자 역할을 사용해야 합니다.
마이그레이션된 API 통합 테스트
Create a test organization
레거시 Unity Dashboard에서 Ads Unified Platform 공용 API 통합을 테스트하기 위한 새로운 조직을 생성하려면 다음을 수행하십시오.
- 대시보드 상단 내비게이션 현재 조직을 선택한 다음 Switch organization > + New를 선택합니다.
- 테스트 조직의 조직 이름을 입력합니다.
- 조직 유형을 선택하고 자격 증명을 입력합니다.
- Create를 클릭합니다.
Create a test service account
레거시 Unity Dashboard에서 서비스 계정을 생성하여 API 호출을 인증합니다.
Preresuisites
Ads Unified Platform 공용 API 시작하기 전에 팀원이 Unity 대시보드에서 대시보드의 조직 역할을 수행해야 합니다.
레거시 Unity Dashboard 서비스 계정을 생성하려면 다음을 수행합니다.
테스트 서비스 계정을 생성하고 광고주별 역할을 추가하려면 다음을 수행합니다.
- 대시보드 상단 내비게이션 계정의 현재 조직 >** Manage organization**을 선택하여 Organization Settings 페이지를 엽니다.
- 왼쪽 내비게이션 관리 > Organization > Service Accounts로 이동합니다.
- + New를 선택하여 테스트 서비스 계정을 생성합니다.
- 테스트 서비스 계정 이름과 설명을 입력한 다음 Create를 클릭합니다.
- 생성한 테스트 서비스 계정 페이지에서 Organization roles 섹션 > + organization roles 관리로 이동합니다.
- 조직 역할 다이얼로그 Grow 드롭다운으로 이동한 다음 서비스 계정에 추가할 리스트의 모든 Advertise API 역할을 선택합니다.
Generate an API key for your test organziation
서비스 계정을 생성한 후 API 키를 생성하여 Unity Dashboard 테스트 서비스 계정에 대한 요청을 인증.
API 키를 생성하려면 다음 단계를 따르십시오.
- 새 서비스 계정의 Keys 섹션 이동합니다.
- + Add key를 선택하여 API 키를 만듭니다. 이 키는 테스트 조직의 요청을 인증합니다.
중요
비밀 키는 대시보드에 한 번만 표시되므로 키 ID와 비밀을 나중에 레퍼런스 수 있도록 함께 안전하게 저장합니다. 키 값을 잃으면 새 키를 생성해야 합니다.
- Done을 선택합니다.
Validate your Ads Unified Platform public API integration
서비스 계정을 생성하고 API 키를 생성한 후 테스트 조직에서 기존의 관리 API레거시) 워크플로를 리플리케이트, 모사하다 Ads Unified Platform 공용 API 현재 워크플로를 지원하는지 확인합니다.
참고
Ads Unified Platform 공용 API 입찰 플레이스먼트만 지원합니다. 워터폴 플레이스먼트는 지원 사용 중단 예정 예정입니다. 현재 연동이 워터폴 플레이스먼트를 관리하는 경우에는 입찰로 전환 합니다.
또는 Unity Ads가 유일한 광고 제공업체인 경우 Unity Ads에서 레벨플레이로 마이그레이션하십시오. Mediation 스택의 일부로 Unity Ads를 사용하는 경우 Unity Ads를 입찰자로 설정합니다.
가능한 경우 테스트 조직 내에서 현재 프로덕션 설정 및 구성을 복제합니다(앱, 플레이스먼트 및 캠페인 포함). 라이브 환경을 미러링하면 패리티 더 쉽게 확인할 수 있으므로 마이그레이션하기 전에 문제를 결정 수 있습니다.
LLM 코딩 에이전트 사용하여 마이그레이션을 지원하는 경우 다음 코딩 에이전트 가이드를 참고하십시오.
LLM 레퍼런스 | 마이그레이션 경로 |
|---|---|
| 퍼블리셔 공용 API LLM 레퍼런스 | |
| 광고 공용 API LLM 레퍼런스 | |
사용 사례를 올바르게 맵 다음 공용 API 레퍼런스 참고하십시오.
- 퍼블리셔: 광고 통합 플랫폼 퍼블리셔 공용 API
- 광고주: 광고 통합 플랫폼 광고주 공용 API
API 마이그레이션 요청 및 설정
API 통합을 확인한 후 새 Unity Dashboard 마이그레이션을 요청할 수 있습니다.
필수 조건
프로덕션 계정을 마이그레이션하기 전에 Ads Unified Platform 공개 API 통합을 확인해야 합니다.
Request migration to the New Unity Dashboard
테스트를 완료한 후 프로덕션 계정을 New Unity Dashboard 마이그레이션합니다. 프로덕션 계정 마이그레이션은 기존 설정예: 앱, 플레이스먼트, 캠페인 및 기타 엔드포인트)과 과거 데이터를 새로운 Unity Dashboard 이동합니다.
Unity Ads 지원 팀은 프로덕션 계정의 New Unity Dashboard 마이그레이션을 감독하고 관리합니다. 마이그레이션을 시작할 준비가 되면 마이그레이션 요청을 시작할 티켓을 제출합니다.
Prerequisites
프로덕션 계정을 마이그레이션하기 전에 Ads Unified Platform 공용 API 통합을 검증 해야 합니다.
Submit a migration request ticket
Unity Ads 지원 팀에 마이그레이션 요청 티켓을 제출하려면 새로운 Unity Dashboard에서 다음 단계를 따르십시오.
중요
마이그레이션은 되돌릴 수 없습니다. 마이그레이션이 완료되면 관리 API레거시 즉시 작동을 멈추고 통합이 Ads Unified Platform 공용 API 사용하기 전까지 모든 자동화 또는 최적화가 중지됩니다. 광고 게재는 영향을 받지 않습니다.
- Unity 지원 포털으로 이동합니다.
- **Migrate to the New Dashboard 경험 티켓 타입을 선택합니다.
- 이름, 조직 ID, 조직 역할(소유자 여부)을 포함한 필수 정보를 입력합니다.
- 티켓을 제출합니다.
- 지원 팀에서 마이그레이션 시간과 날짜를 확인합니다. 이 메시지 수신을 확인해야 합니다. 그렇지 않으면 마이그레이션이 진행되지 않습니다.
Complete post-migration configurations
Unity 지원 팀이 마이그레이션을 완료한 후 다음의 마이그레이션 후 설정 작업을 완료해야 합니다.
- 프로덕션 서비스 계정 을 생성합니다.
- 프로덕션 API 키 를 생성합니다.
- 활성 조직의 프로덕션 워크플로에서 API 호출이 작동하는지 확인합니다.
참고
설정을 이전 대시보드로 되돌리는 것은 지원되지 않습니다. 새 API를 사용하여 모든 수정 및 디버깅을 완료합니다.
Create a production service account
마이그레이션 후에는 Ads Unified Platform 공용 API 대해 활성 조직에 대한 새로운 서비스 계정을 생성해야 합니다(테스트 조직에서 생성한 테스트 서비스 계정과 별개). 프로덕션 API 호출에서 새 서비스 계정을 사용하여 검증된 API 워크플로가 실제 조직을 반영하도록 합니다.
새로운 Unity Dashboard용 서비스 계정을 생성하려면 다음 단계를 따르십시오.
사용자 확보 대시보드에서 서비스 계정을 생성하고 광고주별 역할을 추가하려면 다음 단계를 따르십시오.
- 사용자 확보 대시보드 > Settings > Organization > Manage organization > Service accounts > + New로 이동합니다.
- + Manage organization roles를 선택합니다.
- 서비스 계정 이름과 서비스 계정 설명을 입력합니다.
- 생성한 새 서비스 계정 페이지에서 조직 역할 섹션 > + 조직 역할 관리로 이동합니다.
- 조직 역할 다이얼로그 Grow 드롭다운으로 이동한 다음 서비스 계정에 추가할 리스트의 모든 Advertise API 역할을 선택합니다.
Generate a production API key
새 서비스 계정에서 API 키를 생성하여 Unity Dashboard 요청을 인증. 키를 생성하려면 다음 단계를 따르십시오.
- 생성한 새 서비스 계정에서 Keys 섹션 이동합니다.
- + Add key를 선택하여 API 키를 만듭니다. 이렇게 하면 검증된 API 워크플로의 테스트 키와 테스트 서비스 계정이 새 API 키와 라이브 조직에 연결된 새로운 서비스 계정으로 대체됩니다.
중요
비밀 키는 대시보드에 한 번만 표시되므로 키 ID와 비밀을 나중에 레퍼런스 수 있도록 함께 안전하게 저장합니다. 키 값을 잃으면 새 키를 생성해야 합니다.
- Done을 선택합니다.
Confirm API calls work in production
API 호출이 실시간 앱, 플레이스먼트, 캠페인 및 기타 엔드포인트에 대한 올바른 데이터와 응답을 반환하는지 확인합니다. API 키를 교체하는 등 필요한 변경 사항을 적용하여 API 호출이 테스트 조직이 아닌 실제 활성 조직에 부합하도록 합니다.
마이그레이션 후 API 호출에서 공백이나 예기치 않은 동작 발생하면 레거시 API 아닌 새로운 Ads Unified Platform 공용 API 사용하여 이를 디버깅하고 수정하십시오.
참고
설정을 이전 대시보드로 되돌리는 것은 지원되지 않습니다. 새 API를 사용하여 모든 수정 및 디버깅을 완료합니다.
문제를 해결하거나 새 API를 구현하는 데 도움이 필요한 경우 세일즈 담당자 또는 Unity 지원에 문의하십시오.