Ads 통합 플랫폼 공용 API 시작하기
Ads Unified Platform 공용 API 사용하여 앱, 플레이스먼트 또는 캠페인을 프로그래밍 방식으로 관리할 수 있도록 조직, 서비스 계정, API 키를 설정합니다.
읽는 시간 3분최근 업데이트: 24일 전
Ads Unified Platform 공용 API Unity 수익화 대시보드와 Unity 사용자 확보 대시보드를 위한 최신 버전의 관리 API레거시.
Unity 수익화 또는 사용자 확보 대시보드에서 이미 관리 API(레거시)를 사용 중인 경우 대신 Ads Unified Platform 공용 API를 사용하여 새 Unity Dashboard로 마이그레이션하기를 참고하십시오.
Unity Dashboard에서 앱, 플레이스먼트, 캠페인을 직접 관리할 수 있지만, Ads Unified Platform 공용 API 사용하면 대신 프로그래밍 방식으로 엔드포인트를 관리할 수 있습니다. 다음 표에는 API 사용하여 관리할 수 있는 엔드포인트가 자세히 나와 있습니다.
Dashboard | 관리되는 엔드포인트 | 장점 |
|---|---|---|
| Monetization |
| 한 번에 하나가 아닌 일괄적으로 플레이스먼트를 생성하고 업데이트합니다. 이러한 엔드포인트는 새로운 앱 정기적으로 실행 플레이스먼트를 추가하거나 다양한 광고 형식에서 테스트 디바이스를 조정하는 경우에 유용합니다. |
| UA |
| 대시보드에서 한 번에 하나씩 변경하는 대신 변경 사항을 자동화합니다. 이러한 엔드포인트는 많은 캠페인을 관리하거나 자주 업데이트해야 하는 경우에 유용합니다. |
Ads Unified Platform 공용 API 시작하려면 다음 설정 작업을 완료합니다.
- 필수 조건
- 조직 생성
- 서비스 계정 생성
- API 키 생성
- 광고 통합 플랫폼 공용 API 구현
Prerequisites
Ads Unified Platform 공용 API 시작하기 전에 팀원이 Unity 대시보드에서 다음 조직 역할을 수행해야 합니다.
Dashboard | 필수 역할 |
|---|---|
| 수익화 | 소유자 |
| UA | 관리자 |
Create an organization
Create a service account
새로운 Unity Dashboard에서 서비스 계정을 생성하여 API 호출을 인증합니다.
Advertisers
사용자 확보 대시보드에서 서비스 계정을 생성하고 광고주별 역할을 추가하려면 다음 단계를 완료합니다.
- 사용자 확보 대시보드 > Settings > Organization > Manage organization > Service accounts > + New로 이동합니다.
- + manage organization roles를 선택합니다.
- 서비스 계정 이름과 서비스 계정 설명을 입력합니다.
- 생성한 새 서비스 계정 페이지에서 조직 역할 섹션 > + 조직 역할 관리로 이동합니다.
- 조직 역할 다이얼로그 Grow 드롭다운으로 이동한 다음 서비스 계정에 추가할 리스트의 모든 Advertise API 역할을 선택합니다.
Publishers
수익화 대시보드에서 서비스 계정을 생성하고 퍼블리셔 역할을 추가하려면 다음 단계를 완료하십시오.
- 수익화 대시보드 > Settings > Organization > Manage organization > Service accounts > + New로 이동합니다.
- + manage organization roles를 선택합니다.
- 서비스 계정 이름과 서비스 계정 설명을 입력합니다.
- 생성한 새 서비스 계정 페이지에서 조직 역할 섹션 > + 조직 역할 관리로 이동합니다.
- 조직 역할 다이얼로그 수익화 드롭다운으로 이동한 다음 서비스 계정에 추가할 다음의 퍼블리셔 API 역할을 선택합니다.
- 광고 퍼블리셔 자동화
- 광고 퍼블리셔 테스트 디바이스 자동화
Generate your API key
Unity Dashboard 요청을 인증 위한 API 키를 생성하려면 새 서비스 계정에서 다음을 수행하십시오.
- 서비스 계정의 Keys 섹션 이동합니다.
- + Add key를 선택하여 API 키를 만듭니다.
중요
비밀 키는 대시보드에 한 번만 표시되므로 키 ID와 비밀을 나중에 레퍼런스 수 있도록 함께 안전하게 저장합니다. 키 값을 잃으면 새 키를 생성해야 합니다.
- Done을 선택합니다.
Implement the Ads Unified Platform public API
통합을 빌드 다음 API 레퍼런스 참고하십시오.
- 퍼블리셔: 광고 통합 플랫폼 퍼블리셔 공용 API
- 광고주: 광고 통합 플랫폼 광고주 공용 API