Gedownloade inhoud bijhouden track-downloaded-content

Overzicht overview

Met de functie Gedownloade inhoud kunt u het mediaconsumptie bijhouden terwijl een gebruiker offline is. Een gebruiker downloadt en installeert bijvoorbeeld een toepassing op een mobiel apparaat en gebruikt de toepassing vervolgens om inhoud te downloaden naar lokale opslag op het apparaat. Adobe heeft de functie Gedownloade inhoud ontwikkeld om de gedownloade gegevens bij te houden. Met deze functie, wanneer de gebruiker inhoud van de opslag van een apparaat speelt, worden het volgen gegevens opgeslagen op het apparaat ongeacht de connectiviteit van het apparaat. Wanneer de gebruiker de playbackzitting voltooit en het apparaat online terugkeert, wordt de opgeslagen het volgen informatie verzonden naar het achterste eind van de inzameling API van Media binnen één enkele lading. De opgeslagen het volgen informatie wordt dan verwerkt en zoals gebruikelijk gerapporteerd in de Inzameling API van Media.

Vergelijk de twee benaderingen:

Elke aanpak heeft zijn voor- en nadelen:

Implementatie implementation

Ondersteunde platforms

Inhoud bijhouden wordt ondersteund op mobiele iOS- en Android-apparaten.

Gebeurtenisschema's

De functie Gedownloade inhoud is de offlineversie van de (standaard) online API voor mediagroep. De gebeurtenisgegevens die de speler bijvoegt en naar de back-end verzendt, moeten dus dezelfde gebeurtenisschema's gebruiken als wanneer u online aanroepen maakt. Voor informatie over deze schema's, zie:

Volgorde van de gebeurtenissen

Antwoordcodes

Integratie met Adobe Analtyics integration-with-adobe-analtyics

Bij het berekenen van de aanroepen van Analytics start/close voor het gedownloade inhoudsscenario stelt de back-end een extra Analytics-veld met de naam ts. Dit zijn tijdstempels voor de eerste en laatste ontvangen gebeurtenissen (start en voltooid). Dankzij dit mechanisme kan een voltooide mediasessie op het juiste tijdstip worden geplaatst (zelfs als de gebruiker enkele dagen niet online terugkomt, wordt gemeld dat de mediasessie heeft plaatsgevonden op het moment dat de inhoud daadwerkelijk werd bekeken). U moet dit mechanisme op de kant van Adobe Analytics toelaten door a te creëren timestamp facultatieve rapportreeks. om een timestamp facultatieve rapportreeks toe te laten, zie ​ Facultatieve Tijdstempels.

Samplesessievergelijking sample-session-comparison

Online-inhoud

POST /api/v1/sessions HTTP/1.1

{
  eventType: "sessionStart",
  playerTime: {
    playhead: 0,
    ts: 1529997923478},
  params: { /* Standard metadata parameters as documented */ },
  customMetadata: { /* Custom metadata parameters as documented */ },
  qoeData: { /* QoE parameters as documented */ }
}

Gedownloade inhoud

POST /api/v1/downloaded HTTP/1.1

[{
    eventType: "sessionStart",
    playerTime:{
      playhead: 0,
      ts: 1529997923478
    },
    params:{...},
    customMetadata:{},
    qoeData:{}
},
    {eventType: "play", playerTime:
        {playhead: 0,  ts: 1529997928174}},
    {eventType: "ping", playerTime:
        {playhead: 10, ts: 1529997937503}},
    {eventType: "ping", playerTime:
        {playhead: 20, ts: 1529997947533}},
    {eventType: "ping", playerTime:
        {playhead: 30, ts: 1529997957545},},
    {eventType: "sessionComplete", playerTime:
        {playhead: 35, ts: 1529997960559}
}]

Kennisgeving van veroudering

De /api/v1/sessions API accepteert alleen sessieinitialisatiegebeurtenissen.
Wanneer u de nieuwe API gebruikt, is de eerder verplichte markering media.downloaded niet meer nodig.
We raden u ten zeerste aan de API van /api/v1/downloaded te gebruiken voor nieuwe gedownloade content-implementaties en voor het bijwerken van bestaande implementaties die afhankelijk zijn van de oude API.

POST /api/v1/sessions HTTP/1.1
[{
    eventType: "sessionStart",
    playerTime:{
      playhead: 0,
      ts: 1529997923478
    },
    params:{
        "media.downloaded": true,
        ...
    },
    customMetadata:{},
    qoeData:{}
},
    {eventType: "play", playerTime:
        {playhead: 0,  ts: 1529997928174}},
    {eventType: "ping", playerTime:
        {playhead: 10, ts: 1529997937503}},
    {eventType: "ping", playerTime:
        {playhead: 20, ts: 1529997947533}},
    {eventType: "ping", playerTime:
        {playhead: 30, ts: 1529997957545},},
    {eventType: "sessionComplete", playerTime:
        {playhead: 35, ts: 1529997960559}
}]

Referentie voor API voor mediatracker

Voor informatie over hoe te om gedownloade inhoud te vormen, zie de ​ Trekker API van Media verwijzing ​.