브라이트코브 라이브 프로그램 광고 메타데이터 API

서문

광고 메타 데이터 (ad_server_data) 스키마는 중첩 된 요소가없는 플랫 JSON 구문을 지원합니다 (키-값 쌍만 해당). API를 통해 설정된 광고 서버 데이터는 데이터를 덮어 쓰거나 재설정 할 때까지 업데이트 후 수신 된 모든 광고 시간에 사용됩니다. 고객은 실시간 스트리밍 중에 언제든지 데이터를 업데이트 및 / 또는 재설정 할 수 있습니다.

이 메타 데이터는 Steam 활성화간에 유지되지 않습니다. 스트림 활성화 사이에 유지되어야하는 광고 메타 데이터는 SSAI 애플리케이션 광고 구성에서 설정해야합니다. API를 통해 설정된 데이터는 광고 서버 및 서버 측 비콘 교체에서 매크로로 사용하도록 구성 할 수 있습니다.

광고 프로그램 메타 데이터는 맞춤 재생 목록 태그를 통해 SSAI 시스템에 전달되며 SSAI 시스템의 기존 DAP (Dynamic Ad Parameter) 우선 순위를 따릅니다. 큐 포인트에서 전송 된 광고 서버 데이터는 작업에 할당 된 메타 데이터보다 우선합니다. 작업에서 큐 포인트 데이터와 광고 메타 데이터간에 키 충돌이 발생하면 큐 포인트 값이 더 높은 우선 순위로 간주되어 병합 된 컬렉션에 사용됩니다.

큐 포인트에 제공된 광고 메타 데이터는 해당 큐 포인트에만 사용되며 이후의 큐 포인트 삽입에는 유지되지 않습니다. 프로그램 광고 메타 데이터 API를 통해 설정된 광고 메타 데이터 만 업데이트되거나 재설정 될 때까지 이후에 수신되는 모든 광고 시간에 대해 유지됩니다.

엔드포인트

엔드포인트에 대한 자세한 내용은 Live API 참조를 참조하십시오 .

추가 / 업데이트

라이브 프로그램 광고 메타데이터를 추가하거나 업데이트하려면 다음 주소로POST요청을 보내십시오.

https://api.bcovlive.io/v1/jobs/{job_id}/cuepointdata

{
  "ad_server_data": {
  	"one":"won",
  	"two":2,
  	"three":false
  }
}

삭제

라이브 프로그램 광고 메타데이터를 삭제하려면 다음 주소로DELETE요청을 보내십시오.

https://api.bcovlive.io/v1/jobs/{job_id}/cuepointdata