Configurare l’API di Media Edge per lo streaming di file multimediali
Se non è possibile utilizzare Web SDK, Mobile SDK o Roku SDK, ad esempio in un runtime personalizzato o non supportato, è possibile inviare dati multimediali in streaming direttamente a Edge Network con l’API Media Edge. L’API utilizza chiamate HTTP RESTful ed è completamente personalizzabile.
- Prerequisiti: completa la panoramica sull’implementazione di Edge (schema, set di dati, flusso di dati con Media Analytics abilitato).
Inviare eventi multimediali ad Edge Network
Gli eventi multimediali vengono inviati agli endpoint /ee/va/v1/, inseriti nel flusso di dati dal parametro di query configId. Ad esempio, una sessione inizia con un POST su sessionStart:
curl -X POST "https://edge.adobedc.net/ee/va/v1/sessionStart?configId=<datastreamID>" \
--header 'Content-Type: application/json' \
--data '{
"events": [{
"xdm": {
"eventType": "media.sessionStart",
"mediaCollection": {
"sessionDetails": { "name": "video-123", "playerName": "player_name", "contentType": "vod", "length": 128, "channel": "sample_channel" },
"playhead": 0
}
}
}]
}'
La risposta restituisce l’ID sessione che tutti gli eventi successivi devono includere. Per il set completo di endpoint, i formati di richiesta/risposta e le specifiche OpenAPI, vedi il riferimento API di Media Edge.
Tracciare gli eventi multimediali
Per conoscere i payload esatti, consulta la scheda API Media Edge su ogni pagina event e variable.
Passaggio successivo
Una volta completata l’implementazione, puoi Configurare la generazione di rapporti per le implementazioni di Edge.