세그먼트 리디렉션 포드 제공을 사용하여 만든 각 세그먼트 요청에는 조기 광고 시점 알림을 사용하지 않는 경우 인증을 위한 HMAC 서명 토큰을 포함해야 합니다.
이 토큰은 광고 시점당 한 번 계산될 수 있으며 모든 스트림 세션에서 공유할 수 있습니다.
토큰 매개변수 수집
현재 광고 시점에서 다음 정보를 수집하여 토큰 본문을 채웁니다.
토큰 매개변수 | ||
---|---|---|
custom_asset_key
|
필수 | Google Ad Manager에서 가져온 맞춤 실시간 스트림 애셋 키입니다. |
cust_params
|
선택사항 | 맞춤 타겟팅 매개변수입니다. cust_params 페이지를 참고하세요.
|
exp
|
필수 | 이 토큰의 만료 타임스탬프(초)입니다. |
network_code
|
필수 | 이 네트워크의 Ad Manager 360 네트워크 코드입니다. |
pod_id
|
필수 | 광고 시간의 식별자입니다. 1 부터 시작하여
광고 시점마다 1씩 증가하는 정수여야 합니다.
이 값은 현재 이벤트에서 동일한 광고 시점을 보는 모든 사용자에게서 동일해야 합니다. |
pd
|
지속 시간이 없는 광고 시간이 사용 설정된 이벤트를 제외하고 필수입니다. | 광고 시간의 길이(밀리초)입니다. 위에서 ad_pod_duration 라고 합니다.
|
scte35
|
선택사항 | Base64로 인코딩된 SCTE-35 신호입니다. 신호가 올바른지 확인하는 것은 클라이언트의 책임입니다. 잘못된 경우 메시지가 응답의
X-Ad-Manager-Dai-Warning HTTP 헤더로 전송되고 신호가 계속 전달되어
광고 시점을 만듭니다. DAI가 SCTE-35 신호를 사용하는 방법에 관한 자세한 내용은 지원되는 광고 마커를 참고하세요.
|
토큰 문자열 만들기
각 매개변수를 name=value
형식으로 알파벳순으로 나열하고 각 이름-값 쌍은 물결표 (~
) 문자로 구분합니다.
값이 없는 선택적 매개변수는 값에 대한 빈 문자열로 제자리에 두거나 완전히 삭제할 수 있습니다.
토큰 문자열 형식
custom_asset_key={custom_asset_key}~exp={expiration}~network_code={network_code}~pd={pod_duration}~pod_id={ad_pod_index}~scte35={scte35_message}
HMAC 서명 생성
HMAC 서명은 16진수 형식의 토큰 문자열의 SHA-256 해시입니다. 보안 비밀 키는 Google Ad Manager의 실시간 스트림 이벤트와 연결된 HMAC 인증 키입니다.
서명 토큰 문자열
생성된 HMAC 서명을 다음 형식으로 토큰 문자열에 추가합니다.
~hmac={HMAC signature}
URL 인코딩 토큰 문자열
이 토큰은 URL 매개변수로 전달되므로 안전을 위해 URL 인코딩해야 합니다.
예시 1
다음은 사용되지 않는 선택적 매개변수가 빈 문자열로 포함되는 예입니다.
토큰 문자열
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
보안 비밀 키
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
HMAC 서명
86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
서명된 토큰
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
URL로 인코딩된 서명된 토큰의 경우:
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~cust_params%3D~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3D86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
예시 2
다음은 채워지지 않은 선택적 변수가 완전히 생략된 예입니다.
토큰 문자열
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g3~exp=1489680000~network_code=6062~pd=180000~pod_id=5
보안 비밀 키
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
HMAC 서명
6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
서명된 토큰
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~hmac=6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
URL로 인코딩된 서명된 토큰
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~hmac%3D6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9