L’API Live Linear Program Dataset

Access session-level, program-grain viewership data for your Prime Video linear channels.

~15 min de lecture octobre 2, 2026

Ce guide couvre tout ce dont vous avez besoin pour accéder à l’API Live Linear Program Dataset et l’utiliser

Ce que vous allez apprendre

  • Ce que propose l’API et quels flux sont disponibles.
  • Comment authentifier et récupérer des fichiers de jeux de données.
  • Le modèle de données complet et les définitions des colonnes.
  • Comment fonctionnent le journal des modifications et le signal is_deleted.
  • Modèles de déduplication et de FUSION que vous pouvez copier dans votre pipeline.
  • Cadence d’ingestion recommandée.
  • Exemples de requêtes SQL pour les analyses courantes.

Aperçu

L’API Live Linear Program Dataset fournit des données d’audience relatives à l’ensemble des programmes pour vos chaînes Prime Video linéaires, en direct et FAST. Chaque enregistrement représente une session de visionnage d’une émission programmée sur une chaîne.

Les données sont fournies sous forme de journal des modifications avec des signaux is_deleted pour les corrections de programmation. Deux flux sont disponibles : Chaînes (linear_program_event_log) et FAST (fast_linear_program_event_log).

Ces données vous permettent de :

  • • Suivre l’audience au niveau du programme (heures de visionnage, sessions) sur toutes les stations, les territoires et les appareils et en termes de temps.
  • • Analyser les performances par station, programme, série et type de contenu.
  • • Suivre les corrections de programmation avec précision, sans lignes périmées dans vos données.
  • • Intégrer l’affichage linéaire en direct à vos systèmes internes et à vos sources de données.

Pour une analyse basée sur des tableaux de bord, voir : Programmation linéaire sur Slate Analytics

Fonctionnalités principales

Fonctionnalité

Détails

Détail au niveau du programme

Une ligne par session de visionnage, programme et programmation. Comprend le titre, la station, la série, la fenêtre de diffusion et la durée de visionnage.

Signal de suppression

Les programmations remplacées ou retirées sont renvoyées avec is_deleted = 1, signalant qu’elles ne sont plus valides.

Clé unique stable

Chaque ligne contient session_program_schedule_id. Utilisez-la pour dédupliquer et FUSIONNER.

Ingestion simplifiée

Modèle de journal des modifications. Planifiez des appels récurrents, puis FUSIONNEZ. Mettez à jour et insérez sur is_deleted = 0. Suppression matérielle ou logicielle sur is_deleted = 1.

Cohérence

Mise en forme normalisée pour tous les territoires dans une source unique. Aucun tableau dimensionnel par territoire n’est nécessaire.

Concepts clés

Concept

Description

Ligne Session-Programme-Programmation

Séance de visionnage d’un programme dans un créneau programmé. Identifié par session_program_schedule_id.

Modèle de journal des modifications

Les données sont sous forme de journal des modifications. Si les attributs d’une ligne changent, une nouvelle version est publiée avec le même session_program_schedule_id et un last_update_time_utc plus récent.

Clé primaire

session_program_schedule_id est l’identifiant unique. Effectuez toujours la déduplication sur ce champ.

Signal is_deleted

is_deleted = 0 signifie que la programmation est active. is_deleted = 1 indique que la programmation n’est plus active ni valide.

Appliquer le signal

is_deleted = 0 : insérez ou mettez à jour la ligne. is_deleted = 1 : faites en sorte qu’il n’apparaisse plus dans vos données actuelles. Supprimez la ligne ou gardez-la marquée et filtrez-la.

Premiers pas

Comment réaliser l’intégration
L’API Live Linear Program Dataset fait partie de la suite d’API Analytics. Lorsque vous intégrez la suite d’API Analytics, vous aurez accès à toutes les API disponibles dans cette suite, y compris l’API Live Linear Program Dataset (si cela est demandé lors de l’intégration). Pour obtenir des instructions d’intégration détaillées, consultez la page d’intégration de l’API.

Pré-requis
Avant d’effectuer des demandes d’API, vous devez disposer des éléments suivants :

  • Un profil de sécurité du service Connexion avec Amazon (LWA). Envoyez votre identifiant client à votre CAM pour qu’il soit ajouté à la page d’administration interne de PV.
  • Un code d’autorisation pour demander un jeton.
  • Un jeton pour toutes les demandes d’API.

URI de base : https://videocentral.amazon.com/apis/v2

L’en-tête d’autorisation doit inclure un jeton d’authentification LWA valide pour toutes les requêtes. Si le jeton est manquant ou a expiré, l’API renvoie une exception non autorisée.

Pagination
Toutes les réponses sont paginées. Utilisez ces paramètres pour parcourir les pages :

Paramètre

Par défaut

Description

limite

10

Nombre de documents renvoyés par page. Maximum de 1 000.

offset

0

Nombre de documents à ignorer avant le premier résultat. Suivez l’URL suivante au lieu de la calculer vous-même.

Toutes les réponses paginées incluent les champs suivants :

Champ

Description

total

Nombre total de documents sur toutes les pages.

next

L’URL de la page suivante. Null s’il s’agit de la dernière page.

Récupération de fichiers d’ensembles de données

Point de terminaison
Utilisez cette commande curl pour récupérer la liste des liens vers les fichiers de jeux de données téléchargeables :


Remarque : Ce point de terminaison renvoie des liens vers des fichiers CSV téléchargeables compressés au format GZIP, et non directement les lignes.

Paramètres

Paramètre

Description

ACADIA_ID

Votre numéro de compte Slate. Trouvez-le sur /v2/accounts.

REPORT_GROUP

Le segment du secteur d’activité. Utilisez les chaînes pour le flux des chaînes ou fast pour le flux FAST. Découvrez le vôtre avec GET /v2/accounts/{ACADIA_ID}.

IDENTIFIER_ID

La valeur d’identifiant renvoyée par le point de terminaison des identificateurs. Pour les Chaînes, il s’agit d’un hachage opaque. Utilisez le champ id tel qu’il est indiqué. Pour FAST, il s’agit de votre code fournisseur, renvoyé sans hachage.

REPORT_ID

Quel rapport extraire. Utilisez linear_program_event_log pour les Chaînes ou fast_linear_program_event_log pour FAST.

startDateTime

Définie sur la dernière fois que vous avez collecté des données. Format : YYYY-MM-DDThh:mm:ssZ (UTC).

endDateTime

Définie sur l’heure actuelle. Format : YYYY-MM-DDThh:mm:ssZ (UTC).

limite

Minimum 1, maximum 1 000 liens par page.

Rapports disponibles
Deux rapports sont disponibles. Extrayez chacun d’eux séparément en insérant son identifiant de rapport dans le segment de chemin datasets/{REPORT_ID} :

Rapport

ID du rapport

Contenu

Chaînes

linear_program_event_log

SVOD/abonnement linéaire (3P_SUBS et FREE/PRIME le cas échéant).

FAST

fast_linear_program_event_log

Télévision supportée par la publicité gratuite/chaînes linéaires financées par la publicité (AVOD)

Remarque : La durée de conservation maximale des données est de 2 ans. Les demandes datant de plus de 2 ans ne donneront aucun résultat.

Points de terminaison de détection

Utilisez ces points de terminaison pour trouver l’identifiant de votre compte, les groupes de rapports, les identifiants et les ensembles de données disponibles :

Point de terminaison

Retours

GET /v2/accounts

Liste des comptes Slate auxquels vous pouvez accéder.

GET /v2/accounts/{ACADIA_ID}

Secteurs d’activité disponibles (par exemple, chaînes, fast).

GET /v2/accounts/{ACADIA_ID}/channels

Identifiants de rapport mis à votre disposition. Chaque entrée possède un identifiant et un nom convivial.

GET /v2/accounts/{ACADIA_ID}/channels/{IDENTIFIER_ID}/datasets

Ensembles de données disponibles pour cet identifiant.

Colonnes de données

Les colonnes suivantes sont présentes dans le flux linear_program_event_log (Chaînes). Le flux fast_linear_program_event_log (FAST) a la même forme, avec vendor_code ajouté et les colonnes d’abonnement livrées sous la forme NULL.

Colonne

Type

Nullable

Description

session_program_schedule_id

CHAÎNE DE CARACTÈRES

Non

Clé primaire. Identifiant unique (code la session, le programme et la fenêtre de diffusion). Dédupliquez et FUSIONNEZ dans ce champ. Modifie le moment où le programme ou l’heure de diffusion changent en raison de la mise à jour des métadonnées EPG.

session_id

CHAÎNE DE CARACTÈRES

Non

Identifiant de session de visionnage unique anonymisé.

is_deleted

INT

Non

Signal d’état. 0 = la programmation est active. 1 = la programmation n’est plus active (remplacée ou retirée). Excluez les lignes is_deleted = 1 de vos données actuelles.

last_update_time_utc

HORODATAGE

Non

Enregistrez l’heure de la version. Utilisez-le toujours pour dédupliquer. Conservez la ligne contenant la valeur la plus récente pour un identifiant donné.

create_time_utc

HORODATAGE

Non

Quand la ligne a été créée pour la première fois.

program_id

CHAÎNE DE CARACTÈRES

Non

Identifiant du programme, par exemple ID TMS.

pv_title_id

CHAÎNE DE CARACTÈRES

Oui

Identifiant de titre global (GTI) Prime Video pour le programme. Identique à pv_title_id dans le flux TVOD.

program_title

CHAÎNE DE CARACTÈRES

Oui

Titre du programme.

station_name

CHAÎNE DE CARACTÈRES

Oui

Nom de la chaîne ou de la station.

content_type

CHAÎNE DE CARACTÈRES

Non

live_broadcast ou scheduled_tv.

airing_start_utc

HORODATAGE

Non

Début de diffusion du programme (UTC).

airing_end_utc

HORODATAGE

Non

Fin de diffusion du programme (UTC).

start_segment_utc

HORODATAGE

Non

Début de la session de visionnage (UTC).

end_segment_utc

HORODATAGE

Non

Fin de la session de visionnage (UTC).

seconds_viewed

LONG

Non

Secondes visualisées au cours de cette session.

vendor_sku

CHAÎNE DE CARACTÈRES

Oui

SKU du contenu (par exemple, identifiants Gracenote).

parent_channel_label

CHAÎNE DE CARACTÈRES

Oui

Identifiant de chaîne parent haché.

cid

CHAÎNE DE CARACTÈRES

Oui

ID de chaîne (effectif).

benefit_id

CHAÎNE DE CARACTÈRES

Oui

Identifiant du droit ou de l’avantage.

subscription_offer_id

CHAÎNE DE CARACTÈRES

Oui

Identifiant de l’offre d’abonnement.

subscription_event_id

CHAÎNE DE CARACTÈRES

Oui

Identifiant de l’événement d’abonnement.

subscription_offer_time_zone

CHAÎNE DE CARACTÈRES

Oui

Fuseau horaire de l’offre d’abonnement.

marketplace_id

INT

Non

Identifiant du site de vente

marketplace_desc

CHAÎNE DE CARACTÈRES

Oui

Description du site de vente.

territory

CHAÎNE DE CARACTÈRES

Oui

Code de territoire ou de pays (US, GB, DE, AU et autres).

device_class

CHAÎNE DE CARACTÈRES

Oui

Catégorie d’appareil.

device_sub_class

CHAÎNE DE CARACTÈRES

Oui

Sous-catégorie d’appareil.

connection_type

CHAÎNE DE CARACTÈRES

Oui

Type de connexion (wifi, filaire et autres).

playback_method

CHAÎNE DE CARACTÈRES

Oui

Comment s’est déroulée la session : en ligne (streaming) ou hors ligne (téléchargement). Live Linear est effectivement toujours en ligne.

geo_dma

CHAÎNE DE CARACTÈRES

Oui

DMA géographique.

stream_type

CHAÎNE DE CARACTÈRES

Non

Toujours LINEAR_TV.

Remarque sur le flux FAST : Le flux fast_linear_program_event_log a la même forme. La colonne vendor_code (code partenaire) est présente. Les colonnes d’abonnement (subscription_offer_id, subscription_event_id, subscription_offer_time_zone) sont livrées sous la forme NULL.

Comprendre is_deleted

Chaque ligne contient is_deleted. Il s’agit d’un signal concernant l’état de la programmation. Il existe deux valeurs :

Valeur

Signification

Comment l’appliquer

0

La programmation est active (version actuelle).

Insérez-le ou remplacez la ligne existante pour cette clé.

1

La programmation n’est plus active (remplacée ou retirée).

Faites en sorte qu’il n’apparaisse plus dans vos données actuelles. Supprimez la ligne ou gardez-la marquée et filtrez-la.

Quand se produit is_deleted = 1 ?

  • Correction de la programmation. Le programme ou l’heure de diffusion ont été corrigés. L’ancien session_program_schedule_id arrive sous la forme is_deleted = 1. Un nouvel identifiant arrive sous la forme is_deleted = 0. Appliquez l’ancien comme n’étant plus actif et insérez le nouveau.
  • Diffusion supprimée. La diffusion a été complètement supprimée. Son identifiant arrive sous la forme is_deleted = 1.

Informations importantes

  • Un session_program_schedule_id donné n’est jamais à la fois 0 et 1 dans le même lot. Une diffusion corrigée devient une clé différente.
  • Les lignes qui n’ont jamais répondu aux critères d’éligibilité du flux ne sont pas livrées. Ne vous attendez pas à un is_deleted = 1 pour une ligne que vous n’avez jamais reçue.

Déduplication

Vous pouvez recevoir le même session_program_schedule_id plusieurs fois. Il s’agit de versions mises à jour de la même ligne. Gérez la déduplication en trois étapes :

  1. Conservez la dernière version de chaque identifiant. Pour chaque identifiant, ne conservez que la ligne contenant le dernier last_update_time_utc et supprimez les plus anciennes. Cette valeur ne fait qu’avancer, donc la dernière l’emporte toujours.


  1. FUSIONNEZ les lignes déduites dans votre tableau. Utilisez le modèle de FUSION ci-dessous. Agissez sur is_deleted chaque fois que vous chargez des données.

Utilisez une FUSION, pas une insertion groupée. Si vous chargez chaque fichier sous forme de nouvelles lignes, les lignes is_deleted = 1 apparaissent dans votre tableau en tant que données actives au lieu d’être appliquées. Agissez toujours selon le drapeau.

  1. Alternative à la suppression logicielle. Remplacez la branche SUPPRIMER par METTRE À JOUR L’ENSEMBLE is_deleted = 1, puis filtrez WHERE is_deleted = 0 dans vos requêtes. Les deux méthodes donnent le même résultat.

Cadence d’ingestion recommandée

De nouveaux ensembles de données sont publiés progressivement au cours de la journée.

Recommandation

Détails

Cadence recommandée

1 à 4 fois par jour pour rester à jour.

Stratégie incrémentielle

Définissez startDateTime sur le dernier horodatage récupéré et endDateTime sur l’heure actuelle. Téléchargez et traitez tous les fichiers renvoyés, puis FUSIONNEZ.

Consommateurs quotidiens/hebdomadaires

Si vous effectuez des recherches tous les jours ou toutes les semaines, traitez tous les fichiers de la période. Cela vous permet de ne pas manquer les mises à jour ou les suppressions.

Remarque : Chaque lot mélange des lignes actives (is_deleted = 0) et des lignes qui ne sont plus actives (is_deleted = 1). Ces lignes ne sont pas partagées dans des fichiers séparés. La colonne is_deleted les distingue.

Exemple d’utilisation de l’API

Suivez ces étapes pour découvrir votre compte, identifier votre groupe de rapports et vos identifiants, et récupérer les fichiers de l’ensemble de données.

Étape 0 : listez vos comptes
Appelez GET /v2/accounts pour répertorier les comptes Slate auxquels vous pouvez accéder.

Étape 1 : secteurs d’activité du compte
Appelez GET /v2/accounts/12345678 pour voir les secteurs d’activité disponibles.

Le champ id est le segment de chemin {REPORT_GROUP} à utiliser lors des appels suivants.

Étape 2a : identifiants des chaînes
Appelez GET /v2/accounts/12345678/channels?offset=0&limit=100 pour répertorier les identifiants de vos chaînes.

Étape 2b : identifiants FAST
Appelez GET /v2/accounts/12345678/fast?offset=0&limit=100 pour répertorier vos identifiants FAST.

Étape 2c : ensembles de données disponibles pour un identifiant
Appelez GET /v2/accounts/12345678/fast/ABC123/datasets pour répertorier les ensembles de données disponibles.

Étape 3a : fichiers de jeu de données de chaînes
Appelez le point de terminaison des fichiers du jeu de données pour l’identifiant de vos chaînes. La réponse renvoie une liste d’URL de téléchargement pour les fichiers CSV compressés au format gzip.

Étape 3b : fichiers de jeu de données FAST
Appelez le point de terminaison des fichiers de jeu de données pour votre identifiant FAST.

Exemples de requêtes

Ces requêtes supposent que vous avez déjà FUSIONNÉ vos données. Si vous conservez les lignes is_deleted dans un tableau brut, ajoutez WHERE is_deleted = 0 à chaque requête.

Heures de visionnage par station au cours d’une période

Les X meilleurs programmes selon le nombre d’heures de visionnage

Résumé des visionnages quotidiens

Heures de visionnage par territoire

Pipeline ETL

Utilisez ce modèle en quatre étapes pour créer votre pipeline ETL pour le jeu de données Live Linear Program.

  1. Collecte initiale des données. Collectez tous les fichiers de votre chaîne dans les délais souhaités à l’aide du point de terminaison de l’API. Téléchargez tous les fichiers renvoyés. Chacun contient des lignes au format CSV compressé au format GZIP.
  2. Dédupliquer. Lorsque plusieurs enregistrements existent pour le même session_program_schedule_id dans les fichiers que vous avez extraits, ne conservez que la ligne contenant le dernier last_update_time_utc. Consultez la section Déduplication pour obtenir le modèle SQL complet.
  3. Appliquez à la destination. FUSIONNEZ les enregistrements dédupliqués dans votre tableau de destination saisi sur session_program_schedule_id. Mettez à jour et insérez sur is_deleted = 0. Sur is_deleted = 1, faites en sorte que l’identifiant cesse d’apparaître dans vos données actuelles. Supprimez-le en dur ou laissez la ligne marquée et filtrez-la.
  4. Traitement incrémentiel. pour les chargements continus, définissez sur l’heure de la dernière collecte et endDateTime sur l’heure actuelle. Traitez tous les fichiers renvoyés et faites FUSIONNEZ dans votre destination.


Conseils rapides

Gardez ces conseils à l’esprit lorsque vous intégrez l’API dans votre pipeline.

  1. session_program_schedule_id est votre clé unique. Dédupliquez toujours à l’aide de last_update_time_utc.
  2. Utilisez une FUSION, pas une insertion groupée. Agissez sur les signaux is_deleted chaque fois que vous chargez des données.
  3. Tirez 1 à 4 fois par jour pour obtenir les données les plus récentes.
  4. Définissez votre startDateTime sur le dernier horodatage réussi pour les chargements incrémentiels.
  5. Utilisez les points de terminaison de découverte pour trouver votre compte, vos identifiants et les jeux de données disponibles.
  6. Tirez à la fois sur les chaînes et sur les flux FAST si votre partenariat couvre les deux.
  7. Ajoutez WHERE is_deleted = 0 à toutes les requêtes si vous utilisez l’approche de suppression logicielle.
  8. La durée de conservation maximale des données est de 2 ans. Planifiez vos tirages historiques en conséquence.

Le saviez-vous ?

L’accès programmatique aux données d’audience au niveau du programme vous permet de créer des rapports personnalisés, d’alimenter vos systèmes de programmation et de combiner des données linéaires avec vos autres données commerciales. Les partenaires qui intègrent cette API à leurs flux de travail prennent des décisions plus rapides et plus éclairées en matière de programmation et d’acquisition de contenu.

Pour une analyse visuelle et des informations rapides, consultez le tableau de bord de programmation linéaire sur Slate Analytics.

Foire aux questions

FAQ sur l’API de l’ensemble de données du Programme linéaire en direct

Toujours besoin d’aide?

Contactez-nous

Dans ce guide



Erreur de serveur interne ! Veuillez réessayer
Votre session a expiré

Merci de vous connecter pour continuer

Connexion
edit