포드 게재를 사용하여 이루어진 각 세그먼트 또는 매니페스트 요청에는 조기 광고 시점 알림의 대체로 인증을 위한 HMAC 서명 토큰이 포함되어야 합니다.
이 토큰은 광고 시점당 한 번 계산할 수 있으며 모든 스트림 세션에서 공유할 수 있습니다.
토큰 매개변수 수집
현재 광고 시점에서 다음 정보를 수집하여 토큰 본문을 채웁니다.
| 토큰 매개변수 | ||
|---|---|---|
ad_break_id
|
pod_id 매개변수가 제공되지 않은 경우 필수입니다.
|
광고 시간의 문자열 식별자입니다. |
custom_asset_key
|
event 매개변수가 제공되지 않은 경우 필수입니다.
|
Google Ad Manager의 맞춤 라이브 스트림 애셋 키입니다. |
cust_params
|
선택사항 | 광고 시점의 맞춤 타겟팅 매개변수입니다. |
event
|
custom_asset_key 매개변수가 제공되지 않은 경우 필수입니다.
|
Google Ad Manager에서 생성된 라이브 스트림 애셋 키입니다. |
exp
|
필수 | 이 토큰의 만료 타임스탬프(초)입니다. |
network_code
|
custom_asset_key 매개변수가 제공된 경우 필수입니다.
|
이 네트워크의 Ad Manager 360 네트워크 코드입니다. |
pod_id
|
ad_break_id 매개변수가 제공되지 않은 경우 필수입니다.
|
광고 시점의 숫자 식별자입니다. |
pd
|
길이가 없는 광고 시점이 사용 설정된 이벤트를 제외하고 필수입니다. | 광고 시점의 재생 시간(밀리초)입니다. |
scte35
|
선택사항 | 광고 시점의 Base64로 인코딩된 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
다음은 사용되지 않는 선택적 매개변수가 빈 문자열로 포함된 예입니다.
토큰 문자열
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
보안 비밀 키
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
HMAC 서명
ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
서명된 토큰
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
URL 인코딩된 서명된 토큰:
cust_params%3D~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3Dea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
예 2
다음은 값이 입력되지 않은 선택적 변수가 완전히 생략된 예입니다.
토큰 문자열
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~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
예시 3
다음은 ad_break_id를 사용한 예입니다.
토큰 문자열
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000
보안 비밀 키
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
HMAC 서명
327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
서명된 토큰
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~hmac=327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
URL 인코딩된 서명된 토큰
ad_break_id%3Dadbreak1~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~hmac%3D327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29