Cada solicitud de segmento realizada con la publicación de grupos de redireccionamiento de segmentos debe incluir un Token firmado por HMAC para la autenticación, si no se usa notificaciones anticipadas de pausas publicitarias.
Este token se puede calcular una vez por pausa publicitaria y compartirse en todas las transmisiones. sesiones.
Recopila parámetros de tokens
Recopila la siguiente información de la pausa publicitaria actual para completar la cuerpo del token.
Parámetros del token | ||
---|---|---|
custom_asset_key
|
Obligatorio | La clave personalizada del recurso de transmisión en vivo de Google Ad Manager. |
cust_params
|
Opcional | Parámetros de segmentación personalizada. Consulta los cust_params .
|
exp
|
Obligatorio | Marca de tiempo de vencimiento para este token en segundos. |
network_code
|
Obligatorio | Es el código de red de Ad Manager 360 para esta red. |
pod_id
|
Obligatorio | Es el identificador de la pausa publicitaria. Debe ser un número entero que comience en
1 y aumentando en uno para cada pausa publicitaria.
Este valor debe ser el mismo para todos los usuarios que vean la misma pausa publicitaria en el evento actual. |
pd
|
Obligatorio, excepto en el caso de los eventos que tienen habilitadas las pausas publicitarias de duración indefinida. | Es la duración en milisegundos de la pausa publicitaria. Denominado anteriormente como
ad_pod_duration
|
scte35
|
Opcional | Señal SCTE-35 codificada en Base64. Es responsabilidad del cliente garantizar
que la señal sea correcta. Si no es correcto, se enviará un mensaje al
X-Ad-Manager-Dai-Warning en la respuesta y en
se propaga para crear una pausa publicitaria. Consulta la página
marcadores de anuncios para obtener más información sobre cómo la DAI utiliza la señal SCTE-35.
|
Crear cadena de token
enumerar cada parámetro en orden alfabético, en el formato name=value
, con cada
Par nombre-valor separado por un carácter de virgulilla (~
).
Los parámetros opcionales sin un valor se pueden dejar en su lugar con una cadena vacía para el valor o que se quitan por completo.
formato de la cadena del token
custom_asset_key={custom_asset_key}~exp={expiration}~network_code={network_code}~pd={pod_duration}~pod_id={ad_pod_index}~scte35={scte35_message}
Generar firma HMAC
La firma HMAC es un hash SHA-256 de la cadena del token en formato hexadecimal. El es la clave secreta Clave de autenticación HMAC asociada con su evento de transmisión en vivo en Google Ad Manager.
String del token de firma
Una vez generado, agrega la firma HMAC a la cadena del token en el siguiente formato
~hmac={HMAC signature}
String del token de codificación de URL
Este token se pasa como un parámetro de URL, de manera que debe estar codificado como URL por motivos de seguridad.
Ejemplo 1
Este es un ejemplo en el que los parámetros opcionales sin usar se incluyen como vacíos cadenas.
String de token
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
Clave del Secret
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Firma HMAC
86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
Token firmado
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
Token firmado con codificación URL:
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~cust_params%3D~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3D86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
Ejemplo 2
Este es un ejemplo en el que las variables opcionales sin propagar se omiten por completo.
String de token
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g3~exp=1489680000~network_code=6062~pd=180000~pod_id=5
Clave del Secret
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Firma HMAC
6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Token firmado
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~hmac=6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Token firmado con codificación URL
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~hmac%3D6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9