Exportation des données d’analyse

  • Publié le 8 juil. 2024
  • 5 procès-verbal (procès-verbaux) lu(s)
Précédent Suivant

Analyser et extraire des informations à partir des données sur des événements de téléchargement individuels

En plus des analyses agrégées disponibles dans l’interface d’Omny Studio, nous proposons un module complémentaire optionnel qui enregistre et exporte tous les événements de téléchargement individuels vers le système de stockage cloud d’un client.

L’analyse des événements de téléchargement individuels offre la possibilité d’extraire des informations en corrélant les analyses provenant d’autres sources telles que les sites Web ou les applications mobiles, ainsi que de faire pivoter et de filtrer les données sur des attributs impossibles à utiliser dans le tableau de bord, tels que la recherche des épisodes populaires dans une ville spécifique, les téléchargements par durée d’épisode ou tous les téléchargements par adresse IP.

---

Télécharger les données de l’événement

Les événements de téléchargement incluent les propriétés suivantes :

  • EventId  (chaîne) Un identifiant unique pour l’événement de téléchargement

  • Program  (Programme) Métadonnées sur le programme

  • Network  (Réseau) Métadonnées sur le réseau, si le programme est affecté à un réseau

  • Clip (Clip) Métadonnées relatives au clip

  • Playlist  (Liste de lecture) Métadonnées de la liste de lecture, si le téléchargement provient d’un flux RSS de liste de lecture

  • Download  (Téléchargement) Métadonnées relatives au téléchargement

Modèle de programme

  • Id  (chaîne) Le GUID du programme

  • Name (chaîne) Le nom du programme

  • ExternalId  (chaîne) L’identificateur externe du programme

  • Slug  (chaîne) Le slug d’URL du programme

Modèle de réseau

  • Id (chaîne) Le GUID du réseau

  • Name (chaîne) Le nom du réseau

Modèle de clip

  • Id (chaîne) Le GUID du clip

  • Slug (chaîne) Le slug de l’URL du clip

  • Title (chaîne) Le titre du clip

  • AudioDuration (chaîne) La durée du clip audio publié en format HH:MM:SS

  • AudioDurationSeconds (nombre) La durée du clip audio publié en secondes (arrondie en millisecondes/3 décimales)

Modèle de liste de lecture

  • Id (chaîne) Le GUID de la liste de lecture

  • Title (chaîne) Le titre de la liste de lecture

  • Slug (chaîne) Le slug d’URL de la liste de lecture

Modèle de téléchargement

  • RawUserAgent (chaîne) L’agent utilisateur du téléchargement

  • RawDownloadUrl (chaîne) L’URL du téléchargement

  • RawReferrerUrl (chaîne) L’URL du référent de téléchargement

  • EmbeddedUrl (chaîne) Si le téléchargement provient d’un lecteur intégré, l’URL de la page mère qui affichait l’intégration

  • DownloadedAtUtc (chaîne) La date et l’heure du téléchargement en format ISO8601

  • IpAddress (chaîne) L’adresse IP du téléchargement

  • Device (Appareil) L’appareil du téléchargement, analysé au mieux à partir de l’agent utilisateur

  • OS (Système d’exploitation) Le système d’exploitation du téléchargement, analysé au mieux à partir de l’agent utilisateur

  • UserAgent (Agent utilisateur) L’application ou le navigateur du téléchargement, analysé au mieux à partir de l’agent utilisateur

  • Source (chaîne) L’attribution de la source pour le téléchargement. Les sources présumées sont les suivantes : Podcast , Embed , OmnyFM , Twitter , MobileApp , GooglePodcastsWeb , ApplePodcastsWeb, CustomPlayer1, CustomPlayer2, CustomPlayer3, CustomPlayer4, CustomPlayer5

  • MemberId (chaîne) Identifiant du membre à accès restreint pour le téléchargement

Modèle de téléchargement

  • Geo (Géo) En option avec des frais supplémentaires. L’emplacement du téléchargement, estimé à partir de l’adresse IP

Modèle d’appareil

  • Type (chaîne) Le type d’appareil. Les types détectés sont les suivants Desktop , Mobile , Tablet , TV , HiFi , Unknown.

  • Brand (chaîne) La marque de l’appareil

  • Family (chaîne) Le nom de l’appareil

Modèle de système d’exploitation

  • Family (chaîne) Le nom du système d’exploitation

  • MajorVersion (chaîne) Le numéro de version principal du système d’exploitation

Modèle d'agent utilisateur

  • Family (chaîne) Le nom de l’application ou du navigateur

  • MajorVersion (chaîne) Le numéro de version principal de l’application ou du navigateur

Modèle géographique (en option avec frais supplémentaires)

Veuillez noter que ces données ne sont PAS incluses dans l’exportation des données analytiques « de base ».

  • Country (chaîne) Le nom du pays

  • CountryIsoCode (chaîne) Le code ISO à deux lettres du pays

  • State (chaîne) Le nom de l’État ou de la région

  • City (chaîne) Le nom de la ville

  • Postcode (chaîne) Le code postal

Exemple d’un événement de téléchargement 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"
    }
}

Notes pour les développeurs sur la mise en œuvre

Les consommateurs du flux d’exportation analytique doivent être conscients des détails suivants sur la mise en œuvre.

Obligation de moyens pour la diffusion

L’exportation des données est fournie en tant que service au mieux avec au moins une diffusion en une seule fois. 

Utilisez l'onglet EventId pour dédupliquer la probabilité d’événements répétés

Les événements de téléchargement peuvent être dupliqués dans une fenêtre de 24 heures en raison d’erreurs intermittentes et nous vous recommandons de vérifier l’unicité de l’événement à l’aide de EventId , identifiant unique.

Historique d’exportation indisponible

Les données ne sont disponibles qu’à partir du moment où la fonctionnalité est activée pour l’organisation. Les données historiques ne sont pas disponibles via cette fonctionnalité.

Calendrier de diffusion des événements de téléchargement relatifs aux fichiers exportés

Les événements de téléchargement exportés peuvent également être retardés jusqu’à 24 heures à compter de leur survenance.

Par exemple, si un téléchargement a lieu le 10 du mois, l’événement de téléchargement peut être écrit dans un fichier exporté portant la date du 11 du mois. La propriété DownloadedAtUtc de l'événement reflétera néanmoins l’heure de téléchargement du 10.

Cela peut se produire dans le cadre de nos techniques de filtrage des téléchargements nécessitant des données de journal CDN qui peuvent être retardées, ou parce que l’auditeur n’a téléchargé une quantité suffisante de l’épisode que plus tard dans la journée pour être considéré comme un téléchargement vérifié.

Format du fichier d’exportation de l’événement

Les événements de téléchargement sont exportés par lots à intervalles réguliers sous forme de fichiers JSON Lines compressés vers le serveur de stockage cloud spécifié.

Les fichiers sont traités selon la convention de dossier suivante :

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

p. ex. /2019/2019-03/2019-03-18 

Les fichiers sont traités selon la convention de nom de fichier suivante :

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

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

Nous sommes actuellement compatibles avec les systèmes de stockage du cloud suivants :

  • Stockage Blob Azure de Microsoft

  • Amazon S3

Si vous avez besoin d’exporter des données vers un autre système de stockage, veuillez nous contacter.

Exportation S3

Pour une exportation S3, nous avons besoin des informations suivantes :

  • Nom du bucket

  • Région

  • Clé d’accès

  • Clé secrète

La clé secrète doit être considérée comme une donnée sensible. Veuillez utiliser un service tel que onetimesecret.com pour transmettre la clé secrète.