API für den Datensatz für lineare Live-Programme

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

~15 Min. Lesezeit Oktober 2, 2026

Dieser Leitfaden enthält alle Informationen, die Sie für den Zugriff auf die API für den Datensatz für lineare Live-Programme und deren Nutzung benötigen

Was Sie erfahren werden

  • Was die API bereitstellt und welche Feeds verfügbar sind.
  • Wie Sie sich authentifizieren und Datensatzdateien abrufen.
  • Das vollständige Datenmodell und die Spaltendefinitionen.
  • Wie das Changelog und das is_deleted-Signal funktionieren.
  • Deduplizierungs- und MERGE-Muster, die Sie in Ihre Pipeline übernehmen können.
  • Empfohlene Ingestion-Häufigkeit.
  • Beispiel-SQL-Abfragen für gängige Analysen.

Übersicht

Die API für den Datensatz für lineare Live-Programme stellt Ihnen Zuschauerdaten auf Programmebene für Ihre linearen Live- und FAST-Kanäle auf Prime Video bereit. Jeder Datensatz entspricht einer Wiedergabesitzung eines geplanten Programms auf einem Kanal.

Die Daten werden als Changelog mit is_deleted-Signalen für Korrekturen am Programmplan bereitgestellt. Es sind zwei Feeds verfügbar: Channels (linear_program_event_log) und FAST (fast_linear_program_event_log).

Mit diesen Daten können Sie:

  • Zuschauerdaten auf Programmebene (angesehene Stunden, Sitzungen) nach Sendern, Gebieten, Geräten und Zeitraum verfolgen.
  • Die Leistung nach Sender, Programm, Serie und Inhaltstyp analysieren.
  • Korrekturen am Programmplan präzise nachvollziehen, ohne dass veraltete Zeilen in Ihren Daten verbleiben.
  • Zuschauerdaten für lineare Live-Inhalte in Ihre internen Systeme und Datenquellen integrieren.

Informationen zur Dashboard-basierten Analyse finden Sie unter: Linear Programming in Slate Analytics

Wichtige Funktionen

Funktion

Details

Detailgenauigkeit auf Programmebene

Eine Zeile pro Wiedergabesitzung, Programm und Programmplan. Enthält Titel, Sender, Serie, Ausstrahlungszeitraum und Wiedergabezeit.

Entfernungssignal

Ersetzte oder zurückgezogene Programmpläne werden erneut mit is_deleted = 1 gesendet. Dies signalisiert, dass sie nicht mehr gültig sind.

Stabiler eindeutiger Schlüssel

Jede Zeile enthält session_program_schedule_id. Verwenden Sie ihn zum Deduplizieren und für MERGE.

Vereinfachte Ingestion

Changelog-Modell. Planen Sie wiederkehrende Aufrufe und führen Sie anschließend MERGE aus. Führen Sie bei is_deleted = 0 einen Upsert aus. Führen Sie bei is_deleted = 1 einen Hard Delete oder Soft Delete durch.

Konsistenz

Einheitliche Formatierung für alle Gebiete in einer einzigen Quelle. Es sind keine separaten Dimensionstabellen für die einzelnen Gebiete erforderlich.

Schlüsselkonzepte

Konzept

Beschreibung

Zeile für Sitzung, Programm und Programmplan

Eine Wiedergabesitzung eines Programms in einem geplanten Sendezeitfenster. Identifiziert durch session_program_schedule_id.

Changelog-Modell

Die Daten werden als Changelog bereitgestellt. Wenn sich die Attribute einer Zeile ändern, wird eine neue Version mit derselben session_program_schedule_id und einer neueren last_update_time_utc veröffentlicht.

Primärschlüssel

session_program_schedule_id ist der eindeutige Bezeichner. Führen Sie die Deduplizierung immer anhand dieses Feldes durch.

is_deleted-Signal

is_deleted = 0 bedeutet, dass der Programmplan aktiv ist. is_deleted = 1 signalisiert, dass der Programmplan nicht mehr aktiv oder gültig ist.

Signal anwenden

is_deleted = 0: Fügen Sie die Zeile ein oder aktualisieren Sie sie. is_deleted = 1: Sorgen Sie dafür, dass die Zeile nicht mehr in Ihren aktuellen Daten erscheint. Entfernen Sie die Zeile oder behalten Sie sie als markiert bei und filtern Sie sie heraus.

Erste Schritte

Onboarding
Die API für den Datensatz für lineare Live-Programme ist Teil der Analytics API Suite. Beim Onboarding für die Analytics API Suite erhalten Sie Zugriff auf alle verfügbaren APIs dieser Suite, einschließlich der API für den Datensatz für lineare Live-Programme (sofern beim Onboarding angefordert). Eine ausführliche Anleitung zum Onboarding finden Sie auf der Seite Analytics API Onboarding.

Voraussetzungen
Bevor Sie API-Anfragen stellen können, benötigen Sie Folgendes:

  • Ein Anmelden mit Amazon (LWA)-Sicherheitsprofil. Senden Sie Ihre Client-ID an Ihren CAM, damit sie der internen PV-Administrationsseite hinzugefügt werden kann.
  • Einen Autorisierungscode zum Anfordern eines Tokens.
  • Ein Token für alle API-Anfragen.

Basis-URI: https://videocentral.amazon.com/apis/v2

Alle Anfragen müssen ein gültiges LWA-Authentifizierungstoken im Authorization-Header enthalten. Wenn das Token fehlt oder abgelaufen ist, gibt die API eine Ausnahme wegen fehlender Autorisierung zurück.

Seitennummerierung
Alle Antworten werden seitenweise ausgegeben. Verwenden Sie diese Parameter, um durch die Seiten zu navigieren:

Parameter

Standardwert

Beschreibung

limit

10

Anzahl der pro Seite zurückgegebenen Dokumente. Maximal 1.000.

offset

0

Anzahl der Dokumente, die vor dem ersten Ergebnis übersprungen werden sollen. Folgen Sie der next-URL, anstatt sie selbst zu berechnen.

Alle paginierten Antworten enthalten die folgenden Felder:

Feld

Beschreibung

total

Gesamtzahl der Dokumente über alle Seiten hinweg.

next

URL der nächsten Seite. null, wenn dies die letzte Seite ist.

Datensatzdateien abrufen

Endpunkt
Verwenden Sie diesen curl-Befehl, um eine Liste mit Links zu herunterladbaren Datensatzdateien abzurufen:

Hinweis: Dieser Endpunkt gibt Links zu herunterladbaren, gzip-komprimierten CSV-Dateien zurück, nicht die Zeilen selbst.

Parameter

Parameter

Beschreibung

ACADIA_ID

Ihre Slate-Konto-ID. Sie finden sie unter /v2/accounts.

REPORT_GROUP

Das Geschäftsbereichssegment. Verwenden Sie channels für den Channels-Feed oder fast für den FAST-Feed. Ermitteln Sie Ihren Wert mit GET /v2/accounts/{ACADIA_ID}.

IDENTIFIER_ID

Der vom Endpunkt identifiers zurückgegebene ID-Wert. Für Channels ist dies ein nicht interpretierbarer Hashwert. Verwenden Sie das Feld id unverändert. Bei FAST ist dies Ihr Lieferantencode, der ungehasht zurückgegeben wird.

REPORT_ID

Gibt an, welcher Bericht abgerufen werden soll. Verwenden Sie linear_program_event_log für Channels oder fast_linear_program_event_log für FAST.

startDateTime

Legen Sie hier den Zeitpunkt Ihres letzten Abrufs fest. Format: YYYY-MM-DDThh:mm:ssZ (UTC).

endDateTime

Legen Sie hier die aktuelle Uhrzeit fest. Format: YYYY-MM-DDThh:mm:ssZ (UTC).

limit

Mindestens 1, maximal 1.000 Links pro Seite.

Verfügbare Berichte
Es sind zwei Berichte verfügbar. Rufen Sie jeden Bericht separat ab, indem Sie seine Berichts-ID in das Pfadsegment datasets/{REPORT_ID} einfügen:

Bericht

Berichts-ID

Inhalt

Channels

linear_program_event_log

Lineare SVOD-/Abonnementinhalte (3P_SUBS sowie FREE/PRIME, sofern zutreffend).

FAST

fast_linear_program_event_log

Werbefinanziertes Fernsehen/werbefinanzierte lineare Kanäle (AVOD)

Hinweis: Die maximale Aufbewahrungsdauer der Daten beträgt 2 Jahre. Anfragen für Daten, die älter als 2 Jahre sind, liefern keine Ergebnisse.

Discovery-Endpunkte

Verwenden Sie diese Endpunkte, um Ihre Konto-ID, Berichtsgruppen, Identifikatoren und verfügbaren Datensätze zu ermitteln:

Endpunkt

Rückgabe

GET /v2/accounts

Liste der Slate-Konten, auf die Sie zugreifen können.

GET /v2/accounts/{ACADIA_ID}

Verfügbare Geschäftsbereiche (z. B. channels, fast).

GET /v2/accounts/{ACADIA_ID}/channels

Für Sie verfügbare Berichtsidentifikatoren. Jeder Eintrag enthält eine id und einen aussagekräftigen Namen.

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

Für diesen Identifikator verfügbare Datensätze.

Datenspalten

Der Feed linear_program_event_log (Channels) enthält die folgenden Spalten. Der Feed fast_linear_program_event_log (FAST) hat dieselbe Struktur, wobei vendor_code hinzugefügt wird und die Abonnementspalten als NULL bereitgestellt werden.

Spalte

Typ

Kann NULL sein

Beschreibung

session_program_schedule_id

STRING

Nein

Primärschlüssel Eindeutige ID (codiert Sitzung, Programm und Sendezeitfenster). Führen Sie die Deduplizierung und MERGE anhand dieses Feldes durch. Ändert sich, wenn sich das Programm oder die Sendezeit aufgrund aktualisierter EPG-Metadaten ändert.

session_id

STRING

Nein

Anonymisierter eindeutiger Bezeichner der Wiedergabesitzung.

is_deleted

INT

Nein

Statussignal. 0 = Programmplan ist aktiv. 1 = Programmplan ist nicht mehr aktiv (ersetzt oder zurückgezogen). Schließen Sie Zeilen mit is_deleted = 1 aus Ihren aktuellen Daten aus.

last_update_time_utc

TIMESTAMP

Nein

Zeitpunkt der Datensatzversion. Immer zur Deduplizierung verwenden. Behalten Sie für eine bestimmte ID die Zeile mit dem neuesten Wert bei.

create_time_utc

TIMESTAMP

Nein

Zeitpunkt, zu dem die Zeile erstmals erstellt wurde.

program_id

STRING

Nein

Programm-ID, z. B. TMS-ID.

pv_title_id

STRING

Ja

Prime Video Global Title Identifier (GTI) für das Programm. Entspricht pv_title_id im TVOD-Feed.

program_title

STRING

Ja

Programmtitel.

station_name

STRING

Ja

Kanal- oder Sendername.

content_type

STRING

Nein

live_broadcast oder scheduled_tv.

airing_start_utc

TIMESTAMP

Nein

Beginn der Programmausstrahlung (UTC).

airing_end_utc

TIMESTAMP

Nein

Ende der Programmausstrahlung (UTC).

start_segment_utc

TIMESTAMP

Nein

Beginn der Wiedergabesitzung (UTC).

end_segment_utc

TIMESTAMP

Nein

Ende der Wiedergabesitzung (UTC).

seconds_viewed

LONG

Nein

In dieser Wiedergabesitzung angesehene Sekunden.

vendor_sku

STRING

Ja

Inhalts-SKU (z. B. Gracenote-Identifikatoren).

parent_channel_label

STRING

Ja

Gehashter Bezeichner des übergeordneten Kanals.

cid

STRING

Ja

Effektive Kanal-ID.

benefit_id

STRING

Ja

Berechtigungs-/Leistungs-ID.

subscription_offer_id

STRING

Ja

ID des Abonnementangebots.

subscription_event_id

STRING

Ja

ID des Abonnementereignisses.

subscription_offer_time_zone

STRING

Ja

Zeitzone des Abonnementangebots.

marketplace_id

INT

Nein

Onlineshop-ID.

marketplace_desc

STRING

Ja

Onlineshop-Beschreibung.

territory

STRING

Ja

Gebiets- oder Ländercode (US, GB, DE, AU und weitere).

device_class

STRING

Ja

Gerätekategorie.

device_sub_class

STRING

Ja

Geräteunterkategorie.

connection_type

STRING

Ja

Verbindungstyp (WLAN, kabelgebunden und weitere).

playback_method

STRING

Ja

Art der Wiedergabe in der Sitzung: online (Streaming) oder offline (Download). Lineare Live-Inhalte werden praktisch immer online wiedergegeben.

geo_dma

STRING

Ja

Geografische DMA.

stream_type

STRING

Nein

Immer LINEAR_TV.

Hinweis zum FAST-Feed: Der Feed fast_linear_program_event_log hat dieselbe Struktur. Die Spalte vendor_code (Lieferantencode) ist vorhanden. Die Abonnementspalten (subscription_offer_id, subscription_event_id, subscription_offer_time_zone) werden als NULL bereitgestellt.

is_deleted verstehen

Jede Zeile enthält is_deleted. Dieses Feld signalisiert den Status des Programmplans. Es gibt zwei Werte:

Wert

Bedeutung

Anwendung

0

Der Programmplan ist aktiv (aktuelle Version).

Fügen Sie die Zeile ein oder überschreiben Sie die für diesen Schlüssel vorhandene Zeile.

1

Der Programmplan ist nicht mehr aktiv (ersetzt oder zurückgezogen).

Sorgen Sie dafür, dass die Zeile nicht mehr in Ihren aktuellen Daten erscheint. Entfernen Sie die Zeile oder behalten Sie sie als markiert bei und filtern Sie sie heraus.

Wann tritt is_deleted = 1 auf?

  • Korrektur des Programmplans. Das Programm oder die Sendezeit wurde korrigiert. Die alte session_program_schedule_id wird mit is_deleted = 1 bereitgestellt. Eine neue ID wird mit is_deleted = 0 bereitgestellt. Behandeln Sie die alte ID als nicht mehr aktiv und fügen Sie die neue ein.
  • Ausstrahlung entfernt. Die Ausstrahlung wurde vollständig zurückgezogen. Die zugehörige ID wird mit is_deleted = 1 bereitgestellt.

Wichtige Hinweise

  • Eine bestimmte session_program_schedule_id hat innerhalb desselben Batches niemals sowohl den Wert 0 als auch den Wert 1. Eine korrigierte Ausstrahlung erhält einen anderen Schlüssel.
  • Zeilen, die die Eignungskriterien des Feeds nie erfüllt haben, werden nicht bereitgestellt. Erwarten Sie für eine Zeile, die Sie nie erhalten haben, kein is_deleted = 1.

Deduplizierung

Sie erhalten möglicherweise dieselbe session_program_schedule_id mehrmals. Dabei handelt es sich um aktualisierte Versionen derselben Zeile. Führen Sie die Deduplizierung in drei Schritten durch:

  1. Behalten Sie die neueste Version jeder ID bei. Behalten Sie für jede ID nur die Zeile mit dem neuesten last_update_time_utc bei und entfernen Sie die älteren Zeilen. Dieser Wert wird nur fortlaufend aktualisiert, sodass immer der neueste Wert maßgeblich ist.


  1. Führen Sie die deduplizierten Zeilen mit MERGE in Ihre Tabelle ein. Verwenden Sie das nachfolgende MERGE-Muster. Berücksichtigen Sie is_deleted bei jedem Laden von Daten.

Verwenden Sie MERGE und keinen Bulk-Insert. Wenn Sie jede Datei als neue Zeilen laden, verbleiben Zeilen mit is_deleted = 1 als aktive Daten in Ihrer Tabelle, anstatt entsprechend verarbeitet zu werden. Berücksichtigen Sie das Flag immer.

  1. Alternative mit Soft Delete. Ersetzen Sie den DELETE-Zweig durch UPDATE SET is_deleted = 1 und filtern Sie anschließend in Ihren Abfragen mit WHERE is_deleted = 0. Beide Methoden liefern dasselbe Ergebnis.

Empfohlene Ingestion-Häufigkeit

Neue Datensätze werden im Laufe des Tages schrittweise veröffentlicht.

Empfehlung

Details

Empfohlene Häufigkeit

1- bis 4-mal täglich, um auf dem aktuellen Stand zu bleiben.

Inkrementelle Strategie

Setzen Sie startDateTime auf den Zeitstempel des letzten Abrufs und endDateTime auf die aktuelle Uhrzeit. Laden Sie alle zurückgegebenen Dateien herunter, verarbeiten Sie sie und führen Sie anschließend MERGE aus.

Tägliche/wöchentliche Datenabrufe

Wenn Sie die Daten täglich oder wöchentlich abrufen, verarbeiten Sie alle Dateien für den jeweiligen Zeitraum. So stellen Sie sicher, dass Ihnen keine Aktualisierungen oder Löschungen entgehen.

Hinweis: Jeder Batch enthält sowohl aktive Zeilen (is_deleted = 0) als auch nicht mehr aktive Zeilen (is_deleted = 1). Sie werden nicht in separaten Dateien bereitgestellt. Anhand der Spalte is_deleted lassen sie sich unterscheiden.

Beispiel für die API-Nutzung

Führen Sie die folgenden Schritte aus, um Ihr Konto zu ermitteln, Ihre Berichtsgruppe und Identifikatoren zu bestimmen und Datensatzdateien abzurufen.

Schritt 0: Ihre Konten auflisten
Rufen Sie GET /v2/accounts auf, um die Slate-Konten aufzulisten, auf die Sie zugreifen können.

Schritt 1: Geschäftsbereiche für das Konto
Rufen Sie GET /v2/accounts/12345678 auf, um die verfügbaren Geschäftsbereiche anzuzeigen.

Das Feld id ist das {REPORT_GROUP} Pfadsegment, das Sie in nachfolgenden Aufrufen verwenden müssen.

Schritt 2a: Channels-Identifikatoren
Rufen Sie GET /v2/accounts/12345678/channels?offset=0&limit=100 auf, um Ihre Channels-Identifikatoren aufzulisten.

Schritt 2b: FAST-Identifikatoren
Rufen Sie GET /v2/accounts/12345678/fast?offset=0&limit=100 auf, um Ihre FAST-Identifikatoren aufzulisten.

Schritt 2c: Für einen Identifikator verfügbare Datensätze
Rufen Sie GET /v2/accounts/12345678/fast/ABC123/datasets auf, um die verfügbaren Datensätze aufzulisten.

Schritt 3a: Channels-Datensatzdateien
Rufen Sie den Endpunkt für Datensatzdateien für Ihren Channels-Identifikator auf. Die Antwort gibt eine Liste mit Download-URLs für gzip-komprimierte CSV-Dateien zurück.

Schritt 3b: FAST-Datensatzdateien
Rufen Sie den Endpunkt für Datensatzdateien für Ihren FAST-Identifikator auf.

Beispielabfragen

Bei diesen Abfragen wird davon ausgegangen, dass Sie Ihre Daten bereits mit MERGE zusammengeführt haben. Wenn Sie is_deleted-Zeilen in einer Rohtabelle beibehalten, fügen Sie jeder Abfrage WHERE is_deleted = 0 hinzu.

Angesehene Stunden nach Sender über einen bestimmten Zeitraum

Top-X-Programme nach angesehenen Stunden

Zusammenfassung der täglichen Wiedergabe

Angesehene Stunden nach Gebiet

ETL-Pipeline

Verwenden Sie dieses vierstufige Muster, um Ihre ETL-Pipeline für den Datensatz für lineare Live-Programme zu erstellen.

  1. Erster Datenabruf. Rufen Sie über den API-Endpunkt alle Dateien für Ihren Kanal innerhalb des gewünschten Zeitraums ab. Laden Sie alle zurückgegebenen Dateien herunter. Jede Datei enthält Zeilen im gzip-komprimierten CSV-Format.
  2. Deduplizieren Sie die Daten. Wenn die abgerufenen Dateien mehrere Datensätze mit derselben session_program_schedule_id enthalten, behalten Sie nur die Zeile mit dem neuesten last_update_time_utc bei. Das vollständige SQL-Muster finden Sie im Abschnitt Deduplizierung.
  3. Auf die Zieltabelle anwenden. Führen Sie die deduplizierten Datensätze anhand von session_program_schedule_id mit MERGE in Ihrer Zieltabelle zusammen. Führen Sie bei is_deleted = 0 einen Upsert aus. Sorgen Sie bei is_deleted = 1 dafür, dass die ID nicht mehr in Ihren aktuellen Daten erscheint. Führen Sie einen Hard Delete durch oder behalten Sie die Zeile als markiert bei und filtern Sie sie heraus.
  4. Inkrementelle Verarbeitung. Setzen Sie für fortlaufende Ladevorgänge auf den Zeitpunkt des letzten Abrufs und endDateTime auf die aktuelle Uhrzeit. Verarbeiten Sie alle zurückgegebenen Dateien und führen Sie sie mit MERGE in Ihr Zielsystem ein.


Schnelle Tipps

Beachten Sie diese Tipps, wenn Sie die API in Ihre Pipeline integrieren.

  1. session_program_schedule_id ist Ihr eindeutiger Schlüssel. Führen Sie die Deduplizierung immer anhand von last_update_time_utc durch.
  2. Verwenden Sie MERGE und keinen Bulk-Insert. Berücksichtigen Sie bei jedem Laden von Daten die is_deleted-Signale.
  3. Rufen Sie die Daten 1- bis 4-mal täglich ab, um möglichst aktuelle Daten zu erhalten.
  4. Setzen Sie startDateTime für inkrementelle Ladevorgänge auf den Zeitstempel des letzten erfolgreichen Abrufs.
  5. Verwenden Sie die Discovery-Endpunkte, um Ihr Konto, die Identifikatoren und die verfügbaren Datensätze zu ermitteln.
  6. Rufen Sie sowohl den Channels- als auch den FAST-Feed ab, wenn Ihre Vereinbarung beide umfasst.
  7. Fügen Sie allen Abfragen WHERE is_deleted = 0 hinzu, wenn Sie den Soft-Delete-Ansatz verwenden.
  8. Die maximale Aufbewahrungsdauer der Daten beträgt 2 Jahre. Planen Sie Ihre Abrufe historischer Daten entsprechend.

Schon gewusst?

Durch den programmatischen Zugriff auf Zuschauerdaten auf Programmebene können Sie benutzerdefinierte Berichte erstellen, Ihre Planungssysteme mit Daten versorgen und lineare Daten mit Ihren anderen Geschäftsdaten kombinieren. Inhaltsanbieter, die diese API in ihre Workflows integrieren, können schneller fundierte Entscheidungen über die Programmplanung und den Erwerb von Inhalten treffen.

Für visuelle Analysen und schnelle Einblicke besuchen Sie das Dashboard Linear Programming in Slate Analytics.

Häufig gestellte Fragen

Häufig gestellte Fragen zur Live Linear Programm Dataset API

Brauchen Sie noch Hilfe?

Kontaktieren Sie uns

In diesem Leitfaden



Interner Ferhler! Bitte erneut versuchen
Die Sitzung ist abgelaufen.

Melden Sie sich an, um fortzufahren.

Anmelden
edit