이벤트 요청 events-request

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

사용자
관리자
개발자

POST https://{uri}/api/v1/sessions/{sid}/events

URI 매개 변수

sid: 세션 요청에서 반환된 세션 ID입니다.

요청 본문

요청 본문은 JSON이어야 하며, 이 샘플 요청 본문과 구조가 동일해야 합니다.

{
    "playerTime": {
        "playhead": 0,
        "ts": 1509045324153
    },
    "eventType": "{event-type}",
    "params": {},
    "qoeData": {},
    "customMetadata": {}
}

playerTime (필수입니다)
- playhead - 초 단위이어야 하지만, float일 수 있습니다.
- ts - 타임스탬프이며, 밀리초 단위여야 합니다.
eventType (필수입니다)
params (선택 사항입니다)
customMetadata (선택 사항이며, adStart 및 chapterStart 이벤트 유형과 함께 보냄)
qoeData (선택 사항입니다)

이 릴리스의 유효한 이벤트 유형 목록에 대해서는 이벤트 유형 및 설명을 참조하십시오.

IMPORTANT

광고 추적 -adBreak 내에서만 광고를 추적할 수 있습니다.

광고 주위에 adBreakStart 및 adBreakComplete "북엔드"가 없을 경우 adStart 및 adComplete 이벤트가 무시되고, 해당 광고 기간은 기본 콘텐츠 기간으로 추적됩니다. 이 경우 Adobe Analytics에서 사용할 수 있는 집계된 데이터에 상당한 영향을 줄 수 있습니다.

응답

HTTP/1.1 204 No Content
Server nginx/1.13.5
Date Thu, 26 Oct 2017 19:15:24 GMT
Connection keep-alive
Access-Control-Allow-Origin *
Access-Control-Allow-Methods OPTIONS,POST,PUT
Access-Control-Allow-Headers Content-Type
Access-Control-Expose-Headers Location

HTTP 응답 코드

설명

클라이언트 작업 항목

204

콘텐츠 없음.

하트비트 호출이 성공했습니다.

해당 없음

400

잘못된 요청.

요청의 형식이 잘못되었습니다.

JSON 유효성 검사 스키마에서 요청 유형을 확인하십시오.

404

없음.

미디어 세션의 세션 ID를 백 엔드 서비스에서 찾지 못했습니다.

클라이언트 애플리케이션은 세션 요청 API를 사용하여 다른 미디어 세션을 작성하고 이에 대한 추적을 보고해야 합니다.

410

없어짐.

미디어 세션이 백 엔드 서비스에서 발견되었지만 고객이 더 이상 이 세션에서 활동을 보고할 수 없습니다.

클라이언트 애플리케이션은 세션 요청 API를 사용하여 다른 미디어 세션을 작성하고 이에 대한 추적을 보고해야 합니다.

500

서버 오류

해당 없음

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb