Dokumentation Analytics Guide för direktuppspelande medietjänster

Översikt över Media Collection API overview

Senast uppdaterad: 29 maj 2026

Skapat för:

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Media Collection API är ett Adobe RESTful-alternativ till Media SDK på klientsidan. Med Media Collection API kan spelaren spåra ljud- och videohändelser med RESTful HTTP-anrop.

Media Collection API är i princip ett kort som fungerar som en serverversion av Media SDK. Insamlade spårningsdata för direktuppspelande media leder till samma rapportering och analys.

Dataflöden för mediespårning media-tracking-data-flows

En mediespelare som implementerar API:t för Media Collection gör RESTful API-spårningsanrop direkt till bakomliggande mediaspårningsserver, medan en spelare som implementerar Media SDK gör spårningsanrop till SDK API:er inuti spelarappen. En effekt av att anropa via webben är att spelaren som implementerar API:t för Media Collection måste hantera en del av bearbetningen som Media SDK hanterar automatiskt. (Information i Implementering av mediesamling.)

Spårningsdata som hämtas med Media Collection API skickas och bearbetas först på ett annat sätt än spårningsdata som hämtas i en Media SDK-spelare, men samma bearbetningsmotor på baksidan används för båda lösningarna.

API-översikt api-overview

URI: Hämta detta från din Adobe-representant.

HTTP-metod: POST, med JSON-begärandebrödtext.

API-anrop mc-api-calls

sessions- Upprättar en session med servern och returnerar ett sessions-ID som används i efterföljande events anrop. Din app anropar detta en gång i början av en spårningssession.

{uri}/api/v1/sessions
events- Skickar mediespårningsdata.

{uri}/api/v1/sessions/{session-id}/events

Begärandetext mc-api-request-body

{
    "playerTime": {
        "playhead": "{playhead position in seconds}",
        "ts": "{timestamp in milliseconds}"
    },
    "eventType": "{event-type}",
    "params": {
        "{parameter-name}": "{parameter-value}",
        "{parameter-name}": "{parameter-value}"
    },
    "qoeData" : {
        "{parameter-name}": "{parameter-value}",
        "{parameter-name}": "{parameter-value}"
    },
    "customMetadata": {
        "{parameter-name}": "{parameter-value}",
        "{parameter-name}": "{parameter-value}"
    }
}

playerTime - Obligatoriskt för alla begäranden.
eventType - Obligatoriskt för alla begäranden.
params - obligatoriskt för vissa eventTypes; kontrollera JSON-valideringsschemat för att avgöra vilka eventTypes som är obligatoriska och vilka som är valfria.
qoeData - Valfritt för alla begäranden.
customMetadata - Valfritt för alla förfrågningar, men endast skickat med händelsetyperna sessionStart, adStart och chapterStart.

För varje eventType finns det ett öppet JSON-valideringsschema som du bör använda för att verifiera parametertyper och om en parameter är valfri eller nödvändig för en viss händelse.

Händelsetyper mc-api-event-types

En fullständig lista över händelsetyper med implementeringsexempel per SDK finns i Översikt över händelser.

recommendation-more-help

media-analytics-help