Hochladen von Zeitplandaten zur Verfolgung von Live-Inhalten

liest aus dem Programmzeitplan-Datensatz nach Programmzeitplänen-Datensätzen und filtert nach dem Datum des Zeitplans.

Funktioniert nur für Programme, die zwischen 24 und 48 Stunden in der Vergangenheit aufgetreten sind.

Liest die Mediennutzungsereignisse aus dem Mediendatensatz und filtert nach Datum und XDM-Pfad in den Programmplaneinträgen.

Für jedes Medienabschlussereignis wird dieselbe Anzahl von Medienzeitplan-Startereignissen generiert, wie es Shows gab, die sich mit der Mediensitzung überschnitten.

Jedes Medienzeitplan-Startereignis enthält den Namen und die Länge des Zeitplans.

Außerdem enthält eine neue Zeitmetrik namens scheduleTimePlayed die Anzahl der Sekunden, die die Mediensitzung mit dem geplanten Programm überschnitten hat. Der Zeitstempel des geplanten Startereignisses ist der Zeitstempel des Starts der Sendung.

Schreibt die neuen geplanten Startereignisse in den AEP-Mediensatz.

Erstellen Sie ein Schema basierend auf der XDM Klasse „Geplantes-Programm für Media Analytics“.

Dies ist die XDM-Definition der Klasse „Geplantes Programm für Media Analytics“.

https://github.com/adobe/xdm/blob/master/components/fieldgroups/tv-schedule/media-analytics-scheduled-program.schema.json

Erstellen Sie einen Datensatz basierend auf dem von Ihnen erstellten Schema.

Fahren Sie mit dem folgenden Abschnitt fort: Informationen zum Push-Zeitplan.

Erstellen Sie eine JSON-Datei mit den Zeitplaninformationen.

Die JSON-Datei muss ein Array von Zeitplanprogrammobjekten gemäß dem XDM-Schema enthalten.

Laden Sie die JSON-Datei hoch:

1. Erstellen Sie einen neuen Batch und rufen Sie dann die Batch-ID aus der Antwort ab.

   Betrachten Sie das folgende Beispiel der Verwendung von cURL zum Erstellen eines neuen AEP-Batches:

   code language-none

   curl -i 'https://platform.adobe.io/data/foundation/import/batches' \ -X POST \ -H 'Accept: application/json' \ -H 'x-api-key: <CUSTOMER_API_KEY>' \ -H 'x-gw-ims-org-id: <CUSTOMER_ORG_ID>' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer <OAUTH_TOKEN>' \ --data-raw '{"datasetId":"<DATASET_ID>","inputFormat":{"format":"json","isMultiLineJson":true},"tags":{"test":["2"]}}' HTTP/1.1 201 Created { "id": "BATCH_ID", "imsOrg": "CUSTOMER_ORG_ID", "updated": 1749838941763, "status": "loading", "created": 1749838941763, "relatedObjects": [ { "type": "dataSet", "id": "DATASET_ID" } ], "version": "1.0.0", ............ }

2. Pushen Sie die JSON-Datei, die die Programmplanungs-Datensätze enthält, unter Verwendung der Batch-ID.

   Verwenden Sie zum Übertragen von Zeitplandaten die Batch-APIs von AEP, wie unter Übersicht über die Batch-Aufnahme-API beschrieben.

   Betrachten wir das folgende Beispiel für die Verwendung von cURL zum Pushen einer Datei mit den Zeitplandatensätzen:

   code language-none
   curl -i 'https://platform.adobe.io/data/foundation/import/batches/<BATCH_ID>/datasets/<DATASET_ID>/files/<FILE_NAME>' \ -X PUT \ -H 'x-api-key: <CUSTOMER_API_KEY>' \ -H 'x-gw-ims-org-id: <CUSTOMER_ORG_ID>' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer <OAUTH_TOKEN>' \ --upload-file ./schedule_21_05_2025.json`

3. Füllen Sie den Batch aus.

   Betrachten Sie das folgende Beispiel der Verwendung von cURL, um den Batch abzuschließen:

   code language-none
   curl -i 'https://platform.adobe.io/data/foundation/import/batches/<BATCH_ID>?action=COMPLETE' \ -X POST \ -H 'x-api-key: <CUSTOMER_API_KEY>' \ -H 'x-gw-ims-org-id: <CUSTOMER_ORG_ID>' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer <OAUTH_TOKEN>'

Fahren Sie mit dem folgenden Abschnitt fort: ​ eines Support-Tickets bei der Adobe-Kundenunterstützung.

mediaProgramDetails: Muss die zum Erstellen des geplanten Startereignisses mindestens erforderlichen Informationen enthalten:

• startTimestamp: Der Zeitpunkt, zu dem die Sendung begonnen hat.

• name: Der Anzeigename der Sendung.

• length: Die Anzahl der Sekunden, die die Sendung dauerte.

  note important
  IMPORTANT
  Wenn Sie mehrere Datenanfragen für den Zeitplan haben, können diese sich nicht überschneiden.

scheduleDate: Das Datum, an dem die Sendung gesendet wurde. Das Format sollte JJJJ-MM-TT sein. Er wird verwendet, um den Zeitplan-Datensatz zu filtern und alle Zeitpläne abzurufen, für die Adobe einen Zeitplan erstellt.

scheduleFilter: Wird zum Filtern aller Ereignisse für das Schließen von Mediensitzungen verwendet.

• filterPath: Ein XDM-Pfad zu dem Feld, das zum Filtern verwendet wird.
• filterValue: Der zum Filtern verwendete Wert.

customMetadata: Benutzerdefinierte Metadaten, die Sie dem Zeitplan hinzufügen möchten, beginnen Ereignisse. Diese Metadaten werden verwendet, um die benutzerdefinierten Metadaten zu überschreiben, die in den Ereignissen zum Schließen der Sitzung vorhanden sind.

defaultMetadata: Eine bestimmte Liste von Dimensionen, die die Standardmetadaten hinzufügen oder überschreiben können, die bei Medienschließungsaufrufen vorhanden sind.

Im Folgenden finden Sie einige Beispiele für Dimensionen, die Sie in Customer Journey Analytics erstellen und über die Sie dann Berichte erstellen können:

• "Episodenname": Diese Dimension könnte Ihnen dabei helfen zu erfahren, welche Episoden in einer bestimmten Serie am besten funktionieren.

• Asset-ID

Fahren Sie mit Analysieren von Daten in Customer Journey Analytics fort.

Erstellen Sie ein neues Projekt oder öffnen Sie ein vorhandenes.

Erstellen Sie das Projekt, indem Sie alle Tabellen oder Visualisierungen erstellen, die Sie für die Analyse Ihrer früheren Live-Streaming-Mediendaten benötigen.

Verwenden Sie beim Erstellen des Projekts die Informationen, die Sie in die Datendatei für den Zeitplan aufgenommen und an die Adobe-Kundenunterstützung gesendet haben. Dazu gehören der übereinstimmende Schlüssel, Dimensionen und alle zusätzlichen Metadaten. Weitere Informationen finden Sie unter Plandatendatei anfordern und hochladen.