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 |
|
Ü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:
curl -X GET \
-H "Authorization: Bearer Atza|auth_token" \
"https://videocentral.amazon.com/apis/v2/accounts/{ACADIA_ID}/{REPORT_GROUP}/{IDENTIFIER_ID}/datasets/{REPORT_ID}\
?startDateTime=YYYY-MM-DDThh:mm:ssZ\
&endDateTime=YYYY-MM-DDThh:mm:ssZ\
&offset=0&limit=1000"
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:
- 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.
SELECT *
FROM (
SELECT *,
ROW_NUMBER() OVER (
PARTITION BY session_program_schedule_id
ORDER BY last_update_time_utc DESC
) AS rn
FROM your_staging_table
) t
WHERE rn = 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.
MERGE INTO your_table AS target USING dedup_staging AS source ON target.session_program_schedule_id = source.session_program_schedule_id WHEN MATCHED AND source.is_deleted = 1 AND source.last_update_time_utc > target.last_update_time_utc THEN DELETE WHEN MATCHED AND source.is_deleted = 0 AND source.last_update_time_utc > target.last_update_time_utc THEN UPDATE SET program_title = source.program_title, seconds_viewed = source.seconds_viewed, airing_start_utc = source.airing_start_utc, airing_end_utc = source.airing_end_utc, last_update_time_utc = source.last_update_time_utc -- ... all other columns WHEN NOT MATCHED AND source.is_deleted = 0 THEN INSERT (session_program_schedule_id, session_id, program_id, ..., last_update_time_utc) VALUES (source.session_program_schedule_id, source.session_id, source.program_id, ..., source.last_update_time_utc);
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. |
- 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. {
"total": 1,
"next": null,
"data": [
{ "id": "12345678", "name": "MGM" }
]
}
Schritt 1: Geschäftsbereiche für das Konto
Rufen Sie GET /v2/accounts/12345678 auf, um die verfügbaren Geschäftsbereiche anzuzeigen. {
"total": 2,
"next": null,
"data": [
{ "id": "channels", "name": "Channels" },
{ "id": "fast", "name": "FAST" }
]
}
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. {
"total": 2,
"next": null,
"data": [
{ "id": "3f6c1b9d-8a2d-4e7f-9c31-0d5b7b2e6f14", "name": "MGM+" },
{ "id": "a91d4c21-57e0-4b8a-b6f3-2e9c0e1f8b77", "name": "MGM+ Espanol" }
]
}
Schritt 2b: FAST-Identifikatoren
Rufen Sie GET /v2/accounts/12345678/fast?offset=0&limit=100 auf, um Ihre FAST-Identifikatoren aufzulisten. {
"total": 1,
"next": null,
"data": [
{ "id": "ABC123", "name": "MGM FAST" }
]
}
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. {
"total": 1,
"next": null,
"data": [
{ "id": "fast_linear_program_event_log", "name": "FAST Linear Program Event Log" }
]
}
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. GET /v2/accounts/12345678/channels/3f6c1b9d-8a2d-4e7f-9c31-0d5b7b2e6f14
/datasets/linear_program_event_log
?startDateTime=2026-09-14T00:00:00Z&endDateTime=2026-09-15T00:00:00Z&offset=0&limit=1000
{
"total": 3,
"next": null,
"data": [
{ "downloadUrl": "https://pvreporting-datasets-prod.s3.amazonaws.com/linear_program_event_log/
3f6c1b9d.../2026/09/14/06/...linear_2f0c...e91a.csv.gz?X-Amz-Algorithm=..." },
{ "downloadUrl": "https://pvreporting-datasets-prod.s3.amazonaws.com/linear_program_event_log/
3f6c1b9d.../2026/09/14/14/...linear_7b41...03cd.csv.gz?..." },
{ "downloadUrl": "https://pvreporting-datasets-prod.s3.amazonaws.com/linear_program_event_log/
3f6c1b9d.../2026/09/14/22/...linear_c8d9...5e60.csv.gz?..." }
]
}
Schritt 3b: FAST-Datensatzdateien
Rufen Sie den Endpunkt für Datensatzdateien für Ihren FAST-Identifikator auf. GET /v2/accounts/12345678/fast/ABC123/datasets/fast_linear_program_event_log
?startDateTime=2026-09-14T00:00:00Z&endDateTime=2026-09-15T00:00:00Z&offset=0&limit=1000
{
"total": 1,
"next": null,
"data": [
{ "downloadUrl": "https://pvreporting-datasets-prod.s3.amazonaws.com/fast_linear_program_event_log/
ABC123/2026/09/14/15/...fast_linear_c258fb25...758add.csv.gz?X-Amz-Algorithm=..." }
]
}
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 ZeitraumSELECT station_name,
COUNT(*) AS sessions,
SUM(seconds_viewed) / 3600.0 AS hours_viewed
FROM your_table
WHERE start_segment_utc BETWEEN '[START_DATE]' AND '[END_DATE]'
GROUP BY station_name
ORDER BY hours_viewed DESC;
Top-X-Programme nach angesehenen StundenSELECT program_title, station_name,
SUM(seconds_viewed) / 3600.0 AS hours_viewed
FROM your_table
WHERE start_segment_utc BETWEEN '[START_DATE]' AND '[END_DATE]'
GROUP BY program_title, station_name
ORDER BY hours_viewed DESC
LIMIT [X];
Zusammenfassung der täglichen WiedergabeSELECT DATE(start_segment_utc) AS view_date,
COUNT(*) AS sessions,
SUM(seconds_viewed) / 3600.0 AS hours_viewed
FROM your_table
WHERE start_segment_utc BETWEEN '[START_DATE]' AND '[END_DATE]'
GROUP BY DATE(start_segment_utc)
ORDER BY view_date DESC;
Angesehene Stunden nach GebietSELECT territory,
SUM(seconds_viewed) / 3600.0 AS hours_viewed
FROM your_table
WHERE start_segment_utc BETWEEN '[START_DATE]' AND '[END_DATE]'
GROUP BY territory
ORDER BY hours_viewed DESC;
ETL-Pipeline
Verwenden Sie dieses vierstufige Muster, um Ihre ETL-Pipeline für den Datensatz für lineare Live-Programme zu erstellen.
- 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.
- 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.
- 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.
- 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.
startDateTime = {last_successful_pull_timestamp}
endDateTime = {current_utc_timestamp}
Schnelle Tipps
Beachten Sie diese Tipps, wenn Sie die API in Ihre Pipeline integrieren.
- session_program_schedule_id ist Ihr eindeutiger Schlüssel. Führen Sie die Deduplizierung immer anhand von last_update_time_utc durch.
- Verwenden Sie MERGE und keinen Bulk-Insert. Berücksichtigen Sie bei jedem Laden von Daten die is_deleted-Signale.
- Rufen Sie die Daten 1- bis 4-mal täglich ab, um möglichst aktuelle Daten zu erhalten.
- Setzen Sie startDateTime für inkrementelle Ladevorgänge auf den Zeitstempel des letzten erfolgreichen Abrufs.
- Verwenden Sie die Discovery-Endpunkte, um Ihr Konto, die Identifikatoren und die verfügbaren Datensätze zu ermitteln.
- Rufen Sie sowohl den Channels- als auch den FAST-Feed ab, wenn Ihre Vereinbarung beide umfasst.
- Fügen Sie allen Abfragen WHERE is_deleted = 0 hinzu, wenn Sie den Soft-Delete-Ansatz verwenden.
- 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. |