브라이트코브 라이브 프로그램 광고 메타데이터 API
서문
광고 메타 데이터 (ad_server_data) 스키마는 중첩 된 요소가없는 플랫 JSON 구문을 지원합니다 (키-값 쌍만 해당). API를 통해 설정된 광고 서버 데이터는 데이터를 덮어 쓰거나 재설정 할 때까지 업데이트 후 수신 된 모든 광고 시간에 사용됩니다. 고객은 실시간 스트리밍 중에 언제든지 데이터를 업데이트 및 / 또는 재설정 할 수 있습니다.
이 메타 데이터는 Steam 활성화간에 유지되지 않습니다. 스트림 활성화 사이에 유지되어야하는 광고 메타 데이터는 SSAI 애플리케이션 광고 구성에서 설정해야합니다. API를 통해 설정된 데이터는 광고 서버 및 서버 측 비콘 교체에서 매크로로 사용하도록 구성 할 수 있습니다.
광고 프로그램 메타 데이터는 맞춤 재생 목록 태그를 통해 SSAI 시스템에 전달되며 SSAI 시스템의 기존 DAP (Dynamic Ad Parameter) 우선 순위를 따릅니다. 큐 포인트에서 전송 된 광고 서버 데이터는 작업에 할당 된 메타 데이터보다 우선합니다. 작업에서 큐 포인트 데이터와 광고 메타 데이터간에 키 충돌이 발생하면 큐 포인트 값이 더 높은 우선 순위로 간주되어 병합 된 컬렉션에 사용됩니다.
큐 포인트에 제공된 광고 메타 데이터는 해당 큐 포인트에만 사용되며 이후의 큐 포인트 삽입에는 유지되지 않습니다. 프로그램 광고 메타 데이터 API를 통해 설정된 광고 메타 데이터 만 업데이트되거나 재설정 될 때까지 이후에 수신되는 모든 광고 시간에 대해 유지됩니다.
엔드포인트
엔드 포인트에 대한 자세한 내용은라이브 API 참조 .
추가 / 업데이트
라이브 프로그램 광고 메타 데이터를 추가하거나 업데이트하려면POST
요청 :
https://api.bcovlive.io/v1/jobs/{job_id}/cuepointdata
필드 | 유형 | 설명 | 예 |
---|---|---|---|
ad_server_data |
객체 | 키 / 값 쌍을 포함하는 개체입니다. |
|
삭제
라이브 프로그램 광고 메타 데이터를 삭제하려면DELETE
요청 :
https://api.bcovlive.io/v1/jobs/{job_id}/cuepointdata