Exportación de datos analíticos

  • Publicado el Jul 8, 2024
  • 5 minuto(s) de lectura
Anterior Siguiente

Analice y extraiga información de datos de eventos de descarga individuales

Además de los análisis agregados disponibles desde la interfaz de Omny Studio, ofrecemos un complemento opcional que registra y exporta todos los eventos de descarga individuales al sistema de almacenamiento en la nube de un cliente.

El análisis de eventos de descarga individuales proporciona la flexibilidad de extraer información al correlacionar análisis de otras fuentes, como sitios web o aplicaciones móviles, así como pivotar y filtrar datos sobre atributos que no son posibles dentro del panel, como determinar qué episodios son populares en una ciudad específica, descargas por duración de episodio o todas las descargas por una dirección IP.

---

Descargar datos de eventos

Los eventos de descarga incluyen las siguientes propiedades:

  • EventId  (cadena) Un identificador único para el evento de descarga

  • Program  (Programa) Metadatos sobre el programa

  • Network  (Red) Metadatos sobre la red, si el programa está asignado a una red

  • Clip (Clip) Metadatos sobre el clip

  • Playlist  (Lista de reproducción) Metadatos sobre la lista de reproducción, si la descarga es desde una fuente RSS de lista de reproducción

  • Download  (Descargar) Metadatos sobre la descarga

Modelo de programa

  • Id  (cadena) El GUID del programa

  • Name (cadena) El nombre del programa

  • ExternalId  (cadena) El identificador externo del programa

  • Slug  (cadena) El slug de URL del programa

Modelo de red

  • Id (cadena) El GUID de la red

  • Name (cadena) El nombre de la red

Modelo de clip

  • Id (cadena) El GUID del clip

  • Slug (cadena) El slug de URL del clip

  • Title (cadena) El título del clip

  • AudioDuration (cadena) La duración del clip de audio publicado en HH:MM:SS

  • AudioDurationSeconds (número) La duración del clip de audio publicado en segundos (redondeada a milisegundos/3 decimales)

Modelo de lista de reproducción

  • Id (cadena) El GUID de la lista de reproducción

  • Title (cadena) El título de la lista de reproducción

  • Slug (cadena) El slug de URL de la lista de reproducción

Descargar modelo

  • RawUserAgent (cadena) El agente de usuario de la descarga

  • RawDownloadUrl (cadena) La URL de la descarga

  • RawReferrerUrl (cadena) La URL del referente de descarga

  • EmbeddedUrl (cadena) Si la descarga se realiza desde un reproductor incrustado, la URL de la página principal que mostró la incrustación

  • DownloadedAtUtc (cadena) La fecha y hora de la descarga en ISO8601

  • IpAddress (cadena) La dirección IP de la descarga

  • Device (Dispositivo) El dispositivo de la descarga, analizado desde el agente de usuario en el mejor esfuerzo

  • OS (SO) El sistema operativo de la descarga, analizado desde el agente de usuario en el mejor esfuerzo

  • UserAgent (UserAgent) La aplicación o el navegador de la descarga, analizados desde el agente de usuario a mejor esfuerzo

  • Source (cadena) La atribución de la fuente para la descarga. Las fuentes inferidas incluyen Podcast , Embed , OmnyFM , Twitter , MobileApp , GooglePodcastsWeb , ApplePodcastsWeb, CustomPlayer1, CustomPlayer2, CustomPlayer3, CustomPlayer4, CustomPlayer5

  • MemberId (cadena) ID del miembro de acceso restringido para la descarga

Descargar modelo

  • Geo (Geo) Opcionalmente con cargos adicionales. La ubicación de la descarga, estimada a partir de la dirección IP

Modelo de dispositivo

  • Type (cadena) El tipo de dispositivo. Los tipos detectados incluyen Desktop , Mobile , Tablet , TV , HiFi , Unknown.

  • Brand (cadena) La marca del dispositivo

  • Family (cadena) El nombre del dispositivo

Modelo de sistema operativo

  • Family (cadena) El nombre del sistema operativo

  • MajorVersion (cadena) El número de versión principal del sistema operativo

Modelo UserAgent

  • Family (cadena) El nombre de la aplicación o navegador

  • MajorVersion (cadena) El número de versión principal de la aplicación o navegador

Modelo geográfico (opcionalmente con cargos adicionales)

Tenga en cuenta que estos datos NO se incluyen en la exportación de datos analíticos "básicos".

  • Country (cadena) El nombre del país

  • CountryIsoCode (cadena) El código ISO de dos letras del país

  • State (cadena) El nombre del estado o región

  • City (cadena) El nombre de la ciudad

  • Postcode (cadena) El código postal

Ejemplo de un evento de descarga JSON

{
    "EventId": "46fa9c3a-1bd6-4c7f-9b50-107b20d7faa1",
    "Program": {
        "Id": "27aa1c43-82bf-4b8a-9e78-a93b002c0a85",
        "Name": "Morbi leo risus",
        "Slug": "morbi-leo-risus"
    },
    "Network": {
        "Id": "bc8305f4-52e8-4df5-a7b7-3937939adb2d",
        "Name": "Dolore magna aliqua",
    }
    "Clip": {
        "Id": "67cc2dc9-6709-48e1-8d6b-a9fa007b32e7",
        "Slug": "etiam-porta",
        "Title": "Etiam porta sem malesuada magna mollis euismod.",
        "AudioDuration": "01:25:05.2510000",
        "AudioDurationSeconds": 5105.251
    },
    "Download": {
        "RawUserAgent": "AppleCoreMedia/1.0.0.15A402 (iPhone; U; CPU OS 11_0_1 like Mac OS X; en_au)",
        "RawDownloadUrl": "https://omnystudio.com:443/d/clips/.../audio.mp3?utm_source=Embed...",
        "RawReferrerUrl": null,
        "EmbeddedUrl": null,
        "DownloadedAtUtc": "2019-03-18T00:52:01Z",
        "Device": {
            "Type": "Mobile",
            "Brand": "Apple",
            "Family": "iPhone"
        },
        "OS": {
            "Family": "iOS",
            "MajorVersion": "11"
        },
        "UserAgent": {
            "Family": "Apple Core Media",
            "MajorVersion": "1"
        },
        "Source": "Podcast"
    }
}

Notas de implementación para desarrolladores

Los consumidores del feed de exportación de análisis deben conocer los siguientes detalles de implementación.

Entrega de mejor esfuerzo

La exportación de datos se proporciona como un servicio de mejor esfuerzo con al menos una entrega de una vez. 

Use la pestaña EventId propiedad para desduplicar la posibilidad de eventos repetidos

Los eventos de descarga pueden duplicarse en un período de 24 horas debido a errores intermitentes, y recomendamos verificar la singularidad del evento mediante el EventId Identificador único.

No hay exportación histórica disponible

Los datos solo están disponibles desde el momento en que la característica está habilitada para la organización. Los datos históricos no están disponibles a través de esta función.

Momento de entrega de los eventos de descarga relativos a los archivos exportados

Los eventos de descarga que se exportan también pueden retrasarse hasta 24 horas desde que se producen.

Por ejemplo, si una descarga se produce el día 10 del mes, el evento de descarga puede escribirse en un archivo exportado que tenga la fecha del día 11 del mes. El evento DownloadedAtUtc Sin embargo, seguirá reflejando el tiempo de descarga del día 10.

Esto puede ocurrir como parte de nuestras técnicas de filtrado de descargas que requieren datos de registro de CDN que pueden retrasarse, o porque el oyente no descargó una cantidad suficiente del episodio hasta más tarde en el día para que se considere una descarga verificada.

Formato de archivo de exportación de eventos

Los eventos de descarga se exportan por lotes al servidor de almacenamiento en la nube especificado a intervalos regulares como archivos JSON Lines comprimidos.

Los archivos se escriben utilizando la siguiente convención de carpetas:

{year}/{year}-{month}/{year}-{month}-{day}

p. ej.. /2019/2019-03/2019-03-18 

Los archivos se escriben utilizando la siguiente convención de nombre de archivo:

{year}-{month}-{day}T{hour}{minute}_{time of first event}_{unique identifier}.jsonl.gz

p. ej.. 2019-03-18T0052_005201.941_81b9bcac-f6b0-4bd8-b191-4af7b89a985c.jsonl.gz 

Actualmente admitimos los siguientes sistemas de almacenamiento en la nube:

  • Almacenamiento de blobs de Microsoft Azure

  • Amazon S3

Si necesita exportar datos a un sistema de almacenamiento diferente, póngase en contacto con nosotros.

Exportación S3

Para una exportación de S3, necesitamos los siguientes detalles:

  • Nombre del contenedor

  • Región

  • Tecla de acceso

  • Clave secreta

La clave secreta debe considerarse datos confidenciales. Utilice un servicio como onetimesecret.com para transmitir la clave secreta.