DocumentazioneAnalyticsGuida a Streaming Media Collection

Acquisire i dati del rapporto JSON sul tempo di riproduzione multimediale impiegato con le API di Analytics 2.0 get-media-playback-time-spent-json-report-data

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente
  • Amministratore
  • Sviluppatore

È possibile ottenere i dati del rapporto sul tempo di riproduzione dei file multimediali utilizzando le API di Analytics 2.0.

  1. Filtra i dati utilizzando qualsiasi segmento generato nell’interfaccia utente. Per filtrare secondo un ID di contenuto specifico, crea un nuovo segmento.

  2. Imposta elements -> id nel corpo della richiesta a metrics/playback_time_spent_seconds oppure a metrics/playback_time_spent_minutes a seconda che si desideri ottenere l'output in secondi o minuti.

  3. Richiedi una quantità sufficiente di dati.

    • L’intervallo di dati specificato nel rapporto raccoglie tutti i dati del visualizzatore simultaneo al termine della sessione video.
      Devi tenere conto delle sessioni che iniziano in un giorno e terminano dopo la mezzanotte, cioè il giorno successivo.

    • Richiedi dati per un’altra giornata secondo il periodo previsto nella tua richiesta, ma nella tua analisi utilizza solo i dati previsti.

Un payload di richiesta per i dati di una giornata sarà simile al seguente esempio. La richiesta viene effettuata per 2 giorni consecutivi, ma nel reporting utilizzerai solo il primo giorno.

Richiesta di esempio

{
    "rsid": "[YOUR_RSID]",
    "locale": "en_US",
    "dimension": "variables/daterangeminute",
    "globalFilters": [
        {
            "dateRange": "2021-09-02T00:00/2021-09-03T00:00",
            "type": "dateRange"
        }
    ],
    "metricContainer": {
        "metrics": [
            {
                "columnId": "column1",
                "id": "metrics/playback_time_spent_minutes"
            }
        ]
    },
    "settings": {
        "dimensionSort": "asc",
        "limit": "2000",
        "page": 0
  }
}

Risposta di esempio

{
   "totalPages":1,
   "firstPage":true,
   "lastPage":true,
   "numberOfElements":1440,
   "number":0,
   "totalElements":1440,
   "columns":{
      "dimension":{
         "id":"variables/daterangeminute",
         "type":"time"
      },
      "columnIds":[
         "column1"
      ]
   },
   "rows":[
      {
         "itemId":"12008020000",
         "value":"00:00 2021-09-02",
         "data":[
            123.0
         ]
      },
      {
         "itemId":"12008020001",
         "value":"00:01 2021-09-02",
         "data":[
            143.0
         ]
      },
      {
         "itemId":"12008020002",
         "value":"00:02 2021-09-02",
         "data":[
            167.0
         ]
      },

      ...
      {
         "itemId":"12008022359",
         "value":"23:59 2021-09-02",
         "data":[
            768.0
         ]
      }
   ],
   "summaryData":{
      "filteredTotals":[
         17124.0
      ],
      "totals":[
         18453.0
      ]
   }
}
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb